1. DOC SIPUNI
  2. База знаний Сипуни
  3. Конструктор
  4. Справочник функций
  5. HTTP-запрос

HTTP-запрос


Функция предназначена для интеграции с внешними системами при помощи https запросов. Данные о звонке отправляются запросом на указанный URL с ожиданием ответа в формате JSON. Исходя из полученного ответа вызов направляется по одной из веток функции. 

Установка

1. Откройте меню "Конструктор" в личном кабинете. Укажите схему и нажмите "+" на этапе схемы, где планируется добавить функцию "HTTP-запрос".

2. Перейдите на закладку "Переход звонка" и откройте параметры функции "HTTP-запрос".  Укажите адрес URL для запроса. Нажмите кнопку "Сохранить".

3. Синтаксис запроса. ?fromnum=&tonum=dtmf=&label=&time=

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

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

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

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

label - передается значение поля "Тег" из настроек функции.

time - дата и время поступления вызова в формате "год-месяц-день час:мин:сек".

4. Пример запроса. GET https://example.com/script?fromnum=74996474807&tonum=74996477948&dtmf=&label=test&time=2014-06-23 18:11:21

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

Ответ в сторону узла передается в формате JSON с обязательным параметром "choice", который указывает номер ветви функции.

Описание параметров.

choice - доступные значение:

  • 0 - левая ветка.
  • 1 - правая ветка.

name - имя абонента на экране IP-телефона.

number - вызов указанного номера длительностью 15 сек.

5. Пример схемы. Управление внешней CRM системой и обработка звонка по аналогии с функцией "Черные/белые списки".

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

7. Скрипт чередует правую и левую ветки для каждого нового звонка.

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

9. ID_схемы указан в "Настройках схемы".

Предыдущая статья Переход на функцию
Следующая статья Обработка данных из CRM