O que o Error Trigger Faz
O nó Error Trigger no n8n permite que você force intencionalmente a falha de um workflow em pontos específicos, útil para validação de dados, tratamento de casos extremos e implementação de lógica de controle de qualidade robusta.
- Interrompe a execução do workflow imediatamente quando acionado
- Registra mensagem de erro customizada para debugging e monitoramento
- Pode ser capturado por workflows de tratamento de erro para ações de recuperação
- Essencial para validação de dados e garantia de qualidade em automações críticas
Principais Casos de Uso
- Validação de Dados: Falhar o workflow se dados críticos estiverem faltando ou inválidos
- Controle de Qualidade: Verificar se condições específicas são atendidas antes de continuar
- Limites de Negócio: Impor regras de negócio estritas (ex: não processar pedidos acima de certo valor sem aprovação)
- Debugging: Forçar falha em pontos específicos durante desenvolvimento para testar tratamento de erros
- Notificações de Alerta: Acionar alertas quando condições anormais são detectadas
Como Configurar
Configuração Básica
- Inserir o Nó: Adicione após uma condição IF ou Switch que detecta um estado de erro
- Mensagem de Erro: Configure uma mensagem descritiva que explique por que o erro foi acionado
- Dados Contextuais: Opcionalmente inclua dados relevantes para ajudar no debugging
- Conectar Tratamento: Configure workflow de tratamento de erro se quiser recuperação automática
Padrão Comum de Uso
O Error Trigger é frequentemente usado em combinação com nós IF:
- IF → condição detecta problema
- Ramo FALSE → Error Trigger com mensagem descritiva
- Ramo TRUE → continua processamento normal
Exemplos Práticos
Exemplo 1: Validação de Dados Obrigatórios
Cenário: Garantir que email e nome estejam presentes
- IF: verifica se
{{ $json.email }}e{{ $json.name }}existem - FALSE → Error Trigger: "Dados obrigatórios ausentes: email ou nome"
- TRUE → continua processamento
Exemplo 2: Limite de Valor
Cenário: Bloquear pedidos acima de R$ 10.000 sem aprovação
- IF:
{{ $json.amount > 10000 && !$json.approved }} - TRUE → Error Trigger: "Pedido de R$ {{ $json.amount }} requer aprovação manual"
- FALSE → processa pedido normalmente
Exemplo 3: Validação de API Response
Cenário: Verificar se API retornou dados válidos
- HTTP Request → busca dados da API
- IF: verifica se
{{ $json.data.length > 0 }} - FALSE → Error Trigger: "API não retornou dados - possível problema no serviço"
- TRUE → processa dados recebidos
Tratamento de Erros
Workflow de Tratamento de Erro
Você pode criar workflows dedicados para capturar e tratar erros:
- Error Trigger Workflow: Crie workflow separado que começa com "When workflow error occurs"
- Captura Contexto: Recebe informações sobre qual workflow falhou e por quê
- Ações de Recuperação: Enviar notificações, logar erros, tentar retry, etc.
- Alertas: Notificar equipe via Slack, email ou sistema de monitoring
Melhores Práticas
Dicas Importantes
- Mensagens Descritivas: Sempre use mensagens de erro claras e acionáveis
- Inclua Contexto: Adicione dados relevantes que ajudem a identificar a causa
- Não Abuse: Use para casos realmente excepcionais, não para controle de fluxo normal
- Configure Alertas: Implemente notificações para erros críticos
- Log Estruturado: Considere logar erros em banco de dados ou serviço de monitoring
- Documente Condições: Deixe claro no workflow quais condições acionam cada erro
Padrões Avançados
1. Retry com Limite
Combinar Error Trigger com lógica de retry:
- Tentar ação até N vezes
- Se todas falharem → Error Trigger
- Notificar sobre falha persistente
2. Validação em Cascata
Múltiplas validações em sequência:
- Validação 1 → IF → Error se falhar
- Validação 2 → IF → Error se falhar
- Todas passaram → Continua
3. Error com Classificação
Diferentes níveis de severidade:
- CRITICAL: para workflow imediatamente
- WARNING: loga mas continua
- INFO: apenas registra para análise