HTTP-запрос

 

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

1522303783637.png

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

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

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

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

1522304100151.png

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

?fromnum=<fromnum>&tonum=<tonum>dtmf=<dtmf>&label=<label>&time=<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"}

Пример схемы распределения по http-запросу

1522304495316.png

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

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 1 из 2