Подключение уведомлений UIS

Подготовка

Сначала сохраните «Площадка» и «Ключ API», выполните «Проверить связь» и привяжите номера в CRM → Настройки → Телефония. Публикация CRM должна быть доступна из интернета.

Инструкция ниже соответствует подсказкам в плагине. При изменении интерфейса кабинета UIS ориентируйтесь на назначение разделов и шаблоны текущей установленной версии плагина.

Создайте четыре уведомления

1. В CRM → Плагины → Телефония UIS → 2. Адрес для уведомлений скопируйте «Адрес».
2. Нажмите «Проверить адрес». При сообщении о перенаправлении проверьте домен, HTTPS и правила веб-сервера для маршрута публикации CRM.
3. В кабинете UIS откройте Сервисы и статистика → Уведомления → Добавить уведомление.
4. Для каждого события из таблицы выберите способ уведомления HTTP, метод POST и скопированный URL.
5. В блоке «3. Уведомления в UIS» нажмите «Скопировать шаблон» напротив нужного события. Полностью замените тело уведомления в UIS соответствующим шаблоном.

Шаблоны содержат подстановки UIS вида {{call_session_id}}. Копируйте их без добавления кавычек вокруг подстановок: код шаблона рассчитан на значения, которые подставляет UIS.

Если UIS сообщает о недоступном параметре конкретного события, удалите соответствующую строку, сохранив корректность JSON-шаблона. Не удаляйте произвольно остальные поля: плагину нужны тип события, идентификатор сессии и данные для распознавания линии или сотрудника.

Показаны шаблон входящего звонка и отметки последнего получения четырёх уведомлений.

Проверка доставки

После реального звонка обновите страницу плагина. У полученных событий появятся «последнее получено» и дата. Если данных ещё нет, отображается «ещё не приходило».

«Проверить адрес» проверяет запрос с сервера сайта к собственной публикации CRM. Отдельно убедитесь, что запросы приходят из UIS. Тест из кабинета UIS со случайными неизвестными сотрудником и линией отмечается как тестовый и не создаёт звонок.

Повторные события сопоставляются по сессии UIS. События начала вызова и разговора старше 10 минут пропускаются; запоздалое завершение может восстановить завершённый звонок. Импорт отчёта не меняет даты получения уведомлений.

Какие данные передаются

Из UIS на сайт поступают идентификатор и время сессии, направление, телефон клиента, виртуальный номер линии, идентификатор и имя сотрудника, внешний идентификатор звонка. Для завершения дополнительно передаются длительности, признак пропущенного звонка и ссылка на запись, если UIS их предоставляет.

Плагин отправляет в API выбранной площадки ключ доступа, запросы справочников и отчётов. При звонке по клику передаёт телефон клиента, сотрудника UIS, виртуальный номер и внешний идентификатор вида crm-<ID звонка CRM>. При переводе передаёт идентификатор сессии, номер назначения и текст сообщения удержания. Записи скачиваются с серверов UIS/CoMagic на сервер сайта.

Смена адреса и секрета

Отметьте «Сменить секрет при сохранении» и нажмите «Сохранить». Скопируйте новый «Адрес» во все четыре уведомления UIS. Старый секрет перестаёт проходить проверку.

Используйте сформированный плагином адрес целиком. Его структура:

<адрес публикации CRM>/ewcrmuis/callback/<секрет>/

Переход с «Телефония Uiscom»

1. Подключите новый плагин и загрузите сотрудников и линии.
2. Настройте привязки пользователей для «Телефония UIS»: они хранятся отдельно от привязок старого плагина.
3. Отключите старый плагин в CRM → Плагины.
4. В новом плагине включите «Адрес старого плагина» и сохраните форму.

Совместимый маршрут имеет вид <адрес публикации CRM>/uis/callback/; при публикации CRM по /crm/ это /crm/uis/callback/. Он принимает прежний формат уведомлений без секрета. При включённом старом плагине адрес может оставаться занят им.

Когда перенесёте все четыре уведомления на новый адрес с секретом, выключите «Адрес старого плагина». Импорт истории пропускает сессии, уже записанные старым плагином; это не переносит старые записи разговоров в хранилище нового плагина.