Веб-хук (webhook) — это отправка запросов по событиям из onlinePBX. Запросы уведомляют сторонние сервисы об изменениях в АТС. Позволяют отслеживать звонки, их состояние и другие события onlinePBX — информация отправляется на указанный URL-адрес. Веб-хуки могут использоваться для интеграции.
Подключение
Для подключения веб-хуков необходимо указать URL-адрес, куда будут отправляться POST-запросы. Для этого в панели управления onlinePBX перейдите в Интеграция > Webhooks, нажмите «+ Добавить».
Появится строка с настройкой. Введите URL-адрес, а также выберите, какие именно события хотите получать. На выбор есть шесть вариантов. Нажмите «Сохранить».
Статус
Для тестирования веб-хуков мы добавили в выпадающее меню функцию «Тест». По клику будет совершаться отправка тестового веб-хука. При получении ошибки, её номер или описание покажется в подсказке. В разделе «История» указывается, что был проведен тест.
Три статуса подключения:
- Серый «Не подключен» — показывается до отправки первого события.
- Зелёный «Подключен» — после успешного прохождения теста.
- Красный «Отключен» — при получении ошибки в ходе теста.
История
Сервис хранит историю отправки веб-хуков и ответы от сервера. Можно посмотреть в правой части страницы.
Если произошла ошибка во время передачи, рядом с полем «Тип» появится значок ошибки. При наведении покажется статус, полученный от сервера, куда был отправлен веб-хук.
Примеры запросов
Начался звонок
domain=onlinepbx.ru&event=call_start&direction=outbound&uuid=d02d3dd1-36f9-41g8-9055-3139369h6h90&caller=505&callee=120&from_domain=onlinepbx.ru&to_domain=&gateway=74991111282&date=1528886454&x-roistat-marker=google12_g_50000997109_279581000041_%D1%85%D1%80%D0%B0%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5+%D0%B2%D0%B5%D1%89%D0%B5%D0%B9+%D0%B2+%D0%BC%D0%BE%D1%81%D0%BA%D0%B2%D0%B5&x-roistat=444308 |
---|
Ответили на звонок
domain=onlinepbx.ru&event=call_answered&direction=outbound&uuid=2c033c12-7310-4v4v-9b42-8bb207b17322&caller=505&callee=79111117799&to_domain=&gateway=74991111112&date=1528888621 |
---|
Завершился звонок
domain=onlinepbx.ru&event=call_end&direction=outbound&uuid=6q5qq87q-0w32-4e23-8570-3r6rr6rrrr2&origin=sip&caller=145&callee=79502222919&from_domain=onlinepbx.ru&to_domain=onlinepbx.ru&gateway=74991111282&date=1528884937&call_duration=149&dialog_duration=135&hangup_cause=ORIGINATOR_CANCEL&download_url=https%3A%2F%2Fonlinepbx.ru%2Fdownload_amocrm%2FeyJ1IjoiNDAyYH1co%3D%2Frec.mp3 |
---|
Пропущенный звонок
domain=onlinepbx.ru&event=call_missed&direction=inbound&uuid=5329a333-ss32-4dd9-ff0f-gh84g32h5g22&caller=79221111123&from_domain=onlinepbx.ru&to_domain=onlinepbx.ru&gateway=73431111137&date=1529406933 |
---|
Дозвон до пользователя
domain=onlinepbx.ru&event=call_user_start&direction=outbound&uuid=d02d3dd1-36f9-41g8-9055-3139369h6h90&caller=505&callee=79111117960&from_domain=onlinepbx.ru&to_domain=&gateway=74991111282&date=1528886454 |
---|
Перевод звонка
domain=onlinepbx.ru&event=call_transfer_answered&direction=inbound&uuid=b47fab84-5874-4de3-9c3b-8f1c744c8d8f&caller=101&callee_from=101&callee_to=102&date=1528886454 |
---|
Список переменных и описание
№ | Переменная | Пример значения переменной | Описание переменной |
---|---|---|---|
1 | domain | example.onpbx.ru | Домен, в котором состоялось событие. |
2 | event | call_end / call_answered / call_start / call_user_start / call_missed | Тип события. |
3 | direction | inbound / outbound / local | Тип звонка (входящий/исходящий/внутренний). |
4 | uuid | 5921a027-c22f-4351-b495-30a49f00e4e1 | Уникальный идентификатор сессии. |
5 | caller | +79510057057 / 510@onlinepbx.ru | Звонящий. |
6 | callee | 79827347182 / 102 | Кому звонили. |
7 | from_domain | examplefrom.onpbx.ru | Домен звонящего. |
8 | to_domain | exampleto.onpbx.ru | Домен того, кому звонили. |
9 | gateway | 74922296721 | Транк, на/с которого позвонили. |
10 | date | 1527578 | Дата в формате UNIX. |
11 | call_duration | 159 | Общая длительность звонка (сек.). |
12 | dialog_duration | 145 | Длительность разговора (сек.). |
13 | hangup_cause | NORMAL_CLEARING. Полный перечень значений в выпадающем списке после таблицы. | Причина завершения звонка. |
14 | x-roistat-marker | google12_g_50000997109_279581000041_%D1%85%D1%80%<...>D0%BE%D1%81%D0%BA%D0%B2%D0%B5 | Маркетинговый источник визита. Отправка возможна только в запросе «Начался звонок» для входящих вызовов. |
15 | x-roistat | 444408 | Номер визита Roistat или маркер канала, если используется статический коллтрекинг. Отправка возможна только в запросе «Начался звонок» для входящих вызовов. |
16 | callee_from | 101 | Кто перевел звонок. |
17 | callee_to | 102 | На кого перевели звонок. |
18 | download_url | https://onlinepbx.ru/download/aFI0SVFqa<...>NRDZlSEsxSnc/rec.mp3 | Ссылка на скачивание звонка. Время жизни ссылки — 200 секунд. |
19 | origin | http_api / sip / autorecall / web_callback / callback / auto-informer / websocket_api | Тип (источник) инициализации звонка:
|
Формат запросов
Все HTTP-запросы отправляются в формате POST, тело запроса в формате: application/x-www-form-urlencoded.
Вы не нашли ответ на свой вопрос?
Обратитесь в нашу техническую поддержку: