VoIP — настройка телефонии
Обновлено: 25 Июль 2026
Версия: 2.2.1
VoIP — настройка телефонии (UIS / CoMagic)
Модуль телефонии добавлен в релизе 2.1.0. Интеграция связывает АСК с облачной АТС провайдера UIS или CoMagic.
Предварительные требования
- Активный договор с UIS или CoMagic и доступ к API/вебхукам.
- Модуль VoIP включён в «Настройки» → «Модули».
- Права VoIP назначены группам операторов техподдержки.
Включение модуля
- «Настройки» → «Модули» — включите модуль VoIP.
- «Настройки» → «Группы и права» — назначьте права на просмотр screen pop и истории звонков.
Настройка интеграции
Параметры интеграции задаются в системной админке Django или разделе настроек VoIP (в зависимости от конфигурации установки):
| Параметр | Описание |
|---|---|
| Провайдер | UIS или CoMagic |
| API-ключ / токен | Ключ доступа к API АТС |
| URL webhook | Адрес для приёма событий звонков на стороне АСК (указывается в личном кабинете АТС) |
| Номера операторов | Сопоставление внутренних номеров АТС с пользователями АСК |
Webhook входящих звонков
- В личном кабинете UIS/CoMagic настройте исходящий webhook на URL вашей установки АСК (формат уточняйте у провайдера).
- События: начало звонка, ответ, завершение.
- Убедитесь, что URL доступен из интернета (HTTPS).
Сопоставление пользователей
Для каждого оператора техподдержки укажите внутренний номер АТС в профиле сотрудника или в настройках VoIP. Screen pop показывается пользователю, чей номер совпал с вызываемой линией.
Проверка работы
- Совершите тестовый входящий звонок на линию оператора.
- Убедитесь, что появилась всплывающая карточка с данными клиента.
- Откройте связанную заявку — на вкладке «Звонки» должна появиться запись о звонке.
- После завершения разговора проверьте автокомментарий в заявке.
Устранение неполадок
| Симптом | Возможная причина |
|---|---|
| Screen pop не появляется | Webhook не доходит до АСК; проверьте URL и SSL |
| Клиент не определяется | Номер не найден в базе сотрудников клиентов — добавьте телефон в карточку контакта |
| История пустая | Не настроено сопоставление номера оператора с пользователем АСК |
См. также: 3.10 Телефония (пользователь)