У n8n Webhook node есть test и production URL. Test принимает событие только пока редактор слушает тестовый вызов; production предназначен для активированного workflow. Если сайт хранит адрес из тестового окна, после закрытия редактора запросы перестанут создавать execution, хотя сам n8n останется доступен.

Возьмите один обезличенный запрос с event_id, сохраните HTTP method, полный path без секрета, status и первые безопасные символы ответа. Не нажимайте «отправить ещё раз» много раз: сначала выясните, принял ли n8n событие, чтобы не создать пять заказов после восстановления.

Ответ отправителя определяет участок потери

НаблюдениеГде искатьСледующий шаг
DNS или timeoutСеть и публичный hostПроверить URL из той же среды, что сайт
404Path, test listener или inactive workflowСверить URL Webhook node и activation
405HTTP methodPOST, GET и другие методы должны совпасть
401 или 403Webhook authentication или proxyПроверить выбранный auth без публикации секрета
2xx, execution нетДругой workflow, response proxy или очередьНайти event_id и instance logs
Execution есть, сайт ждётResponse mode и длительность workflowПроверить Respond to Webhook или immediate response

Test URL живёт вместе с окном ожидания

Для разработки нажмите Listen for test event и сразу отправьте один запрос на Test URL. Это позволяет увидеть схему входных данных в редакторе. Для постоянной интеграции скопируйте Production URL, сохраните workflow и активируйте его. Не используйте test endpoint как производственный адрес.

Method, path и тело фиксируются в контракте

POST /webhook/order-created
Content-Type: application/json
X-Event-Id: evt_test_001

{
  "event": "order.created",
  "order_id": "test-001",
  "occurred_at": "2026-10-02T09:00:00Z"
}

Пример использует вымышленные данные. Укажите Content-Type, договоритесь о стабильном event_id и проверяйте допустимый размер тела. Если включена authentication, секрет передаётся через безопасную настройку отправителя и n8n credentials, а не в query URL или журнал.

Reverse proxy сообщает правильный публичный адрес

Self-hosted n8n за proxy должен знать внешний protocol, host и base URL, иначе редактор может показать внутренний адрес или http вместо https. Официальная документация описывает WEBHOOK_URL и forwarded headers для reverse proxy. Сравните показанный Production URL с реально доступным маршрутом и не публикуйте порт внутреннего контейнера.

Response mode выбирается под отправителя

  • Respond immediately подходит, когда сайту достаточно быстрого подтверждения приёма.
  • When Last Node Finishes связывает HTTP-ответ со всей длительной цепочкой и может упереться в timeout отправителя.
  • Respond to Webhook даёт явный status и body в выбранной точке workflow.
  • Бизнес-ошибка после быстрого 2xx требует отдельного журнала и повторной обработки.
  • Повтор отправителя поглощается idempotency по event_id, а не создаёт дубликат.

Не возвращайте 2xx до минимальной проверки подписи и формата, если отправитель считает такой ответ окончательным приёмом. Но и не держите соединение открытым ради долгой обработки без необходимости. Запишите контракт: когда событие считается принятым и кто отвечает за retry.

Execution связывается с запросом без персональных данных

Сохраните event_id в execution data и используйте его в журнале сайта. Не логируйте весь body, если в нём контакты или содержимое заявки. При queue mode проверьте основную n8n-службу, worker и общее хранилище: принятый webhook может ждать исполнения, а не пропасть.

Контрольная проверка проходит оба URL осознанно

  1. Открыть Listen for test event и получить одно тестовое execution.
  2. Закрыть listener и убедиться, что test URL больше не используется сайтом.
  3. Активировать workflow и отправить новый event_id на Production URL.
  4. Проверить method, status, execution и ожидаемый response body.
  5. Повторить тот же event_id и не выполнить бизнес-действие второй раз.
  6. Перезапустить self-hosted n8n и подтвердить прежний публичный Production URL.

Для диагностики подготовьте n8n version, тип размещения, method и path, status отправителя, активность workflow, event_id и безопасную часть execution log. Credentials, подписи и реальное тело заявки замените тестовыми значениями.

Проверенные источники