У n8n Webhook node есть test и production URL. Test принимает событие только пока редактор слушает тестовый вызов; production предназначен для активированного workflow. Если сайт хранит адрес из тестового окна, после закрытия редактора запросы перестанут создавать execution, хотя сам n8n останется доступен.
Возьмите один обезличенный запрос с event_id, сохраните HTTP method, полный path без секрета, status и первые безопасные символы ответа. Не нажимайте «отправить ещё раз» много раз: сначала выясните, принял ли n8n событие, чтобы не создать пять заказов после восстановления.
Ответ отправителя определяет участок потери
| Наблюдение | Где искать | Следующий шаг |
|---|---|---|
| DNS или timeout | Сеть и публичный host | Проверить URL из той же среды, что сайт |
| 404 | Path, test listener или inactive workflow | Сверить URL Webhook node и activation |
| 405 | HTTP method | POST, GET и другие методы должны совпасть |
| 401 или 403 | Webhook 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 осознанно
- Открыть Listen for test event и получить одно тестовое execution.
- Закрыть listener и убедиться, что test URL больше не используется сайтом.
- Активировать workflow и отправить новый event_id на Production URL.
- Проверить method, status, execution и ожидаемый response body.
- Повторить тот же event_id и не выполнить бизнес-действие второй раз.
- Перезапустить self-hosted n8n и подтвердить прежний публичный Production URL.
Для диагностики подготовьте n8n version, тип размещения, method и path, status отправителя, активность workflow, event_id и безопасную часть execution log. Credentials, подписи и реальное тело заявки замените тестовыми значениями.