Triagem de Incidente em Webhook n8n
Separe falha de ingress, execução, credencial, API downstream e contrato de resposta em um webhook n8n self-hosted.
O nível de evidência descreve minha experiência com o conteúdo. Fonte oficial descreve contrato/documentação da plataforma. Observação de produção não deve ser tratada automaticamente como limite oficial.
Prove o ingress
Confirme DNS/TLS/reverse proxy até o path correto do webhook antes de depurar nodes.
Cheque execution history
Veja se o request criou execução e capture o primeiro node que falhou.
Valide contrato de entrada
Campos obrigatórios, content type, assinatura/auth e payload size antes de side effects.
Valide escopo da credencial
Separe credencial inválida/expirada de credencial válida sem permissão downstream.
Inspecione retry e idempotência
Retry do caller não pode duplicar emails, writes, eventos ou efeitos irreversíveis.
Retorne resposta estável
Caller público recebe status/body intencional, não stack trace interno.
Capture o caso de regressão
Transforme o incidente em payload de teste, Production Bite ou item de checklist.