automation // n8nLAB

n8n Webhook — Envelope de Erro Estável

Retorne respostas previsíveis de sucesso/erro para o caller diferenciar input aceito de falha interna do workflow.

n8nwebhookapierror handling
Context Pack →Abrir Workspace →
Trust & provenanceLAB
Nível de evidênciaLABFontes oficiais0Outras fontes0Última verificação2026-10-05

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.

EvidênciaLAB
Dificuldadefundamentos
Verificado2026-10-05
Use quando

Formulário público ou aplicação chama n8n via webhook HTTP.

// Code node output example
return [{
  json: {
    ok: false,
    code: 'VALIDATION_ERROR',
    message: 'Missing required field',
    requestId: $execution.id
  }
}];
Por que funciona

Contrato de resposta estável desacopla o frontend da estrutura interna dos nodes.

Notas operacionais

Não devolva credenciais, stack traces ou dados internos de nodes para callers públicos.

Mantenha logs detalhados em um caminho interno separado.