Переадресация звонка при помощи Webhook номера

Webhook-номер переадресации — уникальный инструмент, который позволяет АТС Ringostat получать в ответ на http(s)-запрос номер телефона или sip-логин, на который будет дальнейшая переадресация звонка.

Данная функция позволяет получать направление переадресации с внешнего ресурса в зависимости от параметров входящего звонка. Ваш сервер отдает направление переадресации в ответ на Webhook. Параметры звонка могут приходить в соответствии с настройками hook-a в HTTP заголовках или JSON формате. Ответ должен содержать направление (номер в международном формате/sip) в теле ответа HTTP или в конкретном идентификаторе JSON формата.
Номер переадресации в международном формате выглядит так:
380ХХХХХХХХХ (12 цифр) - Украина
7ХХХХХХХХХХ (11 цифр) - Россия
7ХХХХХХХХХХ (11 цифр) - Казахстан

Если выбран тип JSON, то автоматически используется метод отправки - POST.

Как настроить Webhook номер

Использовать Webhook номер для переадресации звонков вы сможете после его настройки.
Для этого в меню открываем нужный раздел АТС и создаем новый вебхук с произвольным названием.

Виртуальная АТС⟹Webhook номер⟹+Добавить Webhook номер

Заходим в редактирование данного вебхука (пиктограмма с карандашом справа) и заполняем все поля и параметры.

URL — веб-адрес CRM или другого обработчика, на который будет отправляться запрос. Протокол может быть как http, так и https.

Метод отправки данных выбирайте соответственно с документацией по интеграции вашей CRM.
Это может быть:

  • GET
  • POST
  • PUT
  • DELETE

Тип отправки данных может быть http или json. Если выбран тип json, то автоматически используется метод отправки - POST.

Тип приема данных аналогично http/json, номер для переадресации должен быть или в теле ответа HTTP или в конкретном идентификаторе JSON формата.

Поле номера переадресации (для json) — указываем названия поля в котором приходит направление дальнейшей переадресации звонка (номер телефона должен быть в международном формате).
Максимальное время ожидания ответа нашим сервером настраивается в поле "Таймаут в секундах".

Отправляемые Webhook-параметры будут зависеть от конкретных задач, что ставятся.
Имя параметра вы указываете согласно настройкам вашей CRM и указываете соответствующее значение. На основании этих значений должна строиться логика дальнейшего направления звонка.

Так выглядит настроенное окно Webhook номера:

Пример запроса/ответа

Пример запросов: 


Запрос: (метод: POST тип отправляемых данных: json url:https://api.asterisk/api/addnumber/)
POST /api/addnumber/ HTTP/1.1
Host: api.asterisk
Origin: api.asterisk
User-Agent: ringostat HTTP Client v1.1
Content-Type: application/json
Content-Length: 128
Connection: close

{"call_id":"pkv","step_forward":"webhookNumber%3A120","uuid":"842d921d-5334-4eca-812d-9a478dc8c884","google_id":"UA-38222689-2"}

Пример ответов: 


  •  Ответ (тип ответа: json)

HTTP/1.1 200 OK
Server: nginx/1.6.3
Date: Wed, 09 Dec 2015 14:47:44 GMT
Content-Type: application/json
Content-Length: 25
Connection: close
X-Powered-By: PHP/5.5.29
Set-Cookie: PHPSESSID=olhduanaf84n192tmnbg6iea94; path=/
Pragma: no-cache
Expires: 0
Cache-Control: must-revalidate

{"number_01":"380123456789"}

  • Ответ (тип ответа: http)

HTTP/1.1 200 OK
Server: nginx/1.6.3
Date: Wed, 09 Dec 2015 14:34:46 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 9
Connection: close
X-Powered-By: PHP/5.5.29
Set-Cookie: PHPSESSID=b3f9mfs1eg3bkflrbprqk4qmd5; path=/
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Pragma: no-cache 
380123456789

После создания Webhook-номера, его нужно включить в схему переадресации. Для этого, необходимо перейти "Виртуальная АТС" - "Переадресация" - "Создать схему переадресации":

Далее, нужно задать название схемы, выбрать направление переадресации, webhook схему номера, дополнительные настройки и сохранить:

Более детально с настройкой схем переадресации звонков, вы можете ознакомиться в статье "Схемы переадресации: настройка и дополнительные возможности"

Если в процессе настройки у Вас возникли сложности — спросите нас и Ваш вопрос будет решён в самые короткие сроки :)

Была ли статья полезной?