Três palavras explicam quase tudo no n8n: node é um bloco que faz uma coisa, trigger é o node especial que dá a partida, e workflow é o desenho inteiro que você ativa. Se você entender essas três e mais duas que vêm junto — item e execução —, para de se perder na interface. Este é o vocabulário mínimo, com o significado que a ferramenta realmente usa, não o do dicionário.
Adicione ao Google NotíciasNeste artigo
Node: o bloco que faz uma coisa só
Cada retângulo na tela é um node. Ele recebe dados, faz uma operação e devolve dados. É a unidade de trabalho do n8n, e o princípio por trás dele é fazer uma coisa bem: um node envia e-mail, outro grava na planilha, outro decide entre dois caminhos.
Existem três famílias que vale distinguir desde já:
Nodes de gatilho — só podem ficar no começo. Não têm entrada, só saída.
Nodes de ação — a maioria. Recebem, fazem, devolvem.
Nodes de lógica — não falam com serviço nenhum; organizam o caminho (decidir, juntar, repetir, esperar).
Se um node aparece sem o pontinho de entrada do lado esquerdo, é gatilho. Esse detalhe visual responde sozinho a maior parte da dúvida "por que não consigo ligar isso aqui".
Trigger: o que acorda o fluxo
O gatilho define quando o fluxo roda, e essa escolha muda mais coisa do que parece. Os tipos que você vai usar de verdade:
| Tipo | Dispara quando | Use para |
|---|---|---|
| Manual | Você clica | Testar durante a construção |
| Agendado | Chega o horário | Rotinas: relatório diário, verificação periódica |
| Webhook | Alguém envia dados para uma URL | Receber de sistemas externos, formulários |
| De aplicativo | Algo acontece no serviço | Mensagem recebida, linha nova na planilha |
A diferença entre agendado e webhook é a que mais pesa no custo. Um fluxo agendado que verifica algo a cada minuto roda mais de 43 mil vezes por mês, mesmo quando não há nada de novo. O mesmo resultado por webhook roda só quando existe fato novo. Sempre que o sistema de origem puder avisar, prefira ser avisado a ficar perguntando.
Workflow: o desenho completo
Gatilho mais nodes conectados formam o workflow. Ele tem um estado que confunde iniciante: ativo ou inativo.
Inativo, ele só roda quando você manda executar na tela. Ativo, ele passa a rodar sozinho pelo gatilho. Um fluxo salvo mas inativo não faz absolutamente nada — e é a explicação mais comum para "montei tudo e não aconteceu".
Item: a palavra que resolve metade das dúvidas
Este é o conceito que a maioria dos tutoriais pula, e é justamente o que trava as pessoas depois.
O que passa entre um node e outro não é "um dado". É uma lista de itens. Cada item é um registro independente — um contato, um pedido, uma linha da planilha.
A consequência prática é grande: quando um node recebe cinco itens, ele executa a operação cinco vezes, uma para cada. Você configura o node uma vez, e ele repete sozinho.
É por isso que um fluxo que busca dez contatos e envia e-mail dispara dez e-mails, sem você configurar repetição nenhuma. E é por isso que, quando alguém reclama que "mandou mensagem repetida para todo mundo", quase sempre o node anterior devolveu mais itens do que a pessoa imaginava.
Antes de ativar qualquer fluxo que envie mensagem, olhe quantos itens o node anterior está devolvendo. O painel de saída mostra a contagem. Esse hábito evita o acidente mais constrangedor da automação.
Execução: cada vez que o fluxo roda
Uma execução é uma rodada completa, do gatilho ao último node. Ela fica registrada no histórico com o que entrou e o que saiu de cada node — e é essa gravação que transforma depuração em algo possível.
Duas coisas importantes sobre execução:
Ela conta como uma só, independentemente do tamanho. Um fluxo de cinquenta nodes que roda do início ao fim é uma execução, não cinquenta. Isso muda a comparação de preço com ferramentas que cobram por passo.
Ela é a sua caixa-preta. Quando algo der errado, o histórico mostra exatamente em qual node parou e qual dado estava passando naquele momento.
Duas palavras que aparecem logo depois
Credencial: a conexão com um serviço, cadastrada separadamente e reutilizável. Você configura o acesso ao Gmail uma vez e usa em vinte fluxos. Elas ficam guardadas de forma criptografada, e quem abre o fluxo não vê a senha.
Expressão: um trecho entre chaves duplas que aponta para um dado vindo do node anterior, em vez de um valor fixo. É o que permite enviar o e-mail para o endereço que chegou, e não para um endereço digitado à mão.
Com node, trigger, workflow, item e execução você já consegue ler qualquer tutorial de n8n sem travar no vocabulário. O resto é prática.
Esta aula faz parte do Curso de n8n do zero ao avançado, com todas as aulas em portugues.
Perguntas frequentes
O que é um node no n8n?
É cada bloco do fluxo — a unidade que recebe dados, executa uma operação específica e devolve o resultado para o próximo. Existem nodes de gatilho, que iniciam o fluxo, nodes de ação, que falam com serviços externos, e nodes de lógica, que organizam o caminho sem acessar nada.
Qual a diferença entre workflow e execução?
O workflow é o desenho, que existe uma vez só. A execução é cada vez que esse desenho roda. Um fluxo ativo pode acumular milhares de execuções, todas registradas no histórico com os dados que passaram.
Por que meu fluxo não roda sozinho?
Na maioria das vezes porque ele está salvo mas inativo. Salvar e ativar são ações diferentes no n8n: enquanto o fluxo estiver inativo, ele só roda quando você executa manualmente na tela.
O que é um item no n8n?
É cada registro individual que trafega entre os nodes. Os dados sempre viajam como uma lista de itens, e o node executa sua operação uma vez para cada item recebido — por isso um fluxo com dez itens envia dez mensagens sem nenhuma configuração de repetição.
Uma execução conta por node ou pelo fluxo inteiro?
Pelo fluxo inteiro. Uma rodada completa, do gatilho ao último node, conta como uma única execução, independentemente de quantos nodes existam no caminho.
