Webhook node в n8n: приём данных, ответ и безопасность ¶

Обновлено: 2026-05-29

Webhook node превращает workflow в HTTP-endpoint: внешний сервис отправляет запрос, а n8n запускает сценарий. Через Webhook удобно принимать заявки с сайта, события оплаты, уведомления CRM, сообщения от кастомного backend, callbacks от ботов и внутренние события между сервисами.

Главное правило: Webhook node отвечает за входящий HTTP-запрос. Если нужно обработать бизнес-логику, проверить подпись, записать данные в CRM или вернуть аккуратный JSON-ответ, это делают следующие ноды: Set/Edit Fields, IF/Switch, HTTP Request, Respond to Webhook.

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

Test URL и Production URL

В Webhook node есть два разных адреса. Test URL нужен для настройки: n8n слушает запрос, показывает входные данные прямо в редакторе и помогает увидеть body, query, headers. Production URL используют после активации workflow: запросы уже не выводятся в canvas, но execution можно открыть в истории запусков.

Частая ошибка — отправить production-событие на test URL. В этом случае всё может работать во время настройки и внезапно “сломаться” после закрытия редактора. Для внешних сервисов всегда сохраняйте production URL, а test URL используйте только для отладки.

Как настроить endpoint без сюрпризов

1. Добавьте Webhook node первым шагом workflow.
2. Выберите HTTP Method: чаще всего POST для событий и форм, GET для простых callbacks.
3. Задайте короткий понятный path: lead-from-tilda, payment-yookassa, crm-event.
4. Для теста нажмите Listen for test event и отправьте sample request.
5. Сразу добавьте ноду нормализации: приведите телефон, email, external_id, event_type и source к единому виду.
6. Если внешний сервис ждёт ответ, включите ответ через Respond to Webhook.
7. После теста активируйте workflow и перенесите во внешний сервис production URL.

Где искать входные данные

n8n раскладывает HTTP-запрос на несколько частей. Для форм и API чаще всего нужны:

• $json.body — JSON, form-data или поля формы;
• $json.query — параметры из URL, например ?utm_source=yandex;
• $json.headers — подписи, user-agent, content-type, auth-заголовки;
• $binary — файлы, если endpoint принимает загрузку.

Не передавайте весь входной объект дальше в CRM. Сначала соберите чистый payload: имя, телефон, email, источник, внешний ID, сумма, статус, дата получения. Так легче искать ошибки и не отправить лишние персональные данные в сторонний сервис.

Как вернуть правильный HTTP-ответ

Если сервису важно быстро получить 200 OK, не заставляйте его ждать долгую цепочку AI, CRM и таблиц. Для простых сценариев можно ответить сразу. Для управляемого ответа используйте Respond to Webhook: в Webhook node выберите режим ответа через эту ноду, а дальше верните JSON с понятным статусом.

{
  "ok": true,
  "event_id": "{{$json.body.event_id}}",
  "message": "accepted"
}

Для платежей, CRM-webhooks и лидогенерации полезно возвращать не “готово”, а “принято в обработку”. Тогда внешний сервис получает быстрый ответ, а n8n уже внутри решает, создавать сделку, класть событие в очередь или отправлять ошибку в dead-letter workflow.

Безопасность webhook endpoint

• Не публикуйте URL в открытых репозиториях. Webhook path фактически становится адресом входа.
• Проверяйте подпись или секрет. Многие сервисы умеют отправлять signature header или secret token.
• Используйте HTTPS. Для self-hosted установки проверьте reverse proxy и WEBHOOK_URL.
• Ограничивайте payload. Не принимайте огромные тела запроса без необходимости.
• Делайте idempotency. Повторный webhook не должен создавать второй лид или второй платёж.

Если webhook не работает

Практические связки

• Tilda → Webhook → Битрикс24: форма сайта превращается в лид и уведомление менеджеру.
• Webhook → Postgres idempotency: защита от повторных событий.
• Webhook signature validation: проверка подписи до записи в CRM.
• Webhook с JSON-ответом: когда внешнему сервису нужен структурированный ответ.

Официальные источники

• n8n Webhook node
• Respond to Webhook
• Webhook URL за reverse proxy

FAQ

Почему Test URL работает, а Production URL нет?

Обычно workflow не активирован, во внешнем сервисе сохранён test URL или изменился path в Webhook node. Production URL используйте только после активации workflow.

Нужно ли отвечать на webhook сразу?

Если внешний сервис ждёт быстрый HTTP-ответ, лучше принять событие, вернуть короткий JSON и продолжить обработку внутри workflow. Для этого подходит Respond to Webhook.

Как не создавать дубли?

Сохраняйте event_id, payment_id, lead_id или свой hash payload в Postgres/таблице и проверяйте его перед созданием записи.

{
  "event_id": "evt_...",
  "event_type": "object.updated",
  "received_at": "2026-05-29T10:00:00Z",
  "signature_valid": true,
  "dedupe_key": "provider:event_id",
  "payload_version": "v1"
}