...
При выборе нужного виджета (приложения) CRM сама сообщает пользователю какие шаги нужно выполнить для совершения интеграции, либо интегратор самостоятельно выполняет процесс интеграции без участия пользователя, получив у пользователя авторизационные данные.
Определение базовых параметров интеграции
...
get /client/{client_id}/extension/ ( поле type ссылка на документацию).
Префикс АТС и длину добавочного можно узнать с помощью ресурса:
get /client/{client_id}/client/ ( поле extension_len и prefix ссылка на документацию)
Номер добавочного с префиксом АТС пользователя имеет формат регулярного выражения (regex):
...
Всем обычным телефонным добавочным (type = phone ) рекомендуется добавлять полный набор событий:
dial-in - входящий вызов на добавочный, отправитель события
dial-out - исходящий вызов с добавочного, отправителя события
answer - снятие трубки на добавочном, отправитель события(возможно в какой-то интеграции это событие будет неактуально)
hangup - прекращение вызова на добавочном, отправителе события
В данной рекомендации всем спец.добавочным (type = IVR или queue) рекомендуется добавлять только событие hangup.
Документация событий добавочного.
Документация событий агента очереди ( данные события необходимы для отображения готовности агента очереди принять вызов - могут использоваться в реал-тайм мониторинге)
...
Более одного запроса на одно действие совершать не нужно, если при предыдущей попытке совершить запрос была получена ошибка, то значит что-то пошло не так и повторить запрос нужно только после каких-либо действий.
Ошибки серии 4xx значает, что нужно что-либо изменить, либо предпринять какие-либо меры, подробнее об 4xx ошибках можно прочитать в документации.
Ошибки API - серия 5xx. Эти ошибки нужно отправлять администратору для принятия соответствующих мер.
Повторная отправка запроса должна быть инициирована только пользователем (при инициации запроса пользователем), либо через определенное время (при автоматических запросах), но ни в коем случае не в бесконечном цикле. Об ошибке пользователь должен узнать в соответствующем уведомлении.
...
Количество запросов к API в час также лимитировано, поэтому нежелательно лишний раз что-либо обновлять/синхронизировать. Документация по лимитам.
Пример события (рекомендуемый url)
...
Фильтрация событий, полученных от АТС.
Ознакомьтесь с описанием, в частности с разделом “Данные события (EventData)”
...