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

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

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

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

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

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

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

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

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

  • GET
  • POST
  • PUT
  • DELETE

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

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

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

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

Варианты переадресации звонка

  • на номер телефона;
    Рекомендуемое имя параметра для возврата номера в формате json – phone


  • на схему переадресации в проекте.
    имя параметра для возврата ID схемы переадресации в формате json – schema

Для переадресации на уже существующую схему переадресации звонков в проекте – нужно вернуть в формате json ID схемы переадресации из проекта в лк Ringostat.
Для этого нужно перейти на страницу "Виртуальная АТС" – "Переадресация" и нажать кнопку редактировать у необходимой схемы:



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

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


Запрос: (метод: 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":"test","step_forward":"webhookNumber:120","uuid":"842d921d-5334-4eca-812d-9a478dc8c884","google_id":"UA-1111111-1"}

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


  •  Ответ (тип ответа: 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

{"phone":"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 схему номера, дополнительные настройки и сохранить:

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

Будем рады ответить на ваши вопросы в чате или на email: Support Team

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