Использование запроса к стороннему сервису

Использование запроса к стороннему сервису

Действие Запрос к стороннему сервису осуществляется по протоколу HTTP методом GET. HTTP используется для уведомления стороннего сервиса о достижении определённого узла и передаче необходимых параметров из сценария, а также позволяет получать данные из стороннего сервиса и использовать полученные данные в назначенных переменных

Для создания запроса в Настройках узла нажмите на кнопку Действия -> Добавить действие -> Запрос к стороннему сервису.

На Стартовом узле можно создать только Действие – Запрос к стороннему сервису.

После выбора Запроса к стороннему сервису из списка действий в следующем окне в поле введите Адрес вашего сервиса, с которым будет происходить интеграция Robovoice.

При включенной опции Ожидать ответ от стороннего сервиса можно настроить Максимальное время ожидания ответа (мс.), что позволяет увеличить или уменьшить время (тайм-аут) ответа на запрос.

Время ожидания:

• по умолчанию: 5000 мс.
• максимальное: 30000 мс.
• минимальное: 50 мс.

Обработка ответа от стороннего сервиса

Данная вкладка отвечает за обработку ответа от стороннего сервиса и позволяет сопоставить поля из ответа HTTP запроса с их назначенными переменными Robovoice.

Для дополнительной информации по созданию и использованию Переменных перейдите в раздел Переменные.

Для сопоставления переменных с их значениями нажмите на кнопку Добавить.

Из списка выберите одну из Пользовательских переменных, созданных ранее.

Для фильтрации ваших переменных нажмите на кнопку . Откроется список всех доступных предустановленных переменных в Robovoice.

В Контакт включены все данные соответствующие выбранному контакту.

Также, в переменную можно внести динамические значения из вашей системы добавив созданные вами поля.

В Кампанию включен фильтр по ID кампании.

Параметры вызова стороннего сервиса

Данная вкладка позволяет обозначить параметры вызова вашего сервиса.

Для создания параметров нажмите на кнопку Добавить.

В поля Ключ и Значения введите параметры из вашей системы, необходимые для вызова вашего сервиса.

Например:

Обратите внимание, данный метод не будет работать с вложенными структурами.

Дополнительно потребуется Сохранить и Опубликовать сам сценарий.

Символ ? позволяет отделить адрес, куда будет передаваться запрос, от переменных, которые будут передаваться при выполнении данного действия.

Символ & позволяет разделить эти переменные между собой, в случае если их несколько.

Сохраненный запрос будет отображен в Действиях.

Как назначить значение переменной вручную с помощью echo-сервиса

В настройках узла включите тумблер “Не слушать контакта”  —  это позволит получить данные из стороннего сервиса, не спутав их с речью контакта. Далее зайдите во вкладку “Действия” и выберите “Запрос к стороннему сервису”.

В поле “Адрес сервиса” вводим строку:
http://echoserver:8080?param=value

где value  —  то значение, которое нам нужно назначить переменной.

В таблице “Обработка ответа от стороннего сервиса” в левом поле выбираем переменную, которой мы хотим назначить значение, а в правом поле вводим слово result.

Например, мы хотим назначить значение Test_Value для переменной test. Настройки этого запроса будут выглядеть так: