Интеграция с внешними системами

Процесс подключения пользователем интеграции виртуальной АТС с внешней системой — автоматизированный процесс, который должен быть понятен пользователю без дополнительных обращений за помощью. Во внешней системе обычно доступны виджеты (приложения), через которые пользователь может подключить интеграцию системы с той или иной платформой телефонии. При выборе нужного виджета внешней система сама сообщает пользователю, какие шаги нужно выполнить для совершения интеграции, либо интегратор самостоятельно выполняет процесс интеграции без участия пользователя, получив у пользователя авторизационные данные.

Для предоставления возможности пользователю АТС подключить интеграцию через виджет во внешней системе необходимо создать приложение типа public с уровнем доступа call api, указать Redirect URL, разрешить приложению доступ к системе, произвести авторизацию приложения. Чтобы не запрашивать повторно доступ к аккаунту пользователя, можно создать постоянное доверенное приложение (типа trusted, также автоматически создается с уровнем доступа call api). Полное описание доступно по ссылке: “Авторизация приложения и запуск интеграции”.

В целях интеграции необходимо определить, какие внутренние номера относятся к обычным внутренним телефонным номерам, а какие — к служебным (голосовое меню и очередь). Эти данные можно узнать, например, путем запроса их ресурсом:
get /client/{client_id}/extension/ (поле type внутреннего номера).

Префикс АТС и длину внутреннего номера можно узнать с помощью ресурса:
get /client/{client_id}/client/ (поля extension_len и prefix клиента).
Внутренний номер пользователя с префиксом АТС имеет формат регулярного выражения (regex): [0-9]{3,6}*[0-9]{2,4}

В АТС осуществляется регистрация данных о звонках, формируется история звонков (она может быть доступна для просмотра в карточке клиента во внешней системе).

Между внешней системой и АТС осуществляется передача и получение событий. Например, на основе соответствующего события при входящем звонке во внешней системе всплывает карточка клиента. Для настройки фильтрации событий между внешней системой и АТС необходимо произвести соответствующие настройки.

Более подробно с документацией по событиям на внутренних номерах можно ознакомиться на странице “События на внутренних номерах”. Логика событий на внутренних номерах описана на соответствующей странице. Описание работы интеграции доступно по ссылке. Также будет полезно получить дополнительную информацию, связанную с замечаниями по интеграциям.

← Структура REST API Авторизация приложения и запуск интеграции →