Запрос к сервису: бот берёт данные из вашего сайта или CRM по 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, и следующий шаг сценария сообщает клиенту, есть товар или нет.
Частые вопросы
Не утекут ли мои ключи и пароли?
Нет. Секрет (токен, пароль) не хранится в самом сценарии — вы держите его отдельно в настройках бота, а в запросе лишь ссылаетесь на него по имени: {{secret:NAME}}. При отправке бот подставит настоящее значение, но в сценарии и в логах останется только ссылка, а не сам секрет.
Как проверить, что запрос настроен правильно?
Прямо в блоке есть кнопка «Протестировать» — она по-настоящему отправляет ваш текущий запрос и показывает ответ сервиса, чтобы вы увидели результат ещё до запуска сценария. Чтобы не перегружать сервис, между тестами кнопка ненадолго блокируется.
Что делать с данными из ответа?
Их сохраняют в переменные в разделе «Извлечь», а дальше используют в сценарии как обычно — подставить в сообщение через {{...}}, проверить в условии или отправить в другой запрос. Значение с галочкой «Сохранить в контакт» останется у клиента и после этого прогона.
Другие блоки этой группы
Оплата
Бот выставляет счёт на оплату прямо в чате. Например, оплата заказа картой или звёздами Telegram.В чат команды
Бот отправляет сообщение в ваш рабочий чат или канал. Например, уведомить команду о новой заявке.ИИ-ассистент
ИИ отвечает клиенту своими словами по вашим инструкциям и базе знаний. Например, консультант кофейни советует напиток и отвечает на вопросы о меню.Ждать данные
Ждёт, пока внешний сервис пришлёт событие на приёмник данных. Например, дождаться оплаты счёта и выдать доступ.Запустите Telegram-бота с Forgebot
Соберите первый сценарий, отвечайте подписчикам и смотрите аналитику — бесплатно, без кода.
Бесплатный тариф: 1 бот, 5 сценариев, 100 подписчиков. Без карты.