Подключение Asterisk к коллтрекингу
Динамический коллтрекинг AlloStat может быть интегрирован с вашей АТС на базе Asterisk. Для подключения Asterisk к коллтрекингу вам самостоятельно необходимо реализовать отправку запроса на специальный URL. В Asterisk, начиная с 11 версии, отправку события после окончания вызова можно реализовать с помощью Hangup Handlers.
Преимущество такой интеграции коллтрекинга:
- Не страдает качество связи, сам звонок по-прежнему будет идти через ваш Asterisk.
- Не страдает безопасность вашей АТС т.к. запросы отправляются из Asterisk в коллтрекинг, а не наоборот.
- Не меняется текущая схема распределения звонков.
- Возможно отслеживание не всех номеров вашей АТС, а только тех, которые будут указаны в коллтрекинге.
Подключение
- В разделе "Подключение-Операторы" выберите в качестве оператора Asterisk и нажмите кнопку "Сохранить". Вам станет доступен уникальный URL,
на который по окончании звонка необходимо отправлять POST-запрос. Пример и параметры запроса описаны ниже.
- Запрос отправляется по окончании звонка. Отправляются события только о Входящих звонках. Система коллтрекинга самостоятельно разберет параметры, присланные в запросе и свяжет звонок с источником.
- При успешной интеграции в разделе "Мониторинг-Звонки" появится строка с записью о звонке.
- В случае, если ваш Asterisk перестал отправлять запросы страница "Мониторинг-Звонки" перестанет обновляться и вы не увидите новых звонков.
Пример запроса
Метод: POST /service/asterisk/fe0415a9-f778-уникальный-номер-в-allostat
Заголовок: Сontent-type: application/x-www-form-urlencoded
Хост: Host: allostat.ru
Тело:
direction=inbound&caller=375445068888
&event=call_end&date=1587454323
&gateway=375445066666&call_duration=20
&dialog_duration=5&uuid=3b628c24-05aa
Запись для удобства чтения:
direction=inbound - Направление вызова (входящий)
&caller=375445068888 - Номер звонящего в международном формате
&event=call_end - Название события
&date=1587454323 - Время окончания звонка Unix
&gateway=375445066666 - Номер на который звонили в международном формате
&call_duration=20 - Длительность соединения
&dialog_duration=5 - Длительность разговора
&uuid=3b628c24-05aa - уникальный идентификатор звонка (необязательно)
Список параметров и описание
| Параметр | Пример значения | Описание параметра |
|---|---|---|
| direction | inbound | Направление звонка. Inbound - входящий звонок, Outbound - исходящий звонок. Для коллтрекинга используется только Inbound. |
| event | call_end | Событие (состояние звонка). Для коллтрекинга используется только событие "Конец звонка(call_end)". Передается после окончания соединения. |
| caller | 74951234567 | Номер звонящего в международном формате |
| gateway | 74957654321 | Номер на который звонили в международном формате |
| date | 1587454323 | Дата и время окончания звонка в формате Unix. Передается только время окончания звонка. |
| call_duration | 90 | Длительность от начала звонка до окончания в секундах. Используется для расчета времени начала звонка: "Время начала звонка"="date" минус "call_duration". |
| dialog_duration | 10 | Длительность разговора в секундах. Используется для определения был ли звонок отвечен. Звонок считается отвеченным если "dialog_duration" больше 0. Ноль или пустое значение означает, что звонок был не отвечен. |
| uuid | 1589961034.200 | Необязательный параметр. Уникальный идентификатор звонка у вас в Asterisk. |
| date_start | 1587454303 | Не передается. Дата и время начала звонка в формате Unix. Рассчитывается на стороне коллтрекинга "date_start" = "date" минус "call_duration". |
Как проверить какие данные передаются
Зайдите на сайт https://webhook.site/. Получите URL для отправки данных.
Отправьте запрос из вашего Asterisk и посмотрите, что в нем передается.
