| Table of Contents |
|---|
Параметры событий используемые для анализа
CallerIDNum - номер звонящего (того, кто звонит) - по нему по-умолчанию регистрируются входящие (flow события - dial-in) вызовы
...
CallerExtension - номер добавочного, инициатор исходящего вызова (flow события - dial-out) Имеет формат типа “453*111@доменАТС”, берем из него только то, что до собаки(@).
CalledDID - источник вызова (вызываемый номер на АТС извне, это номер, посредством которого вызов попал в АТС) - при наличии обязательно передаем фиксируется в интеграции.
Bridged - указывает на то, был ли вызов глобально в рамках всей АТС принят пользователем телефонного добавочного, если принят сотрудником то bridged = yes, если нет то bridged = no (ответа на входящий вызов посредством обычного телефоного добавочно не произошло). Данный параметр передается только в событиях hangup от спец.добавочных ИВР и
Очередь (ext type = phone или queue)
[Transfered] => yes - актуально только для исходящих вызовов (flow события - dial-out) и соответствующих вызову событий answer и hangup.
[RemoteNumber] - может присутствовать только в flow события dial-in и указывает внешний номер, с которым связан данный вызов. Предлагается использовать для понимания с каким внешним номером произошло соединение при переводе вызова с добавочного на добавочный командами перевода #1 и *2 и использовать его в таких ситуациях вместо CallerIDNum при регистрации вызова.
CallBackID - ИД коллбека (ID инициации исходящиего вызова через API). Добавляется в случае, если вызов генерируется за счет какого-то добавочного, но соедиенние при этом происходит между внешним номером и каким-то еще номером/добавочным, отличным от добавочного инициатора вызова. К примеру, когда скрипт заказа звонка на сайте соединяет вводимый в него номер с ИВР-ом клиентской АТС.
[Duration] - длительность вызова для каждого отдельного [SubCallID]
[RecID] - ID записи разговора
Успешный вызов имеет CallStatus=ANSWER
Не успешные вызовы имеют статус:
CallStatusStatus=CANCEL - отменен звонящим,
CallStatus=BUSY - вызываемый номер занят.
Возможно еще другие варианты. Такие вызовы ни в коем случае не должны попасть в СРМ CRM как успешные.
Это не все параметры, которые содержат события. Полный список параметров и подробное описание параметров события указаны в документации.
Логика интеграции — общие моменты
...
В самом начале вызов попадает в добавочный типа ivr (type = ivr ), где добавляется правило "Call interactive" (документация), это правило чаще всего используется в интеграциях для действия SetVar, чтобы задать переменную, значение которой будет содержать добавочный номер, на который нужно перевести вызов.
...
Более подробно call interactive для интеграций рассмотрен тут.
Регистрация данных о звонках
...
Инициация вызова (ClickToCall / CallBack)
Инициация вызова (/callback/) (документация, полный список параметров и описание)
...
Хранение и получение записей разговоров ,
а именно метод
GET /extension_group/{ext_group_id}.../record/{record_uuid}/storage_url/
...