Как отправлять и получать данные из внешних источников

Автоматизировать процесс стало еще проще с API запросами. C помощью этого функционала вы сможете, например по названию города сообщать погоду, по названию товара осуществлять поиск и выводить результат в чат-бот, по данным подписчика регистрировать его на мероприятие или создавать заказ.

Это работает так: вы отправляете запросы данных во внешние системы о любой информации, которой интересуется ваш пользователь или создаете новый объект. В ответ вы получаете данные, которые можно сразу выдавать в сообщении пользователю или записывать в переменную чат-бота.

Как отправить запрос на получение данных

Перетащите элемент «Запрос API» на рабочее поле, соедините его с элементом, после которого вам нужно получить информацию.

Выберите тип запроса:

• GET запрос обычно используют для получения уже существующих данных;
• POST запрос обычно используют для создания нового объекта в системе и получения информации о нем.

Введите URL, на который отправится запрос. В запросе можете использовать переменные вашего чат-бота.

Вы также можете добавлять заголовки запроса, к примеру для авторизации запросов.

Если используете POST запрос, в нужном поле введите тело запроса в JSON с параметрами.

Нажмите «Проверить запрос» для проверки отправки данных. Также проверка пригодится для распознавания данных при последующей настройке.

Как использовать полученные данные

В случае успешного ответа вы получите тело ответа.

Полученные данные можно использовать один раз в следующем текстовом блоке или записать в переменную чат-бота для многократного использования

Использование данных с сохранением в переменную

Чтобы сохранить данные в переменные для дальнейшего использования, в элементе «Запрос API» в настройках соответствий нажмите «Добавить».

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

Выберите переменную, в которую сохранять значение.

Когда вы сохранили необходимое количество переменных, нажмите «Применить» и перейдите к созданию следующего блока.

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

Пользователю общение с вашим чат-ботом выглядит вот так:

Использование данных в виде выражения JSON Path

Если вам не нужно записывать данные в переменные, можете использовать полученную информацию вставкой выражения пути JSON структуры.

Для этого после проверки запроса и получения успешного ответа нажмите «Добавить», найдите вашу переменную и скопируйте JSON Path из поля ответа.

Затем нажмите «Применить» и перейдите к созданию следующего элемента.

Обратите внимание, что данные, которые вы не записываете, можно использовать только один раз в следующем текстовом блоке.

В тексте сообщения добавьте JSON Path {{$['somekey']['nestedkey']}}.

Пользователю общение с вашим чат-ботом этого примера выглядит вот так:

Обновлено: 2020-09-11