HTTP-запрос

Расширение возможностей конструктора через стороннее API

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

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

При использовании метода 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.

Ответ

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

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

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

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

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

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

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

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

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

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

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

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

PreviousВстроенный бот ТелеграмNextИнтеграции с зарубежными сервисами

Last updated

Was this helpful?