Expert Digital Base para IAs A escola Lucas Cruz Agenda FAQ Blog Ler no site → Site principal →
Artigo do blog

Glossário Completo do n8n: Todos os Termos que Você Precisa Dominar Para Criar Automações Profissionais

Por Lucas Cruz · Publicado em 11 de maio de 2026 · Categoria: Automações

Glossário Completo do n8n: Todos os Termos que Você Precisa Dominar Para Criar Automações Profissionais

Glossário Completo do n8n:
Todos os Termos que Você
Precisa Dominar Para Criar
Automações Profissionais

Perdeu no meio de uma automação porque não sabia o que era um "item", uma "expression" ou um "branch"? Este glossário reúne mais de 40 termos do n8n explicados em português, com exemplos práticos de cada um — do básico ao avançado, incluindo AI Agent e MCP.

🎯 O que você vai encontrar

Este glossário cobre todos os conceitos essenciais do n8n organizados por categoria: estrutura (workflow, node, canvas, connection), execução (trigger, execution, item, queue), dados (expression, JSON, pin data, binary data), lógica (IF, Switch, Loop, Merge, Branch), integrações (credential, webhook, HTTP Request, API), código (Code node, Function, Expression editor) e IA (AI Agent, Tool, Memory, MCP). Cada termo tem uma definição clara, tradução e exemplo prático.

40+
termos explicados neste glossário — do básico ao avançado
400+
nodes disponíveis no n8n v2.0 incluindo mais de 70 para inteligência artificial
7k+
templates prontos disponíveis no site oficial n8n.io/workflows
2019
ano de criação do n8n por Jan Oberhauser em Berlim — "nodemation"
📋 Categorias do glossário
  1. Estrutura e interface do n8n
  2. Nodes: os blocos de construção
  3. Triggers: como workflows iniciam
  4. Execução e ciclo de vida
  5. Dados: items, JSON e expressões
  6. Lógica e controle de fluxo
  7. Integrações e autenticação
  8. Código e transformação avançada
  9. IA, Agentes e MCP (novidades 2025–2026)
  10. Modos de hospedagem
  11. Recursos da Expert Digital
  12. FAQ — perguntas frequentes
🏗️ Estrutura e Interface Conceitos base
Workflow / Fluxo de trabalho
Fundamental

Uma sequência de nodes (nós) conectados visualmente que formam uma automação completa. O workflow é a "receita" da automação — define o que acontece, em que ordem e sob quais condições. Pode estar Ativo (executa automaticamente quando o trigger dispara) ou Inativo (só executa manualmente, modo de desenvolvimento).

💡 Exemplo prático
Um workflow que: quando um novo lead preenche o formulário do site (Trigger) → busca o lead no CRM (Node 1) → envia mensagem de boas-vindas no WhatsApp (Node 2) → adiciona em uma planilha Google Sheets (Node 3).
Canvas/ Tela
Interface

A área de trabalho visual do n8n onde você arrastar, soltar e conectar os nodes para construir o workflow. É o equivalente de uma lousa em branco onde você monta o fluxo de automação visualmente. Suporta zoom, pan, mini-mapa e agrupamento de nodes.

Connection/ Conexão
Estrutura

A linha que conecta dois nodes no canvas e define o caminho pelo qual os dados (items) fluem de um node para o próximo. Uma connection sai da saída de um node e entra na entrada do próximo. Pode ser de dados (linha sólida) ou de AI (linha tracejada para connections de AI Agent).

Save & Publish/ Salvar e Publicar
v2.0 — Novo

Modelo introduzido no n8n v2.0 (dezembro de 2025) que separa o rascunho (draft) do workflow da versão em produção. Você pode editar o workflow sem interromper as execuções ativas — as mudanças só são aplicadas quando você clica em "Publicar". Isso torna os deploys mais seguros e previsíveis.

💡 Por que importa
Antes do v2.0, qualquer salvamento imediato afetava o workflow em produção. Agora, você pode trabalhar em melhorias enquanto a versão anterior continua rodando para clientes.
Template/ Modelo pronto
Produtividade

Um workflow pré-construído com nodes, conexões e lógica definidos para um caso de uso específico, disponível para importar e adaptar. O repositório oficial em n8n.io/workflows tem mais de 7.000 templates. Cada template inclui exemplos de dados de entrada e configurações já testadas — você só precisa ajustar as credenciais e os campos específicos do seu contexto.

🔲 Nodes: os Blocos de Construção 400+ disponíveis
Node/ Nó
Fundamental

O bloco fundamental de construção de qualquer automação no n8n. Cada node representa uma ação específica — buscar dados no Google Sheets, enviar e-mail pelo Gmail, fazer uma requisição HTTP, aplicar uma condição lógica, transformar dados com código. Nodes recebem items de entrada, processam e geram items de saída para o próximo node.

Existem três tipos principais: Trigger Nodes (iniciam o workflow), Action Nodes (executam ações em serviços externos) e Core Nodes (lógica, transformação e controle de fluxo).

Trigger Node/ Nó gatilho
Tipo de node

O node especial que inicia a execução de um workflow. Todo workflow começa obrigatoriamente com exatamente um Trigger Node — é ele quem "dispara" o workflow quando algo acontece. Aparece no canvas com um símbolo de raio (⚡). Exemplos: Schedule Trigger, Webhook, Gmail Trigger, Google Sheets Trigger.

Community Node/ Nó da comunidade
Extensão

Nodes criados e mantidos pela comunidade open-source do n8n, não pelo time oficial. Podem ser instalados pelo menu Settings → Community Nodes → Install. Exemplos populares: nodes para Whapi.cloud, Z-API, Evolution API (WhatsApp) e integrações com plataformas brasileiras. Disponíveis em instâncias self-hosted; na cloud, apenas nodes verificados por padrão.

⚠️ Atenção
Sempre verifique a reputação e a manutenção ativa de um Community Node antes de usar em produção — diferente dos nodes oficiais, não têm garantia de suporte contínuo.
Triggers: Como Workflows Iniciam Início de tudo
Trigger/ Gatilho
Fundamental

O evento que inicia a execução de um workflow. Pode ser: um horário específico (Schedule Trigger), uma chamada HTTP recebida (Webhook), uma ação manual (Manual Trigger), um evento em serviço externo (Gmail Trigger, Google Sheets Trigger) ou um sinal de outro workflow (Execute Workflow Trigger).

Webhook/ Gatilho HTTP
Tipo de trigger

Um tipo de Trigger que expõe uma URL pública única. Quando um sistema externo envia dados para essa URL (via HTTP POST, GET, etc.), o workflow é executado automaticamente com os dados recebidos como input. É o mecanismo mais versátil para integrar o n8n com qualquer sistema que suporte envio de dados via HTTP.

💡 Exemplo
O formulário do site envia um POST para https://n8n.suaempresa.com/webhook/novo-lead — o workflow dispara automaticamente com nome, e-mail e telefone do lead como items de entrada.
Schedule Trigger/ Gatilho por horário
Tipo de trigger

Trigger que executa o workflow automaticamente em intervalos de tempo definidos. Pode ser configurado para rodar a cada X minutos, horariamente, diariamente em hora específica, semanalmente ou com expressão cron para horários complexos. O n8n usa a expressão cron padrão: * * * * * (minuto hora dia mês dia-da-semana).

💡 Exemplo
Executar todo dia às 08h00 para gerar o relatório diário de leads: cron 0 8 * * *
▶️ Execução e Ciclo de Vida Monitoramento
Execution/ Execução
Fundamental

Cada vez que um workflow roda — do trigger até o último node — isso é uma execução. O n8n registra todas as execuções com: status (Success, Error, Waiting, Running), dados processados em cada node, duração total e timestamp. Acessível em Executions no menu lateral.

Execution Log/ Histórico de execuções
Debug

O registro histórico de todas as execuções de um workflow. Para cada execução, você pode clicar e ver exatamente quais dados passaram por cada node — ferramenta essencial para depurar erros. Na execução com erro, o node que falhou aparece em vermelho, com a mensagem de erro e os dados que causaram o problema.

Queue Mode/ Modo fila
Avançado

Modo de operação onde execuções são enfileiradas e processadas por múltiplos Workers em paralelo. Requer Redis como broker de mensagens. Ideal para instâncias self-hosted com alto volume de execuções simultâneas. O modo padrão é o Main Mode (tudo no mesmo processo) — Queue Mode é para escala.

Retry/ Tentativa automática
Resiliência

Configuração que faz o n8n tentar executar novamente um workflow que falhou, automaticamente após um intervalo. Pode ser configurado com número de tentativas e intervalo entre elas. Útil para lidar com falhas temporárias de API externas ou timeouts de rede.

📦 Dados: Items, JSON e Expressões Coração do n8n
Item/ Unidade de dado
Fundamental

A unidade básica de dado que flui entre os nodes. Cada node recebe um array de items, processa e passa os items resultantes. Cada item é um objeto JSON com seus campos. Um node pode receber 1 item ou 100 — e processar cada um individualmente (modo padrão) ou todos de uma vez.

💡 Exemplo
Um Google Sheets node que lê 50 linhas retorna 50 items. Cada item tem os campos das colunas: {"nome": "Maria", "email": "maria@email.com", "cidade": "São Paulo"}. O próximo node processará cada um dos 50 items em sequência.
Expression/ Expressão dinâmica
Essencial

Sintaxe que permite referenciar dados de nodes anteriores dinamicamente dentro das configurações de qualquer campo. As expressões ficam entre {{ }} e usam variáveis especiais do n8n. São como fórmulas — em vez de digitar um valor fixo, você referencia o valor dinâmico de um item.

💡 Variáveis mais usadas
{{ $json.campo }} — acessa campo do item atual
{{ $('NomeDoNode').item.json.campo }} — acessa dado de node específico
{{ $now.toISO() }} — data/hora atual em ISO
{{ $runIndex }} — índice da iteração atual no loop
Pin Data/ Dados fixados
Desenvolvimento

Funcionalidade que permite "fixar" dados de saída em um node durante o desenvolvimento, fazendo com que o node sempre retorne aqueles dados específicos nas próximas execuções de teste — sem precisar chamar a API real. Essencial para desenvolver e testar nodes subsequentes sem gerar chamadas de API repetidas.

Binary Data/ Dado binário
Arquivos

Representa arquivos binários (imagens, PDFs, planilhas, áudio) que fluem entre nodes — diferente de dados JSON que são texto. Nodes como HTTP Request, Google Drive e Read/Write Files trabalham com Binary Data. O campo binário aparece no item ao lado do JSON, identificado por um ícone de arquivo.

🔀 Lógica e Controle de Fluxo Core Nodes
IF Node/ Se / Condicional
Lógica

Node que avalia uma condição e divide o fluxo em dois caminhos: True (se a condição for verdadeira) e False (se for falsa). Ideal para tomar decisões simples de duas vias — se o valor for X, faça A; caso contrário, faça B.

💡 Exemplo
Se o campo status do lead for "qualificado" → envia para o time de vendas (True). Se não → adiciona em lista de nutrição (False).
Switch Node/ Seletor múltiplo
Lógica

Node mais avançado que o IF — divide o fluxo em múltiplos caminhos com base no valor de uma expressão. Cada "saída" corresponde a um valor possível. Ideal quando há mais de duas opções para rotear os dados.

💡 Diferença para o IF
IF: dois caminhos (True/False). Switch: N caminhos — ex: Lead de SP → fluxo 1; Lead do RJ → fluxo 2; Lead de MG → fluxo 3; Outros → fluxo padrão.
Loop Over Items/ Loop / Repetição
Lógica

Node que processa items em lotes (batches), em vez de todos de uma vez. Útil quando a API que você está chamando tem limite de requisições por segundo — o Loop permite processar X items por vez, com intervalo entre os lotes. Também útil para acumular resultados de múltiplas iterações.

Merge Node/ Mesclagem
Lógica

Node que combina dados de múltiplos fluxos paralelos em um único output. Suporta diferentes modos: Append (concatena todos os items), Combine (une items por posição ou por campo-chave), Wait (aguarda todos os fluxos chegarem antes de continuar). Essencial em workflows com branches paralelos.

Filter Node/ Filtro
Transformação

Mantém apenas os items que satisfazem uma ou mais condições, descartando os demais. Diferente do IF (que direciona os dois grupos), o Filter simplesmente remove os items que não passam na condição e continua apenas com os que passam.

Wait Node/ Espera
Controle

Pausa a execução do workflow por um tempo definido ou até receber uma chamada externa (webhook de retomada). Casos de uso: aguardar processamento de uma API, criar delay entre mensagens de uma sequência de WhatsApp, ou implementar um fluxo de aprovação onde um humano precisa confirmar antes de continuar.

🔌 Integrações e Autenticação 400+ integrações
Credential/ Credencial
Segurança

Informações de autenticação armazenadas de forma segura e criptografada no n8n para acessar serviços externos — chaves de API, tokens OAuth, usuário e senha, certificados. São criadas uma única vez em Settings → Credentials e reutilizadas em múltiplos workflows sem precisar redigitar.

⚠️ Boa prática
Nunca cole uma chave de API diretamente no campo de um node. Crie sempre uma Credential — assim ela fica criptografada, auditada e pode ser revogada sem precisar editar todos os workflows que a usam.
HTTP Request Node/ Requisição HTTP
Universal

O node mais versátil do n8n — faz qualquer chamada HTTP (GET, POST, PUT, DELETE, PATCH) para qualquer API REST. Quando não existe um node nativo para o serviço que você precisa integrar, o HTTP Request resolve. Suporta headers customizados, body em JSON/Form-data, autenticação Bearer e OAuth.

OAuth 2.0/ Autenticação OAuth
Autenticação

Padrão de autenticação usado por Google, Meta, Microsoft, Slack e a maioria dos serviços modernos. No n8n, você cria uma Credential do tipo OAuth 2.0, clica em "Connect" e é redirecionado para a tela de autorização do serviço — sem precisar copiar tokens manualmente. O n8n gerencia automaticamente a renovação dos tokens.

💻 Código e Transformação Avançada JavaScript / Python
Code Node/ Nó de código
Avançado

Node que permite escrever código JavaScript ou Python diretamente no workflow para transformações complexas, cálculos ou lógica que os nodes visuais não cobrem. O código tem acesso aos items de entrada ($input.all()), pode criar novos items e retorná-los para o próximo node.

Code Node — Exemplo: formatar número de telefoneJavaScript
// Processar todos os items recebidos
for (const item of $input.all()) {
  let phone = item.json.telefone.replace(/\D/g, '');
  // Adicionar +55 se não tiver código do país
  if (!phone.startsWith('55')) phone = '55' + phone;
  item.json.telefone_formatado = '+' + phone;
}
return $input.all();
Set Node/ Definir campos
Transformação

Node que cria, renomeia ou remove campos em um item. Permite adicionar campos calculados, renomear campos para compatibilidade com outra API, ou limpar campos desnecessários. É o node de transformação mais usado no dia a dia — junto com o HTTP Request, aparece em quase todo workflow.

Sub-workflow/ Fluxo filho
Modularidade

Técnica de chamar um workflow dentro de outro usando o node Execute Workflow. O workflow chamado é o "sub-workflow" e o que chama é o "workflow pai". Útil para modularizar automações complexas — criar um "workflow de envio de WhatsApp" que é chamado por múltiplos outros workflows sem duplicar a lógica.

Error Workflow/ Fluxo de erro
Resiliência

Um workflow especial designado para receber notificações quando outro workflow falha. Configura-se em Settings → Error Workflow do workflow principal. Quando o workflow falha, o n8n executa o Error Workflow com os detalhes do erro — útil para enviar alertas no WhatsApp ou Telegram quando uma automação crítica quebra.

🤖 IA, Agentes e MCP Novidades 2025–2026
AI Agent/ Agente de IA
IA nativa

Node especial que conecta um Modelo de Linguagem (LLM) com Tools (ferramentas) para criar um agente autônomo. O AI Agent recebe uma instrução em linguagem natural, decide quais ferramentas usar para resolvê-la, executa as ferramentas em sequência e retorna o resultado. O n8n suporta OpenAI, Anthropic (Claude), Google Gemini, Ollama (local) e mais.

💡 Exemplo
"Verifique se temos reunião amanhã e, se sim, envie um WhatsApp de lembrete para o cliente" → o AI Agent usa o Google Calendar Tool (busca a agenda) e o WhatsApp Tool (envia a mensagem) de forma autônoma.
Tool/ Ferramenta do agente
IA nativa

Uma capacidade que o AI Agent pode usar para executar ações no mundo real. Cada Tool é um node de conexão AI que expõe uma função ao agente — buscar no Google Calendar, enviar mensagem, fazer uma consulta SQL, chamar uma API HTTP. O agente decide quando e como usar cada tool com base na instrução recebida.

Memory/ Memória do agente
IA nativa

Componente que persiste o histórico de conversa para o AI Agent entre mensagens ou sessões. Sem Memory, cada execução começa sem contexto — o agente "esquece" tudo. Com Memory, o agente mantém o histórico da conversa. Tipos disponíveis: Window Buffer Memory (últimas N mensagens), Postgres Chat Memory (histórico em banco de dados) e outros.

MCP (Model Context Protocol)/ Protocolo de contexto
2025–2026

Protocolo criado pela Anthropic (open-source) que padroniza como aplicações externas fornecem contexto e ferramentas para modelos de IA. O n8n suportou MCP nativamente em 2025, permitindo que o n8n atue como cliente MCP (consome ferramentas de servidores MCP externos) ou como servidor MCP (expõe seus workflows como ferramentas para outros agentes de IA). Simplifica enormemente a integração de agentes com sistemas externos.

Chat Hub/ Hub de conversas
v2.0 — 2025

Funcionalidade lançada no n8n v2.0 (dezembro de 2025) que permite criar interfaces de chat diretamente no n8n para testar e usar agentes de IA. Suporta modelos OpenAI, Google Gemini e Llama. Elimina a necessidade de criar uma interface externa apenas para interagir com o agente durante o desenvolvimento.

🖥️ Modos de Hospedagem Cloud vs Self-hosted
Self-hosted/ Auto-hospedado
Infraestrutura

Modalidade onde você instala e gerencia o n8n no seu próprio servidor (VPS, servidor dedicado, Docker). Vantagens: custo previsível (paga pela infraestrutura, não por execução), controle total sobre dados, sem limite de execuções, permite Community Nodes e customizações avançadas. Requer conhecimento básico de servidor.

n8n Cloud/ Nuvem oficial
Infraestrutura

Modalidade SaaS gerenciada pela própria equipe do n8n. Cobrança por execução mensal (não por número de steps dentro do workflow). Vantagens: zero configuração de servidor, atualizações automáticas, suporte oficial. Planos a partir de 2.500 execuções/mês. Ideal para iniciar sem operações de DevOps.

Environment Variables/ Variáveis de ambiente
Configuração

Variáveis configuradas no servidor (ou no arquivo .env do Docker) que controlam o comportamento do n8n — URL base, porta, banco de dados, chave de criptografia, modo de execução. Diferente das Credentials (que são por serviço), as variáveis de ambiente definem a configuração global da instância.

Encryption Key/ Chave de criptografia
Segurança

Chave usada pelo n8n para criptografar as credentials armazenadas no banco de dados. Definida pela variável de ambiente N8N_ENCRYPTION_KEY. Nunca perca essa chave — se perder, todas as credentials ficam inacessíveis e precisam ser reconfiguradas. Guarde em local seguro (cofre de senhas, AWS Secrets Manager).


Perguntas frequentes (FAQ)

O que é um workflow no n8n?

Um workflow no n8n é uma sequência de nodes conectados visualmente que formam uma automação completa. Começa com um trigger, passa por nodes de ação e transformação, e termina com uma saída. Pode estar ativo (roda automaticamente) ou inativo (só executa manualmente). A partir do n8n v2.0, workflows têm o modelo Save & Publish que separa rascunho da versão em produção.

O que é um node no n8n?

Um node é o bloco fundamental de construção de automações no n8n. Cada node representa uma ação — buscar dados, enviar mensagem, aplicar lógica, transformar dados. Existem Trigger Nodes (iniciam workflows), Action Nodes (executam ações em serviços externos) e Core Nodes (lógica e transformações). O n8n tem mais de 400 nodes nativos mais os Community Nodes.

Qual a diferença entre Trigger e Webhook no n8n?

Trigger é o termo genérico para qualquer node que inicia um workflow. Webhook é um tipo específico de trigger que expõe uma URL pública — quando um sistema externo envia dados para essa URL, o workflow dispara. Todo Webhook é um Trigger, mas nem todo Trigger é um Webhook (o Schedule Trigger, por exemplo, é acionado por horário, não por HTTP).

O que são items no n8n?

Items são as unidades de dado que fluem entre os nodes. Cada node recebe um array de items (cada um é um objeto JSON), processa e passa os resultantes para o próximo. Um Google Sheets que lê 50 linhas retorna 50 items. Entender como items funcionam — especialmente em loops e merges — é essencial para workflows avançados.

Como funciona uma expression no n8n?

Uma expression usa a sintaxe {{ }} para referenciar dados dinamicamente. {{ $json.campo }} acessa o campo do item atual; {{ $('NomeDoNode').item.json.campo }} acessa dados de um node específico; {{ $now.toISO() }} retorna a data atual. Expressions permitem criar campos dinâmicos sem precisar de código completo no Code Node.

O que é o AI Agent no n8n?

O AI Agent é um node que conecta um LLM (GPT, Claude, Gemini) com Tools (ferramentas) para criar um agente autônomo. Ele recebe instruções em linguagem natural, decide quais ferramentas usar, executa-as em sequência e retorna o resultado. As Tools são nodes que expõem funções ao agente — busca no Google Calendar, envio de WhatsApp, consulta SQL, chamadas de API.

O vocabulário é o primeiro passo — a prática é o segundo

Com este glossário, você tem um dicionário de referência para consultar sempre que encontrar um termo desconhecido ao construir automações no n8n. Guarde este link ou salve a página.

O próximo passo é colocar em prática: abra o n8n, crie um workflow com um Webhook Trigger, conecte um Set Node, um IF Node e um HTTP Request — e experimente cada conceito que você acabou de aprender.

Gostou do conteúdo? Compartilhe com quem está começando no n8n! ⚙️

Ler no siteTodos os artigos