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.
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.
- Estrutura e interface do n8n
- Nodes: os blocos de construção
- Triggers: como workflows iniciam
- Execução e ciclo de vida
- Dados: items, JSON e expressões
- Lógica e controle de fluxo
- Integrações e autenticação
- Código e transformação avançada
- IA, Agentes e MCP (novidades 2025–2026)
- Modos de hospedagem
- Recursos da Expert Digital
- FAQ — perguntas frequentes
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).
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.
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).
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.
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.
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).
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.
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.
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).
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.
https://n8n.suaempresa.com/webhook/novo-lead — o workflow dispara automaticamente com nome, e-mail e telefone do lead como items de entrada.
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).
0 8 * * *
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.
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.
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.
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.
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.
{"nome": "Maria", "email": "maria@email.com", "cidade": "São Paulo"}. O próximo node processará cada um dos 50 items em sequência.
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.
{{ $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
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.
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.
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.
status do lead for "qualificado" → envia para o time de vendas (True). Se não → adiciona em lista de nutrição (False).
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.
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.
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.
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.
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.
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.
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.
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.
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.
// 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();
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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).
Com o glossário em mãos, o próximo passo é colocar esses conceitos em prática. A Expert Digital tem os recursos certos para cada estágio:
Curso n8n na Prática — Expert Digital
Agora que você conhece o vocabulário, aprenda a construir workflows reais do zero. O Curso n8n na Prática da Expert Digital cobre nodes essenciais, webhooks, Google Sheets, WhatsApp via API, AI Agent com OpenAI e Anthropic, memória persistente e automações completas para marketing digital e atendimento — sem precisar programar.
→ Acessar o curso completo de automações com n8nImersão IA e Automações — Expert Digital
O n8n é uma das ferramentas centrais da Imersão IA e Automações da Expert Digital. Você aprende a criar agentes de IA com AI Agent, Memory e Tools, integrar com ChatGPT e Claude, construir chatbots no WhatsApp e automatizar fluxos completos de geração de leads — tudo presencialmente com casos reais.
→ Ver próximas turmas presenciais e datasArtigo: 10 Formas de Rastrear se os Leads Vêm do Tráfego Pago
O n8n é a ferramenta perfeita para o Método 10 desse artigo — automação completa de rastreamento de origem de leads. Veja como usar webhooks, o nó HTTP Request e o nó Set para capturar UTMs, registrar no CRM e notificar a equipe de vendas automaticamente a cada novo lead.
→ Ler o guia completo de rastreamento de leadsPerguntas 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! ⚙️