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

HTTP-запрос


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

Установка

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

Интерфейс личного кабинета: слева навигационная панель с основными функциями, в правом верхнем углу отображается текущий регион работы «Вся Россия» и индикатор.

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

Экран настройки 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 системой и обработка звонка по аналогии с функцией "Черные/белые списки".

Схема обработки вызова: сначала выполняется HTTP-запрос с индикатором 0, после чего звонок направляется на голосовое приветствие, внешний номер и в общую очередь операторов.

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

Модальное окно редактирования: текст описания функции HTTP-запроса, поле ввода URL со значением, блок с предупреждением о необходимости IP-ограничения (212.193.100.29), ссылка на справку и две кнопки — «Удалить» и «Сохранить».

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

Схема обработки входящего вызова: HTTP-запрос анализирует данные и в зависимости от результата (код 0 или 1) перенаправляет звонок на соответствующий номер.

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

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

Экран настройки входящей схемы: поле номера заполнено значением 3535965, обязательное название — «Вся Россия», музыка на удержании установлена по умолчанию, включена опция замены гудков музыкой, часовой пояс не выбран.
Предыдущая статья Переход на функцию
Следующая статья Обработка данных из CRM