Files
medods_crz/readme.md
T
2025-08-08 19:43:20 +03:00

99 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
1. Добавить пользователя в систему Asterisk
1. В файл /etc/asterisk/manager_custom.conf добавить следующий текст:
```
[medods]
secret = 2H4x9#87A%D3
read = all
```
[medods] - имя пользователя (AMI_USER)
secret - пароль пользователя (AMI_PASSWORD)
read = all - права на чтение всех событий AMI Asterisk
2. Применить новые настройки. Выполнить команду:
```
asterisk -rx "core reload"
```
2. Подготовить файлы конфигурации модуля интеграции
1. Изменить файл .env при необходимости:
```
AMI_HOST=127.0.0.1
AMI_PORT=5038
AMI_USER=medods
AMI_PASSWORD=2H4x9#87A%D3
# Фильтр для обработки входящих звонков по каналу поступления. Для использования нескольких каналов: вписать через ", " (запятая и пробел)
AMI_CHANNEL_FILTER=["SIP/78162782020", "SIP/8162787820"]
# Для обработки всех входящих звонков без фильтра по каналу поступления оставить значение переменной пустым
# AMI_CHANNEL_FILTER=
# Сервер для получения записей звонков в формате mp3. (Дополнительный модуль)
RECORDS_SERVER=http://192.168.70.10:3050/
MEDODS_SERVER=http://192.168.70.248:3000/api/v2/telephony/common
# Версия авторизации на сервере Medods. На 08-08-2025 используется версия "V1".
# API Токен для версии V1. Актуален на 08-08-2025
MEDODS_TOKEN=NjYzNWU5Y2EyYmU2NWQzYWI4ZGZjZG
# Включение логирования событий в файлы. Если файлы не требуются: закомментировать параметр или вписать "false"
# DEBUG=true
```
3. Настройки модуля интеграции
1. Требования:
Python версии не менее 3.10, рекомендуемая версия: 3.12
2. Основной файл для запуска:
"main.py"
3. Логирование
1. Консоль
С выключенным параметром DEBUG в консоль будут фиксировать короткие сообщения по каждому этапу звонка
Со включенным параметром DEBUG в консоль будет добавлена информация по отправляемым на сервер Медодс запросам и полученным от него ответам
2. Файлы
С выключенным параметром DEBUG никакие файлы записываться не будут
Со включенным параметром DEBUG в папке "log" (будет создана, если отсутствует) будут создаваться следующие файлы:
1. medods.log - копия информации, направляемой в консоль
2. <дата>.log - вся информация, получаемая от AMI Asterisk
3. <дата>/<уникальный номер звонка>.log - информация, получаемая от AMI Asterisk только по уникальному звонку
4. Linux Service. Для автоматического запуска и перезапуска сервиса модуля интеграции необходимо выполнить следующие действия:
1. Создать файл medods.service по пути /etc/systemd/system со следующим содержимым:
```
[Unit]
Description=Medods integration service
After=mariadb.service
[Service]
Type=simple
# Указать путь к папке и файлу размещения основного файла запуска
ExecStart=/medods_crz/venv/bin/python /medods_crz/main.py
WorkingDirectory=/medods_crz/
Restart=always
RestartSec=2
KillMode=process
User=root
[Install]
WantedBy=multi-user.target
```
2. Выполнить следующие команды:
1. systemctl daemon-reload
2. systemctl enable medods
3. systemctl start medods
5. Профилактический перезапуск
Нужно в файл /etc/crontabs добавить слудующую строку:
```
0 3 * * * root systemctl restart medods
```
Это позволит обеспечить бесперебойную работу системы и отложенное до следующего рабочего дня применение правок
Разработано: ИП Назаров А.В.
Тг: @NaglecX
E-mail: i@nazv.ru
Поддержка от производителя МИС Медодс:
Тех. поддержка в Тг: @medods_support
База знаний: https://bz.medods.ru/