Использование стороннего API для расширения возможностей чат-ботов. Инструкция по работе с блоком "HTTP-запрос" для создания интеграций
Интеграция чат-бота с внешними сервисами с использованием API
Укажите ваш URL, тип запроса и заголовки для обработки запроса.
Поддерживаются методы GET, POST, PUT, DELETE и PATCH.
Блок "HTTP-запрос" в сценарии
При использовании метода POST дополнительно появляется возможность передать body в запросе.
Запрос
Для отправки в запросе всех пользовательских переменных, полученных на предыдущих шагах, контакт пользователя и данных crm систем, необходимо включить "Отправлять в запросе данные контакта".
Отправка данных контакта в запросе
Пример запроса:
Время ожидания соединения: 3 секунды
Отправка файла
Для отправки файла выберете метод POST.
В разделе body выберете режим multipart/form-data и нажмите на кнопку "Добавить файл".
Выберете способ добавления файла:
"Загрузить файл" — выберите файл на вашем устройстве. Файл будет загружен сразу и будет отправляться при каждой обработке данного HTTP-запроса.
"Указать ссылку" — заполните key и url (в поле url можно указать ссылку на файл текстом или использовать локальную/глобальную переменную, которая содержит ссылку). Файл по ссылке будет загружаться в начале обработки блока HTTP-запроса и отправлен вместе с самим запросом.
Максимально допустимый размер передаваемого файла — 100 Мб.
Добавление файла в настройках блока HTTP-запрос
При выборе способа "Указать ссылку" можно указать переменную, в которую раннее в сценарии пользователем чат-бота был загружен файл. Файл из этой переменной будет передан в бинарном формате.
Ссылку из переменной с файлом предварительно нужно декодировать. Для этого в отдельном http-блоке выполните запрос — Получить ссылку на медиафайл
Загрузка файла по ссылке
Если при загрузке файла по ссылке произошла ошибка — выполнение всего сценария будет остановлено с выводом в чат поля с ошибкой.
Отправка бинарных файлов используется, например, при передаче файлов в нейросеть для последующей обработки.
При интеграции с нейросетями часто используется двухстадийный запрос (например, Gemini и Chat GPT): после первого запроса вы получаете file_id, а затем отправляете этот file_id с промптом.
Пример настройки http-блока для интеграции с Gemini.
Ответ
В случае успеха, сервер должен ответить кодом 200, а тело должно содержать текст для пользователя.
Текст должен быть форматирован под стандарты WhatsApp. Форматирование под другие мессенджеры происходит автоматически на нашем сервере.
В случае ошибки (например валидации), вы можете сообщить пользователю об этом. Для этого сервер должен ответить кодом 422, а тело должно содержать сообщение для пользователя.
Для записи кода ответа включите позицию "Записать код ответа в переменную".
Добавили возможность выводить тело ответа в чат для дальнейшей работы с полученным ответом.
Вывод тела ответа в чат
Время получения ответа можно регулировать от 5 до 60 секунд
Timeout для получения ответа
Записать ответ json в переменные позволяет записывать полученный ответ от сервера в переменные для дальнейшей работы с ними.
Запись ответа в json переменные
Интеграция с Telegram API в чат-боте
Практическое руководство по настройке HTTP блоков для работы с Telegram API.
HTTP запрос и API Telegram
HTTP запрос и API Telegram
Так же блок позволяет проводить обработку ответа с помощью JavaScript и дает возможность "дописать" свой скрипт для расширения функционала вашего бота.
Обработка ответа с помощью JavaScript в HTTP-блоке
Создание умного бота с использованием JavaScript и HTTP запросов
Комплексный кейс разработки бота для фильтрации фильмов с использованием JavaScript логики и HTTP интеграций.
Поиск фильмов в Телеграм боте
Поиск фильмов в Телеграм боте
HR автоматизация: подключение Avito API для поиска персонала
Видео с разбором интеграции Avito API в чат-бот для автоматизации HR-процессов. Узнайте, как создать систему поиска и отбора кандидатов через популярную площадку объявлений.
Парсинг резюме с Avito в Телеграм
Парсинг резюме с Avito в Телеграм
Готовый шаблон для внедрения проекта "Интеграция Авито и Телеграм бота | Парсинг резюме для HR" в один клик:
