Trate erros nos seus workflows

Um workflow publicado falha por motivos externos: uma API fora do ar, uma credencial expirada, um campo em formato inesperado. O n8n oferece três recursos para tratar essas falhas.

1. Workflow de erro

Crie um workflow que começa com o node Error Trigger e envia um aviso. Depois, em cada workflow que você quer proteger, abra Settings e escolha esse workflow no campo Error workflow. Um único workflow de erro pode atender vários workflows.

O Error Trigger recebe um item como este:

1
{
2
  "execution": {
3
    "id": "231",
4
    "url": "https://n8n.example.com/execution/231",
5
    "error": { "message": "Example Error Message" },
6
    "lastNodeExecuted": "Node With Error"
7
  },
8
  "workflow": { "id": "1", "name": "Example Workflow" }
9
}

Monte o aviso com o nome do workflow ({{ $json.workflow.name }}), o node que falhou ({{ $json.execution.lastNodeExecuted }}) e o link da execução ({{ $json.execution.url }}).

Quando a falha acontece no próprio trigger do workflow, as informações chegam em trigger. O campo execution.url não existe, porque a execução nem começou.

2. Novas tentativas e saída de erro

Na aba Settings de um node:

• Retry On Fail repete o node quando ele falha. Bom para instabilidades curtas de APIs.
• On Error > Continue (using error output) cria uma saída de erro no node. Os itens que falharam seguem por ela. Você trata cada caso sem parar o workflow inteiro.

3. Falha controlada

O node Stop And Error encerra a execução com erro quando você decide. Use para entradas inválidas: se um cadastro chega sem e-mail, pare ali e deixe o workflow de erro avisar, em vez de seguir com um registro incompleto.