HTTP-запрос


Функция предназначена для интеграции с внешними системами при помощи http/https запросов (рекомендуем использовать https).


Схема работы функции


Если вызов попадёт в функцию, то АТС отправит запрос на указанный в параметрах функции URL, передав в запросе данные о звонке. Подробнее в разделе "синтаксис запроса".


После отправки запроса, АТС будет ожидать ответ в формате JSON. Получив ответ, АТС направит звонок по одной из двух веток выполнения. Выбор ветки зависит от данных ответа.

Функция имеет 2 параметра:


  1. URL куда отправлять запрос

  2. Метка. Метка используется для случая если в схеме размещено несколько функций и позволит узнать на какую именно функцию пришёл вызов.


Синтаксис запроса:


?fromnum=&tonum=dtmf=&label=&time=


Передаваемые параметры:


fromnum - с какого номера пришёл вызов.

tonum - на какой номер пришёл вызов.

dtmf - если перед функцией звонок попал на узел голосовое меню и звонящий набрал в нём любое число, оно будет передано в параметре.

label - если указан текст метки, он будет передан в параметре.

time - время прихода вызова в АТС.


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


GET https://example.com/script?fromnum=74996474807&tonum=74996477948&dtmf=&label=test&time=2014-06-23 18:11:21


Ответ узел ожидает в формате JSON. В ответе обязательно должен содержаться параметр choice - указывающий номер ветви прохождения звонка.


АТС распознаёт следующие параметры:


choice - доступные значения 0 (выбрать левую ветвь для выполнения), 1 (правая ветвь)

name - здесь можно указать новое имя (будет отображено на IP-телефоне при поступлении вызова)

number - если указан, АТС попытается соединить вызов с указанным номером (длительность вызова 15 сек)


Пример ответа: {"choice":1,"name":"sipuni call", "number":"100"}




Пример схемы 


Вы можете использовать данную функцию, например, для управления внешней интеграцией с CRM системой, либо создавать внешние черные/белые списки.


Примеры работы HTTP-запроса

Добавьте функцию "HTTP-запрос" в любую часть схемы и пропишите в поле URL значение http://distribution.normal

Данный скрипт чередует правую и левую ветки для каждого нового звонка.

Звонок должен дойти до функции, чтобы скрипт отработал.



Еще один пример работы функции. Каждый новый звонок отправляется поочередно на разные схемы. Пропишите в поле URL значение - http://distribution.tree?ID_схемы1,ID_схемы2,ID_схемы3


ID_схемы можно посмотреть через кнопку "Настройки схемы".