"Внешний запрос" можно найти в конструкторе ботов в блоке "Действие" в выпадающем списке действий.
Примеры сценариев использования "Внешнего запроса" в ботах:
1. "Подписчик выбирает какой он персонаж из фильма "Звездные войны": ссылка
2. Интеграция с Google-таблицами для считывания данных из таблицы: ссылка
3. Отправка СМС через сервис СМС Aero: ссылка на видео
4. Генератор случайных чисел: ссылка
5. Отправка уведомлений Агенту в Telegram: ссылка
6. Выдача сертификатов через сервис ГрамотаДел: ссылка на видео
Действие "Внешний запрос" позволяет:
Все настройки Внешнего запроса выполняются в отдельном всплывающем (модальном) окне, которое открывается при редактировании.
Настройка и назначение всех элементов Внешнего запроса описаны ниже.
В выпадающем списке "Тип запроса" выбирается тип отправляемого запроса. Тип запроса нужно искать в описании API сервиса, с которым настраивается взаимодействие.
В поле "URL-адрес" указывается адрес, на который будет отправляться запрос. Его также нужно искать в описании API сервиса.
При вводе URL-адреса допускается использование стандартных макросов (все макросы, которые есть в кабинете). Для того, чтобы подставить к ссылке макросы, нужно после самой ссылки поставить знак ? а при перечислении параметров макросы соединить знаком & (амперсанд). Пример: link.ru?utm_content=1&{%pole%}.
В этом разделе задаются Заголовки для отправляемого запроса.
Вы можете:
В этом разделе описывается тело запроса. Код для раздела Тело нужно взять из настроек стороннего сервиса.
Тело должно быть описано в формате JSON.
При заполнении тела запроса допускается использование стандартных макросов.
В правой части "Предпросмотр" выполняется автоматическая валидация и форматирование введенного тела.
ВАЖНО! Данный раздел недоступен для запросов с типом GET
В этом разделе отображается ответ, который будет получен от внешнего сервиса после запуска тестирования запроса.
Чтобы запустить тестирование запроса нажмите на "Отправить запрос" или "Протестировать запрос".
Если в заголовках, теле или URL-адресе используются макросы, то для при тестировании вместо макросов будут подставлены тестовые значения. Вы можете изменить тестовые значения - для этого нужно раскрыть выпадающий список "Данные для тестирования" и изменить указанное значение в поле "Тестовое значение" для нужного макроса.
После успешной отправки тестового запроса, в правой части данной вкладки отобразится полученный ответ, в котором можно посмотреть заголовки ответа и само тело ответа
Значения, полученные в теле ответа можно сохранять в пользовательские поля подписчиков с помощью вкладки "Сопоставление ответов"
В этом разделе можно настроить сопоставление ответов так, чтобы данные, пришедшие в ответе на запрос записывались в указанные пользовательские поля подписчиков.
Данные и их структуру можно посмотреть после запуска тестирования запроса, на вкладке "Ответ" в разделе "Тело ответа":
В этой инструкции описан сценарий с тестированием запроса, настройкой сопоставления и дальнейшим использованием данных в боте: ссылка
Для настройки сопоставления нужно:
ВАЖНО! После настройки и тестирования запроса обязательное нажмите "Сохранить"
ВАЖНО! Чтобы настройки внешнего запроса сохранились обязательно сохраните шаг "Действие", в котором был добавлен внешний запрос
Где взять Key для заголовков?
Это зависит от сервиса и метода, с которым настраивается интеграция через внешний запрос. В описании настроек стороннего сервиса будет прописан список данных, куда и какие ключи вставлять.
Автоматическая выдача именных сертификатов
Если вы не нашли ответ на свой вопрос, задайте его нам в чате внутри кабинета либо напишите на hello@bothelp.io 😃
Получите 14 дней полного функционала платформы для создания рассылок, автоворонок и чат-ботов BotHelp: