Как отправлять и получать данные из внешних источников
Автоматизировать процесс стало еще проще с API запросами. C помощью этого функционала вы сможете, например по названию города сообщать погоду, по названию товара осуществлять поиск и выводить результат в чат-бот, по данным подписчика регистрировать его на мероприятие или создавать заказ.
Это работает так: вы отправляете запросы данных во внешние системы о любой информации, которой интересуется ваш пользователь или создаете новый объект. В ответ вы получаете данные, которые можно сразу выдавать в сообщении пользователю или записывать в переменную чат-бота.
Как отправить запрос на получение данных
Перетащите элемент «Запрос API» на рабочее поле, соедините его с элементом, после которого вам нужно получить информацию.
Выберите тип запроса:
- GET запрос обычно используют для получения уже существующих данных;
- POST запрос обычно используют для создания нового объекта в системе и получения информации о нем.
Введите URL, на который отправится запрос. В запросе можете использовать переменные вашего чат-бота.
Вы можете добавлять заголовки запроса, например для авторизации запросов. Также вы можете использовать переменные бота в заголовках запроса.
Если используете POST запрос, в нужном поле введите тело запроса в JSON с параметрами.
Нажмите «Проверить запрос» для проверки отправки данных. Также проверка пригодится для распознавания данных при последующей настройке.
Как использовать полученные данные
В случае успешного ответа вы получите тело ответа.
Полученные данные можно использовать один раз в следующем текстовом блоке или записать в переменную чат-бота для многократного использования
Использование данных с сохранением в переменную
Чтобы сохранить данные в переменные для дальнейшего использования, в элементе «Запрос API» в настройках соответствий нажмите «Добавить».
Из поля ответа выберите ключ, значение переменной которой вам нужно использовать.
Выберите переменную, в которую сохранять значение.
Когда вы сохранили необходимое количество переменных, нажмите «Применить» и перейдите к созданию следующего блока.
В этом примере мы создали заказ, получили данные в ответ из нашей CRM, сохранили их в переменные и сообщаем пользователю для быстрой идентификации заказанной услуги или товара.
Пользователю общение с вашим чат-ботом выглядит вот так:
Использование данных в виде выражения JSON Path
Если вам не нужно записывать данные в переменные, можете использовать полученную информацию вставкой выражения пути JSON структуры.
Для этого после проверки запроса и получения успешного ответа нажмите «Добавить», найдите вашу переменную и скопируйте JSON Path из поля ответа.
Затем нажмите «Применить» и перейдите к созданию следующего элемента.
Обратите внимание, что данные, которые вы не записываете, можно использовать только один раз в следующем текстовом блоке.
В тексте сообщения добавьте JSON Path {{$['somekey']['nestedkey']}}.
Пользователю общение с вашим чат-ботом этого примера выглядит вот так:
Обновлено: 21.08.2022
Регистрация через соцсети
Войти через Facebook Войти через Google