Tratamento de Erros no N8N: Retentativas, Alertas e Fluxos de Erro

Toda automação vai falhar um dia. Uma API fica fora do ar, uma credencial expira, um cliente preenche um campo de um jeito inesperado. O problema não é a falha em si, e sim descobrir dias depois que um processo importante parou sem avisar ninguém. Neste artigo, vamos ver as ferramentas que o N8N oferece para lidar com erros e como combiná-las em uma estratégia simples.

Por que tratar erros desde o início

Um workflow sem tratamento de erros funciona bem enquanto tudo dá certo. Quando algo falha, a execução para no nó com problema e o restante do fluxo não acontece. Se ninguém olhar a lista de execuções, a falha passa despercebida.

Tratar erros desde o início traz três benefícios:

Falhas temporárias se resolvem sozinhas, sem intervenção.
Falhas permanentes chegam a quem pode resolver, no momento em que acontecem.
Dados que não puderam ser processados ficam registrados para uma nova tentativa.

Tipos de erro mais comuns

Tipo	Exemplo	Melhor resposta
Temporário	Tempo esgotado, limite de requisições, instabilidade	Tentar de novo após alguns segundos
De dados	Campo vazio, formato inválido, registro inexistente	Desviar o item e registrar o motivo
De configuração	Credencial expirada, permissão negada	Alertar a equipe imediatamente

Separar os erros por tipo ajuda a escolher a ferramenta certa para cada um.

Retentativas automáticas

Nas configurações de cada nó existe a opção Retry On Fail. Ao ativá-la, você define quantas tentativas o N8N deve fazer e quanto tempo esperar entre elas.

Ela é ideal para chamadas HTTP e integrações com serviços externos, onde a maioria das falhas é passageira. Uma configuração comum é de três tentativas com alguns segundos de intervalo. Para APIs com limite de requisições, aumente o intervalo para dar tempo ao limite de ser reiniciado.

Retentativas não resolvem erros de dados ou de configuração. Repetir uma chamada com uma credencial expirada só atrasa o alerta.

Continuando o fluxo quando um nó falha

Também nas configurações do nó, a opção On Error define o que acontece quando as tentativas se esgotam:

Parar o workflow: o comportamento padrão. A execução termina com erro.
Continuar: o fluxo segue com os dados que o nó conseguiu produzir, ignorando a falha.
Continuar usando a saída de erro: o nó ganha uma segunda saída, por onde passam apenas os itens que falharam.

A terceira opção é a mais útil para erros de dados. Os itens válidos seguem o caminho normal, enquanto os problemáticos vão para um ramo separado, onde podem ser gravados em uma planilha de pendências ou enviados para revisão.

O workflow de erro

Para falhas que interrompem a execução, o N8N permite definir um workflow de erro. Ele é um fluxo separado que começa com o nó Error Trigger e é executado automaticamente sempre que outro workflow falha.

Para configurar:

Crie um novo workflow com o nó Error Trigger como gatilho.
Adicione os nós que devem avisar a equipe, como e-mail, Slack, Telegram ou WhatsApp.
Nas configurações do workflow que você quer proteger, escolha esse fluxo no campo de workflow de erro.

O Error Trigger recebe o nome do workflow que falhou, o nó onde o erro aconteceu, a mensagem de erro e o link para a execução. Com isso, o alerta já chega com tudo o que é preciso para investigar.

Um único workflow de erro pode atender a todos os seus fluxos. Assim, os alertas ficam padronizados e você mantém tudo em um só lugar.

Gerando erros de propósito

Às vezes o fluxo não falha tecnicamente, mas o resultado está errado. Uma consulta que deveria retornar um cliente volta vazia, ou um valor chega negativo.

Para esses casos, use o nó Stop and Error. Ele interrompe a execução com uma mensagem definida por você e aciona o workflow de erro como qualquer outra falha. É a forma de transformar uma regra de negócio em um alerta.

Boas práticas para alertas

Envie alertas para um canal que a equipe realmente acompanha.
Inclua o link da execução, o nome do fluxo e a mensagem de erro.
Evite alertas para falhas que já são tratadas por retentativas.
Agrupe falhas repetidas para não gerar dezenas de mensagens iguais.
Revise as execuções com erro toda semana, mesmo quando nada pareceu urgente.

Uma estratégia simples para começar

Se você ainda não trata erros, comece por estes três passos:

Ative retentativas em todos os nós que chamam serviços externos.
Crie um workflow de erro com um alerta para o canal da equipe e ligue-o aos fluxos mais importantes.
Use a saída de erro nos nós que processam dados vindos de pessoas, como formulários e planilhas.

Esses passos levam menos de uma hora e eliminam a maior parte das falhas silenciosas.

A infraestrutura também conta

Tratamento de erros cobre o que acontece dentro dos fluxos. Mas se a instância do N8N cair, nenhum workflow de erro será executado.

Com o lui, cada cliente tem uma instância dedicada do N8N, isolada das demais e acompanhada pela nossa equipe. Assim, você cuida das regras dos seus fluxos e o lui cuida da infraestrutura que os mantém no ar.

Conclusão

Automações confiáveis não são as que nunca falham, e sim as que falham de forma visível e se recuperam sozinhas quando possível. Combinando retentativas, saídas de erro, um workflow de erro e alertas bem pensados, você garante que nenhum processo importante pare em silêncio.