Nodes e triggers
Antes de começar
Distinguir trigger de ação e saber quais configurações do node controlam falhas e repetição.
- Um workflow de teste aberto no editor.
Todo node do n8n executa uma operação. Na hora de adicionar um node, o painel mostra essas operações em dois grupos.
Triggers e ações
Triggers iniciam o workflow quando algo acontece: um horário, uma chamada de webhook, um e-mail novo, um registro criado em um aplicativo. No painel de nodes, eles aparecem com o ícone de raio.
Ações fazem o trabalho dentro do workflow: buscam e enviam registros, criam itens em outros sistemas, transformam campos. Um mesmo aplicativo costuma oferecer as duas coisas. O node do Google Sheets, por exemplo, tem trigger para linha nova e ações para ler e gravar linhas.
Como os itens passam
Uma conexão leva a saída de um node até a entrada do seguinte. Para ligar dois nodes, arraste do ponto à direita do primeiro até a entrada à esquerda do segundo. Um node pode ter mais de uma saída, como o If, que separa os itens em verdadeiro e falso.
Configurações que mudam o comportamento
A aba Settings de cada node guarda opções que valem a pena conhecer cedo:
| Opção | O que faz |
|---|---|
| Always Output Data | Entrega um item vazio mesmo quando o node não retorna nada |
| Execute Once | Processa só o primeiro item recebido |
| Retry On Fail | Repete a execução do node quando ela falha |
| On Error | Escolhe entre parar o workflow, continuar ou seguir por uma saída de erro |
A documentação alerta para o uso de Always Output Data em nodes If: a combinação pode criar um loop infinito.
Anote o que cada node faz
A mesma aba aceita uma nota. Ative Display note in flow para a nota aparecer embaixo do node no canvas. Em workflows longos, a nota explica o papel do node sem que seja preciso abrir cada um.
Confira o resultado
No seu workflow de teste, você identifica o trigger pelo ícone de raio e encontra as opções Retry On Fail e On Error na aba Settings de um node.
Fontes e conferência
Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.
