Перейти к содержимому
Интеграции

Запрос к сервису: бот берёт данные из вашего сайта или CRM по API

Сценарий делает запрос к внешнему сервису — проверяет остаток, создаёт заказ, узнаёт статус — и работает с ответом дальше.

Кратко

«Запрос к сервису» в конструкторе Telegram-ботов Forgebot — это блок, который во время сценария обращается к вашему сайту или сервису по API: отправляет запрос (метод, адрес, заголовки, данные) и сохраняет нужные части ответа в переменные. Секреты при этом хранятся отдельно и в сам сценарий не попадают.

Бесплатный тариф — без карты.

Панель настроек блока «Запрос к сервису» в редакторе
О блоке

Что делает блок «Запрос к сервису»

Блок обращается к вашей системе — сайту, складу, CRM — прямо посреди сценария и получает от неё данные. Например, проверяет, есть ли товар, или создаёт заказ. Клиент этого не видит: он замечает только результат — следующее сообщение, которое бот составит по полученным данным.

Поля

Настройки блока

Панель настройки блока — что заполнить:

Метод
Что сделать с сервисом: получить данные (GET) или отправить и изменить их (POST, PUT, PATCH, DELETE). Выбор из списка.
URL
Адрес вашего сервиса, к которому обращается бот. Можно подставлять переменные — например {{contact.id}} прямо в адресе.
Заголовки
Дополнительные пометки к запросу — чаще всего ключ доступа. Необязательно. Секрет не пишут прямо здесь: вместо него ставят ссылку {{secret:NAME}}, а сам секрет хранится отдельно в настройках бота и в логи не попадает.
Тело
Данные, которые бот отправляет сервису (для POST, PUT, PATCH, DELETE; для GET не используется). Заполняется парами «поле — значение» или целиком как JSON. В значениях работают переменные, например {{contact.first_name}}.
Извлечь
Что достать из ответа сервиса и в какую переменную положить: имя переменной плюс путь к значению в ответе (например $.data.payment_link). Галочка «Сохранить в контакт» оставляет значение и после этого прогона.
Пример

Пример: проверка товара на складе

Клиент спрашивает про наличие. Блок «Запрос к сервису» методом GET обращается к вашему складу по адресу с {{product_id}}, достаёт из ответа остаток в переменную stock, и следующий шаг сценария сообщает клиенту, есть товар или нет.

FAQ

Частые вопросы

Не утекут ли мои ключи и пароли?

Нет. Секрет (токен, пароль) не хранится в самом сценарии — вы держите его отдельно в настройках бота, а в запросе лишь ссылаетесь на него по имени: {{secret:NAME}}. При отправке бот подставит настоящее значение, но в сценарии и в логах останется только ссылка, а не сам секрет.

Как проверить, что запрос настроен правильно?

Прямо в блоке есть кнопка «Протестировать» — она по-настоящему отправляет ваш текущий запрос и показывает ответ сервиса, чтобы вы увидели результат ещё до запуска сценария. Чтобы не перегружать сервис, между тестами кнопка ненадолго блокируется.

Что делать с данными из ответа?

Их сохраняют в переменные в разделе «Извлечь», а дальше используют в сценарии как обычно — подставить в сообщение через {{...}}, проверить в условии или отправить в другой запрос. Значение с галочкой «Сохранить в контакт» останется у клиента и после этого прогона.

// Начните сегодня

Запустите Telegram-бота с Forgebot

Соберите первый сценарий, отвечайте подписчикам и смотрите аналитику — бесплатно, без кода.

Бесплатный тариф: 1 бот, 5 сценариев, 100 подписчиков. Без карты.