Процесс подключения пользователем интеграции виртуальной АТС с CRM-системой — автоматизированный процесс, который должен быть понятен пользователю без дополнительных обращений за помощью. В CRM-системе обычно доступны виджеты (приложения), через которые пользователь может подключить интеграцию системы с той или иной платформой телефонии. При выборе нужного виджета CRM-система сама сообщает пользователю, какие шаги нужно выполнить для совершения интеграции, либо интегратор самостоятельно выполняет процесс интеграции без участия пользователя, получив у пользователя авторизационные данные.
Для предоставления возможности пользователю АТС подключить интеграцию через виджет в CRM-системе необходимо создать приложение типа public с уровнем доступа call api, указать Redirect URL, разрешить приложению доступ к системе, произвести авторизацию приложения. Чтобы не запрашивать повторно доступ к аккаунту пользователя, можно создать постоянное доверенное приложение (типа trusted, также автоматически создается с уровнем доступа call api). Полное описание доступно по ссылке: “Авторизация приложения и запуск интеграции”.
В целях интеграции необходимо определить, какие внутренние номера относятся к обычным внутренним телефонным номерам, а какие — к служебным (IVR и Очередь). Эти данные можно узнать, например, путем запроса их ресурсом:
get /client/{client_id}/extension/ (поле type внутреннего номера).
Префикс АТС и длину внутреннего номера можно узнать с помощью ресурса:
get /client/{client_id}/client/ (поля extension_len и prefix клиента).
Внутренний номер пользователя с префиксом АТС имеет формат регулярного выражения (regex): [0-9]{3,6}*[0-9]{2,4}
Между CRM-системой и АТС осуществляется передача и получение событий. Например, на основе соответствующего события при входящем звонке в CRM-системе всплывает карточка клиента. В АТС осуществляется регистрация данных о звонках, формируется история звонков (она может быть доступна для просмотра в карточке клиента в CRM-системе). Для настройки фильтрации событий между CRM-системой и АТС необходимо произвести соответствующие настройки. Более подробно с документацией по событиям на внутренних номерах можно ознакомиться на странице “События на внутренних номерах”. Логика событий на внутренних номерах описана на соответствующей странице. Описание работы интеграции доступно по ссылке.
← Структура REST API Авторизация приложения и запуск интеграции →