O que fazer quando um fluxo do n8n falha: erros e avisos
Como configurar no n8n um fluxo de erros com Error Trigger e Stop And Error para saber quando uma automação falha, antes do seu cliente.
São 9 da manhã e um cliente escreve para você: "Preenchi o formulário na segunda e ninguém me respondeu." Você confere e descobre que o fluxo que passa os leads para o CRM está quebrado há três dias, porque uma credencial mudou. Ninguém recebeu um alerta, então ninguém soube.
É isso que acontece quando você automatiza sem monitorar. A boa notícia: no n8n, ser avisado quando algo falha se configura em minutos.
Por que um fluxo do n8n falha sem que ninguém perceba?
Porque, por padrão, um erro numa automação só fica registrado dentro do n8n, e ninguém olha esse registro todos os dias. Uma credencial vencida, uma API que muda ou um dado que chega vazio bastam para parar o fluxo.
As falhas mais comuns em negócios reais são estas:
- Uma credencial ou token que expira.
- Um serviço externo que não responde.
- Um dado obrigatório que chega vazio (um telefone sem número, um e-mail sem formato válido).
Se quiser revisar como se constrói um fluxo do zero, comece por o que é o n8n e como funciona.
O que é um fluxo de erros no n8n?
É um fluxo independente que começa com o nó Error Trigger e só é executado quando outro fluxo vinculado falha. Segundo a documentação oficial do n8n, esse nó recebe os detalhes do fluxo que falhou e dos erros, e a partir daí executa o que você definir.
Três detalhes da mesma documentação que vale a pena conhecer:
| Ponto | O que a documentação indica |
|---|---|
| Publicação | Os fluxos de erros não precisam ser publicados |
| Valor padrão | Um fluxo com esse nó usa a si mesmo como tratador de erros |
| Testes | Não é possível testar manualmente: só é ativado quando um fluxo falha de forma automática |
Erro comum: esperar para "testar" o aviso apertando o botão de execução. Como o Error Trigger só é ativado diante de uma falha real, o teste correto é provocar um erro de propósito num fluxo de testes, por exemplo com o nó que explicamos abaixo.
Para que serve o nó Stop And Error?
Serve para fazer um fluxo falhar de propósito, com uma mensagem clara, quando uma condição não é cumprida. A documentação do n8n o descreve como o nó para mostrar mensagens de erro personalizadas, fazer uma execução falhar sob certas condições e enviar informações de erro aos fluxos de erros.
Ele tem duas operações: Error Message, onde você escreve o texto do erro, e Error Object, onde você lança um objeto JSON com as propriedades que quiser.
Um exemplo prático: se um lead chega sem telefone, em vez de deixar a etapa do WhatsApp falhar de forma confusa, você interrompe o fluxo com a mensagem "Lead sem telefone, revisar origem do formulário". O aviso chega com uma causa que qualquer pessoa entende.
Como monto o aviso passo a passo?
Crie um fluxo novo com o Error Trigger, conecte-o a um canal que sua equipe realmente consulte e vincule-o aos fluxos que quer monitorar. A ordem recomendada:
- Crie o fluxo de erros com o nó Error Trigger como primeira etapa.
- Adicione uma etapa de aviso: uma mensagem de WhatsApp ou um e-mail interno ao responsável.
- Inclua na mensagem o nome do fluxo, a etapa que falhou e o horário.
- Vincule esse fluxo de erros a cada automação importante (vendas, pagamentos, atendimento).
- Provoque uma falha de propósito num fluxo de testes para confirmar que o aviso chega.
Se seus fluxos levam leads para um CRM, o aviso faz parte de os processos que você pode automatizar com IA com segurança, porque transforma uma falha invisível numa tarefa com responsável.
O que mudou no n8n esta semana?
O n8n publicou várias versões de manutenção no início de outubro. Segundo suas versões no GitHub, a 2.42.3 (5 de outubro de 2026) inclui um ajuste para manter o executor de tarefas ativo diante de uma rejeição de promessa não tratada, e a 2.43.0 (6 de outubro de 2026), marcada como versão prévia, bloqueia a publicação de fluxos com entradas obrigatórias não conectadas em um nó.
Nenhuma substitui o que veio antes: são melhorias que reduzem falhas, mas não eliminam a necessidade de um aviso. Se um terceiro opera seu n8n, pergunte qual versão ele roda e quando atualiza.
O que mais vale monitorar além dos erros?
As falhas que não geram erro. Um fluxo pode terminar "bem" e mesmo assim não fazer o esperado, por exemplo se o tráfego deixar de chegar. Complemente o aviso com uma revisão semanal de quantos leads entraram no CRM e compare com seus anúncios. Se você usa agentes de IA, defina também instruções claras para seu agente e os casos em que ele deve passar a conversa a uma pessoa, como explicado no guia do agente de IA para WhatsApp.
Em resumo
Uma automação sem aviso de erros é uma aposta. O lead de segunda que ninguém atendeu se evita com um fluxo de erros curto, uma mensagem clara e um canal que sua equipe consulte. Se você prefere não montar nem manter isso, conheça nosso serviço de automação com n8n.
Perguntas frequentes
O que é um fluxo de erros no n8n?
É um fluxo separado que começa com o nó Error Trigger. Segundo a documentação do n8n, quando outro fluxo vinculado falha, esse nó recebe os detalhes da falha e executa o fluxo de erros.
Posso testar o Error Trigger manualmente?
Não. A documentação do n8n indica que não é possível testar manualmente: o gatilho só é ativado quando um fluxo falha de forma automática.
Para que serve o nó Stop And Error?
Serve para mostrar mensagens de erro personalizadas, fazer uma execução falhar sob certas condições e enviar informações do erro ao fluxo de erros.
O fluxo de erros precisa estar publicado?
Não. Segundo a documentação do n8n, os fluxos de erros não precisam ser publicados.
O que o aviso de erro deve incluir?
O mínimo para agir rápido: qual fluxo falhou, em qual etapa e quando. Envie pelo canal que sua equipe realmente consulta, como WhatsApp ou e-mail interno.
Não fique só na teoria: aplique no seu negócio
Implementamos automação com n8n de ponta a ponta, com a sua operação real. A primeira conversa não tem custo.
