Подключение UIS / CoMagic

Готовое подключение виртуальной АТС UIS (и CoMagic — та же платформа под другой вывеской) к функции «Звонки»: когда запись разговора готова, UIS присылает уведомление, dxCAR уточняет по API, что это был за звонок, забирает файл, и дальше всё как обычно — распознавание, разбор, экран «Звонки». Ставить в АТС ничего не нужно: ключ API и одно уведомление в кабинете UIS.

Что нужно

• Кабинет UIS (или CoMagic) с включённой записью разговоров.
• Право менять уведомления и настройки безопасности в кабинете. Уведомления о событиях на части тарифов UIS — платная опция; если в кабинете нет раздела «Уведомления», спросите у поддержки UIS.
• Внутренние номера сотрудников в UIS: по ним dxCAR узнаёт, кто из сотрудников разговаривал.

Подключение

1. В dxCAR: Настройки → Звонки → Подключить АТС → UIS / CoMagic. Появится карточка с шагами, адресом уведомления и образцом его тела.
2. Ключ API. Кабинет UIS → Администратор → Аккаунт → Управление пользователями → нужный пользователь → Ключ API, тип постоянный. Впишите его в поле «Ключ API» и выберите сервер API: UIS — если кабинет на uiscom.ru, CoMagic — если на comagic.ru. Ключ одного не действует на другом.
3. Белый список. UIS не пускает к API ни с одного адреса, пока он не разрешён. Кабинет UIS → Администратор → Аккаунт → Правила и настройки безопасности → вкладка API → добавьте адрес сервера dxCAR (он показан в карточке).
4. Уведомление. Кабинет UIS → Личный кабинет → Уведомления → Добавить уведомление:
   • событие — «Записанный разговор»;
   • метод — POST;
   • адрес — из карточки (кнопка «Копировать»; в нём ключ приёма — не публикуйте);
   • тело (шаблон) — из карточки, целиком, кнопкой «Копировать». Это JSON с подстановками UIS ({{call_session_id}}, {{file_link}} …); менять его не нужно.
5. Нажмите «Проверить» в карточке. dxCAR ответит по строкам:
   • ключ принят (название аккаунта и часовой пояс) — или почему нет: чаще всего адрес сервера не в белом списке, либо ключ от другого проекта (uiscom / comagic);
   • какие внутренние номера UIS совпали с сотрудниками dxCAR («Внутренний номер АТС» в карточке сотрудника), а какие остались без сотрудника;
   • приходили ли уведомления от UIS (до первого звонка — нет, это нормально).
6. Сохранить. Сделайте пробный звонок с записью, подождите минуту-две и нажмите «Проверить» ещё раз — последняя строка покажет, что уведомление дошло и звонок принят.

Что происходит дальше

• Уведомление приходит после окончания разговора, когда файл готов. dxCAR запрашивает у UIS отчёт по этому звонку (направление, время, номер, кто разговаривал), скачивает запись и ставит её в очередь распознавания. На экране «Звонки» запись появляется через минуту-две.
• Не принимаются: звонки без разговора (потерянные), короче 5 секунд, без записи и без номера клиента. История до подключения не подтягивается.
• Если dxCAR был недоступен или API не ответил, UIS сам повторит уведомление — через 2, 4, 8 и 16 часов; звонок не потеряется.
• Сменили секрет приёма в блоке «Приём и расшифровка» — поправьте адрес в уведомлении UIS (старый перестанет приниматься сразу).

Если звонков нет

Нажмите «Проверить» — строки скажут, где обрыв:

Полный журнал приёма — экран «Звонки → Журнал приёма».