Перейти к содержанию

HTTP-запрос

Расширение возможностей конструктора через стороннее API и блок HTTP-запрос

Интеграция чат-бота с внешними сервисами с использованием API

Укажите ваш URL, тип запроса и заголовки для обработки запроса.

Поддерживаются методы GET, POST, PUT, DELETE и PATCH.

http в боте

Блок "HTTP-запрос" в сценарии

При использовании метода POST дополнительно появляется возможность передать body в запросе.

Запрос

Для отправки в запросе всех пользовательских переменных, полученных на предыдущих шагах, контакт пользователя и данных crm систем, необходимо включить "Отправлять в запросе данные контакта".

интеграции бот

Отправка данных контакта в запросе

Пример запроса:

{
    "variables": [
        {
            "name": "Город",
            "value": "Москва"
        }
    ],
    "contact": {
        "name": "Дмитрий",
        "messenger": "whatsapp",
        "phone": "79999999999"
    }
}

Важно

Время ожидания соединения: 3 секунды

Отправка файла

Для отправки файла выберете метод POST.

В разделе body выберете режим multipart/form-data и нажмите на кнопку "Добавить файл".

Выберете способ добавления файла:

  • "Загрузить файл" — выберите файл на вашем устройстве. Файл будет загружен сразу и будет отправляться при каждой обработке данного HTTP-запроса.
  • "Указать ссылку" — заполните key и url (в поле url можно указать ссылку на файл текстом или использовать локальную/глобальную переменную, которая содержит ссылку). Файл по ссылке будет загружаться в начале обработки блока HTTP-запроса и отправлен вместе с самим запросом.

Важно

Максимально допустимый размер передаваемого файла — 100 Мб.

интеграция бот

Добавление файла в настройках блока HTTP-запрос

При выборе способа "Указать ссылку" можно указать переменную, в которую раннее в сценарии пользователем чат-бота был загружен файл. Файл из этой переменной будет передан в бинарном формате.

Важно

Ссылку из переменной с файлом предварительно нужно декодировать. Для этого в отдельном http-блоке выполните запрос — Получить ссылку на медиафайл

отправка файлов бот

Загрузка файла по ссылке

Если при загрузке файла по ссылке произошла ошибка — выполнение всего сценария будет остановлено с выводом в чат поля с ошибкой.

Информация

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

При интеграции с нейросетями часто используется двухстадийный запрос (например, Gemini и Chat GPT): после первого запроса вы получаете file_id, а затем отправляете этот file_id с промптом.

Пример настройки http-блока для интеграции с Gemini.

интеграция с gemini

Ответ

В случае успеха, сервер должен ответить кодом 200, а тело должно содержать текст для пользователя.

Текст должен быть форматирован под стандарты WhatsApp. Форматирование под другие мессенджеры происходит автоматически на нашем сервере.

В случае ошибки (например валидации), вы можете сообщить пользователю об этом. Для этого сервер должен ответить кодом 422, а тело должно содержать сообщение для пользователя.

Для записи кода ответа включите позицию "Записать код ответа в переменную".

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

отладка интеграции

Вывод тела ответа в чат

Важно

Время получения ответа можно регулировать от 5 до 60 секунд

интеграция бот

Timeout для получения ответа

Запись json-ответа в переменные

Записать ответ json в переменные позволяет записывать полученный ответ от сервера в переменные для дальнейшей работы с ними.

интеграция бот

Запись ответа в json переменные

Интеграция с Telegram API в чат-боте

Практическое руководство по настройке HTTP блоков для работы с Telegram API.

Так же блок позволяет проводить обработку ответа с помощью JavaScript и дает возможность "дописать" свой скрипт для расширения функционала вашего бота.

внешние интеграции с ботом

Обработка ответа с помощью JavaScript в HTTP-блоке

Создание умного бота с использованием JavaScript и HTTP запросов

Комплексный кейс разработки бота для фильтрации фильмов с использованием JavaScript логики и HTTP интеграций.

HR автоматизация: подключение Avito API для поиска персонала

Видео с разбором интеграции Avito API в чат-бот для автоматизации HR-процессов. Узнайте, как создать систему поиска и отбора кандидатов через популярную площадку объявлений.

Готовый шаблон для внедрения проекта "Интеграция Авито и Телеграм бота | Парсинг резюме для HR" в один клик:

Установить шаблон

Telegram Gift: выдача подарков в Телеграм боте

Пошаговое руководство по подключению Telegram API для выдачи подарков в боте.

Готовый шаблон для внедрения проекта "ВСЁ, что нужно знать о ПОДАРКАХ в Telegram за 15 МИНУТ" в один клик:

Установить шаблон

Серия уроков с интеграцией нейросетей в чат-боты:

help.leadteh.ru

Бонус для новых пользователей и возможность получить 500 рублей баллами в подарок 🎁

  • Регистрируйтесь на LEADTEX
  • Создавайте и тестируйте первый проект
  • Не пропускайте специальный оффер. Получить подарок 👈