Webhook — отправка данных наружу

Шаг Webhook отправляет HTTP-запрос с данными лида на ваш URL — для CRM, таблиц и внешней автоматизации.

Обновлено 30 августа 2026 г.3 мин

Шаг Webhook — отправляет HTTP-запрос на внешний URL с данными лида. Это исходящий webhook, в отличие от Webhooks & API — приём данных извне, где описывается приём данных от внешних систем.

Используется для интеграций с внешним миром: партнёрки, CRM, базы данных, ваш собственный backend. Бот сам инициирует запрос в нужный момент воронки.

Одинарные скобки {var}

В этом шаге используется свой template engine с одинарными фигурными скобками {var}. Не путайте с {{var}} (двойные) в Bot Settings → Webhooks & API и в текстах сообщений. Это ДРУГИЕ синтаксисы для двух разных API. Шаг Webhook принимает только {var}.

Когда использовать

Передать {tracker.clickid} в партнёрку. Уведомить вашу CRM о новом квалифицированном лиде. Сохранить данные в собственную базу для анализа. Триггернуть SMS-сервис при определённом событии. Любая ситуация «бот должен послать данные внешней системе».

Видео

Как работает

Шаг используется для:

Передачи данных во внешние системы.

Интеграции с базами и сервисами.

Автоматизации обработки лидов вне Chatterfy.

Передачи параметров клиента партнёрам.

Шаг отправляет данные наружу. Если нужно принять данные обратно — используйте Webhooks & API — приём данных извне.

Settings

Параметр	Что задаёт
Title	Имя шага
Delay	Задержка перед отправкой
Finish Status	Статус диалога
Hide keyboard	Убрать клавиатуру
Is start step of flow	Сделать стартовым
Skip the transition	Не переходить автоматически (с waiting)

Webhook — параметры запроса

Параметр	Что задаёт
URL	Куда отправить запрос
Method	GET (через URL) или POST (тело запроса)

Body — для POST-запросов

Используется только для POST. В Body указывается JSON-структура с подстановкой переменных:

{"username": "{username}", "chat_id": "{chatId}", "clickid": "{tracker.clickid}"}

Available variables — переменные

В URL и Body можно использовать переменные. Все — с одинарными фигурными скобками:

Системные

Переменная	Что возвращает
{username}	Username Telegram
{chatId}	Chat ID Telegram
{stepKey}	Ключ текущего шага
{createdAt}	Время начала диалога (ISO 8601)

Кастомные поля и tracker

{KEYCUSTOMFIELD} — значение кастомного поля по ключу. Например, {partner_id} — поле partner_id.

{tracker. KEYTRACKERFIELD} — значение трекерного параметра. Например, {tracker.clickid}, {tracker.utm_source}.

Шаги настройки

Добавьте шаг Webhook в flow

Откройте блок Webhook

Укажите URL для отправки запроса

Выберите Method — GET или POST

Если POST — заполните Body

Подставьте нужные переменные через {var}

Подключите следующий шаг

Примеры использования

GET — отправка в Keitaro tracker

https://keitaro.yoursite.com/25123a/postback?subid={tracker.clickid}&username={username}&chatid={chatId}&startdialogue={createdAt}

Подставлено:

subid={tracker.clickid} — clickid лида.

username={username} — Telegram username.

chatid={chatId} — Telegram ID.

startdialogue={createdAt} — время начала диалога.

POST — отправка в собственную базу

{
  "username": "{username}",
  "chat_id": "{chatId}",
  "partner_id": "{partner_id}",
  "registered_at": "{createdAt}"
}

URL: https://yourapi.com/leads. Method: POST.

Что важно учесть

Перед запуском — проверьте принимающую сторону

Запрос отправляется автоматически — если URL неправильный или сервер не готов принять, данные потеряются. Убедитесь, что: URL корректный, сервер принимает указанный метод (GET/POST), формат данных соответствует ожиданиям. Корректность можно проверить в Logs → Webhooks бота.

Что доступно через переменные

Через {var} доступны: системные ({username}, {chatId}, {stepKey}, {createdAt}), кастомные поля по ключу ({partner_id}, etc), tracker-параметры ({tracker.clickid}, {tracker.utm_source}). Bot Variables через шаг Webhook НЕ подставляются — это ограничение текущего template engine.