Se você sabe ligar peças de Lego, você consegue montar uma automação no n8n. Cada bloco faz uma coisa; o programa nasce de como você os encaixa.
O que você vai conseguir fazer ao final
Subir o n8n no seu computador (sem instalar nada permanente) ou usar a versão na nuvem.
Montar um fluxo que dispara, busca dados de uma API pública na internet e mostra o resultado.
Passar e transformar dados de um bloco para o outro usando expressions.
Entender onde a Inteligência Artificial entra na automação.
🧩 O que é o n8n (e por que ele existe)
O n8n (lê-se “n-eight-n”, de nodemation = node + automation; o “8” são as oito letras entre o primeiro e o último “n”) é uma plataforma para criar automações arrastando blocos numa tela, em vez de escrever um programa do zero.
A ideia central é a mesma de peças de Lego: cada bloco (chamado node) faz uma tarefa pequena e bem definida (ler um e-mail, chamar uma API, salvar numa planilha). Você conecta os blocos com fios, e o fluxo de dados percorre essa “tubulação” do início ao fim.
Por que não usar logo o Zapier ou o Make?
Zapier e Make são ótimos, mas são fechados e cobram por execução. O n8n é a alternativa open source: você pode ver o código, modificar e, principalmente, rodar no seu próprio servidor de graça. Para quem estuda, isso é ouro: dá pra experimentar sem limite de tarefas e sem cartão de crédito.
Licença fair-code
O n8n não é “open source clássico”, e sim fair-code: o código é aberto, você pode ver, alterar e auto-hospedar livremente. As restrições só aparecem em cenários comerciais específicos (revender o n8n como serviço). Para uso pessoal, estudo e automações internas, é livre.
Aspecto
n8n
Zapier / Make
Código
Aberto (fair-code)
Fechado
Onde roda
Sua máquina, seu servidor ou nuvem deles
Só na nuvem deles
Custo self-host
Grátis (paga só o servidor)
Não existe self-host
Cobrança na nuvem
Por execução de workflow
Por tarefa/operação
Nós de IA nativos
Sim (AI Agent, LLM Chain)
Limitado / via integração
Aprendizado
Visual, mas permite código (JavaScript)
Visual
🔌 Anatomia de um Workflow: Nodes e Conexões
Um workflow (fluxo de trabalho) é o nome do projeto inteiro que você monta na tela. Ele é feito de nodes ligados por fios. Os dados entram por um lado, são processados, e saem pelo outro.
flowchart LR
A([⚡ Trigger\no que inicia tudo]) --> B[🧱 Node de ação\nbusca dados]
B --> C[🧱 Node de ação\ntransforma dados]
C --> D[🧱 Node de ação\nentrega resultado]
style A fill:#FF6D5A,color:#fff,stroke:#c0392b
style B fill:#4A90D9,color:#fff,stroke:#2c5f8a
style C fill:#9B59B6,color:#fff,stroke:#6c3483
style D fill:#2ECC71,color:#fff,stroke:#1a8a4a
A regra de ouro do n8n
Todo workflow começa com um node de gatilho (trigger). Sem um gatilho, o n8n não sabe quando rodar o fluxo. Depois do trigger vêm os nodes de ação, executados em sequência, sempre da esquerda para a direita.
Os dois grandes tipos de node
mindmap
root((Nodes do n8n))
Triggers
Manual
Webhook
Schedule / Cron
App específico (novo e-mail, novo lead)
Ação / Regular
HTTP Request (chama qualquer API)
Set / Edit Fields (define e arruma dados)
IF (decisão: caminho A ou B)
Code (JavaScript quando precisa)
App específico (Slack, Google Sheets, Telegram)
Nós de IA
AI Agent (raciocina e usa ferramentas)
Basic LLM Chain (pergunta e resposta)
Chat Model (OpenAI, Anthropic, Ollama)
Memory (lembra a conversa)
Mais de 400 integrações prontas
O n8n traz mais de 400 nodes prontos para serviços famosos (Gmail, Slack, Notion, Telegram, Google Sheets, OpenAI…). E quando não existe um node pronto, o HTTP Request salva: ele conversa com qualquer sistema que tenha uma API. É o “node coringa”.
⚡ Triggers: o que dá a partida no fluxo
O trigger é sempre o primeiro node. Ele define o evento que coloca o workflow para rodar. Os três que você mais vai usar no começo:
Trigger
Quando dispara
Exemplo de uso
Manual Trigger
Quando você clica em “Execute Workflow” na tela
Testar e depurar enquanto monta
Webhook
Quando chega uma requisição HTTP de fora
Um formulário do site avisa o n8n que alguém se inscreveu
Schedule (Cron)
Em horários/intervalos definidos
Todo dia às 8h, buscar a previsão do tempo e te avisar
O Schedule é um "cron" visual
O Schedule Trigger funciona como o cron do Linux: roda a cada N minutos/horas, todo dia num horário, semanalmente, ou via uma expressão cron customizada. Uma expressão cron tem 5 campos: (minuto) (hora) (dia do mês) (mês) (dia da semana). Por exemplo, 0 8 * * * significa “todo dia às 08:00”. A ferramenta crontab.guru ajuda a montar essas expressões.
Por que o Manual Trigger é seu melhor amigo no começo
Enquanto você está construindo, não dá pra ficar esperando um e-mail chegar a cada teste. O Manual Trigger te deixa rodar o fluxo na hora, ver o que cada node devolveu, ajustar e rodar de novo. Só troque por Webhook ou Schedule quando a automação estiver pronta.
📦 Como os dados andam entre os nodes
Aqui está o coração do n8n. Cada node recebe dados do node anterior, faz seu trabalho, e entrega dados para o próximo. Esses dados trafegam em formato JSON (a mesma estrutura de “chave: valor” que você vê em APIs).
flowchart LR
A[HTTP Request\nbuscou da API] -->|"{ cidade: 'Campos',\n temp: 28 }"| B[Set / Edit Fields\nmonta a frase]
B -->|"{ msg: 'Em Campos\n faz 28°C' }"| C[Resultado final]
style A fill:#4A90D9,color:#fff,stroke:#2c5f8a
style B fill:#9B59B6,color:#fff,stroke:#6c3483
style C fill:#2ECC71,color:#fff,stroke:#1a8a4a
Expressions: pegar e transformar o dado do node anterior
Para usar um dado que veio de antes, o n8n tem as expressions: trechos escritos entre chaves duplas {{ }}. Dentro delas, $json significa “o dado que chegou neste node”.
Expression
O que faz
{{ $json.cidade }}
Pega o campo cidade do dado que chegou
{{ $json.temp }}
Pega o campo temp (a temperatura)
{{ $json.nome.toUpperCase() }}
Pega o nome e deixa MAIÚSCULO
{{ $json.temp > 30 ? "calor" : "ameno" }}
Decide o texto conforme a temperatura
{{ $node["HTTP Request"].json.cidade }}
Pega um campo de um node específico pelo nome
A grande sacada
As expressions são o que diferencia “ligar blocos” de programar de verdade. Com {{ }} você reaproveita, combina e transforma dados de qualquer node anterior. É o mesmo raciocínio de variáveis e operadores que você já viu em Conceitos gerais de programação, só que dentro da automação.
Onde a API entra
Quando o HTTP Request chama um serviço externo, ele está usando uma API (a “ponte” entre sistemas que você estudou). A resposta volta em JSON e vira o $json do próximo node. Toda automação interessante é, no fundo, “buscar dado de um lugar, transformar, e entregar em outro”.
🧪 Atividade 1: Subir o n8n e rodar seu primeiro fluxo
🧪 Atividade 1: "Olá, n8n" com Manual Trigger
Objetivo: colocar o n8n no ar e executar um workflow do zero.
Opção A, Local com npx (recomendada, não instala nada permanente):
Tenha o Node.js instalado. No terminal, rode:
npx n8n
Aguarde o download (na 1ª vez demora 1-2 min). Quando aparecer a mensagem de “Editor is now accessible”, abra no navegador:
http://localhost:5678
Crie a conta de dono (tela “Set up owner account”) com qualquer e-mail/senha. É local, fica só na sua máquina.
Opção B, Local com Docker (se você já usa Docker):
Depois abra http://localhost:5678 igual à Opção A.
Opção C, n8n Cloud (zero instalação): crie um trial grátis em n8n.io e use direto no navegador.
Montando o fluxo:
Clique em “Add first step” → escolha Manual Trigger (ou “Trigger manually”).
Clique no + ao lado do trigger → procure o node “Edit Fields (Set)” e adicione.
No node Set, crie um campo: nome mensagem, valor Meu primeiro fluxo no n8n.
Clique em “Execute Workflow” (botão no rodapé).
Resultado observável: o trigger e o node Set ficam com um ✓ verde. Clicando no node Set, o painel da direita mostra o JSON de saída:
{ "mensagem": "Meu primeiro fluxo no n8n" }
Entregável: print da tela mostrando os dois nodes verdes e o JSON { "mensagem": ... } na saída.
🌐 Conectando o mundo: chamando uma API pública
Um fluxo só fica útil quando ele conversa com outros sistemas. O node HTTP Request faz exatamente isso: manda uma requisição para um endereço (URL) e recebe a resposta. Vamos usar APIs públicas e gratuitas (sem cadastro):
API pública
URL
Devolve
Piada aleatória
https://official-joke-api.appspot.com/random_joke
Uma piada (setup + punchline)
CEP (ViaCEP)
https://viacep.com.br/ws/01001000/json/
Endereço de um CEP brasileiro
Previsão do tempo
https://wttr.in/Campos?format=j1
Clima da cidade em JSON
flowchart LR
A([⚡ Manual Trigger]) --> B[🌐 HTTP Request\nGET na API pública]
B --> C[✨ Set / Edit Fields\nmonta a frase com expression]
C --> D[👀 Resultado na tela]
style A fill:#FF6D5A,color:#fff,stroke:#c0392b
style B fill:#4A90D9,color:#fff,stroke:#2c5f8a
style C fill:#9B59B6,color:#fff,stroke:#6c3483
style D fill:#2ECC71,color:#fff,stroke:#1a8a4a
🧪 Atividade 2: Buscar dados reais de uma API e formatar
Objetivo: fazer o fluxo buscar um dado da internet e transformá-lo com uma expression.
Passo a passo:
Reaproveite o fluxo da Atividade 1 (Manual Trigger já no lugar).
Adicione um node HTTP Request depois do trigger. Configure:
Method:GET
URL:https://viacep.com.br/ws/01001000/json/
Clique em “Execute step” só nesse node. Veja no painel direito o JSON retornado (vai ter logradouro, bairro, localidade, uf…).
Adicione um node Edit Fields (Set) depois do HTTP Request. Crie um campo:
Nome: endereco_formatado
Valor (ligue o modo expression, ícone de engrenagem/fx):
Resultado observável: o node Set devolve algo como:
{ "endereco_formatado": "Praça da Sé, Sé - São Paulo/SP" }
Você acabou de buscar um dado real da internet e transformá-lo sem escrever um programa.
Desafio extra: troque a URL para https://official-joke-api.appspot.com/random_joke e monte uma expression que junte a piada: {{ $json.setup }} ... {{ $json.punchline }}. Rode 3 vezes e veja a piada mudar.
📡 Webhook: deixando o mundo de fora chamar seu fluxo
Até agora você apertava o botão. Com o Webhook, é um sistema externo que dispara o fluxo, mandando uma requisição HTTP para um endereço que o n8n cria pra você. É assim que “um formulário avisa o n8n”, “um pagamento dispara um e-mail”, etc.
🧪 Atividade 3: Disparar o fluxo de fora com um Webhook
Objetivo: criar um endereço (URL) que, ao ser chamado, executa o seu workflow e devolve os dados recebidos.
Passo a passo:
Crie um novo workflow. Adicione o trigger Webhook.
No node Webhook, deixe Method = GET e copie a “Test URL” que ele mostra (algo como http://localhost:5678/webhook-test/abc-123).
Adicione depois um node Edit Fields (Set) com um campo recebido e valor (expression):
{{ $json.query.nome }}
Clique em “Listen for test event” (o Webhook fica esperando).
Em outro terminal, dispare a chamada com curl (substitua pela sua URL):
Resultado observável: assim que o curl roda, o n8n acorda: os nodes ficam verdes e o node Set mostra { "recebido": "Wesley" }. O terminal do curl recebe a resposta do fluxo. Você criou um “endereço de internet” que executa sua automação.
Entregável: print da tela do n8n com os nodes verdes + o comando curl que você usou.
🤖 Nós de IA: quando a automação “pensa”
Aqui está o motivo de o n8n ter explodido em popularidade. Além de mover dados, ele consegue chamar modelos de linguagem (LLMs) como ChatGPT (OpenAI) ou Claude (Anthropic) dentro do fluxo. Há dois níveis:
flowchart TD
subgraph SIMPLES["🔹 Basic LLM Chain (pergunta → resposta)"]
A1([Trigger]) --> A2[Basic LLM Chain]
A2 --> A3[Resposta do modelo]
end
subgraph AGENTE["🔸 AI Agent (raciocina e age)"]
B1([Trigger]) --> B2{{🧠 AI Agent}}
B3[💬 Chat Model\nOpenAI / Claude] --> B2
B4[🧰 Tools\nbuscar na web, chamar API] --> B2
B5[📒 Memory\nlembra a conversa] --> B2
B2 --> B6[Ação inteligente]
end
style A2 fill:#E8A838,color:#fff,stroke:#b07a1a
style B2 fill:#9B59B6,color:#fff,stroke:#6c3483
style B3 fill:#4A90D9,color:#fff,stroke:#2c5f8a
style B4 fill:#5BAD6F,color:#fff,stroke:#3a7a4a
style B5 fill:#FF6D5A,color:#fff,stroke:#c0392b
Basic LLM Chain vs AI Agent
Basic LLM Chain: o mais simples. Você manda um texto, o modelo responde, e a resposta segue para o próximo node. Sem memória, sem ferramentas. Ótimo para “resumir este e-mail” ou “classificar este comentário”.
AI Agent: o modelo vira um agente que raciocina em vários passos. Ele junta quatro peças: um Chat Model (o cérebro), um system prompt (as instruções), Memory (lembra o que já foi dito) e Tools (ações que ele pode executar, como buscar na web ou chamar uma API). O agente decide sozinho qual ferramenta usar para cumprir a tarefa.
Encadear LLM = ligar blocos de IA
No n8n, “usar IA” é o mesmo gesto de sempre: você conecta um Chat Model (OpenAI, Anthropic, ou até um modelo local via Ollama) ao node de IA, como quem encaixa mais uma peça de Lego. Em 2026, um recurso comum é o roteamento de modelos: perguntas simples vão para um modelo barato e rápido; tarefas complexas vão para um modelo mais poderoso, economizando custo.
IA precisa de chave de API (e isso pode custar)
Para o node de IA funcionar, você precisa de uma credencial (API key) do provedor (OpenAI, Anthropic…). Esses serviços cobram por uso. Existem trials gratuitos e modelos locais (Ollama) sem custo. Como esta atividade pode gerar cobrança, ela é opcional e depende de você já ter acesso a uma chave.
🧪 Atividade 4 (opcional, requer API key): Fluxo com IA
Objetivo: fazer o fluxo enviar um texto para um LLM e receber a resposta.
Pré-requisito: ter uma API key de algum provedor (OpenAI/Anthropic) ou o Ollama rodando local com um modelo baixado (ex.: ollama run llama3).
Passo a passo:
Novo workflow → Manual Trigger.
Adicione o node Basic LLM Chain.
Conecte um Chat Model ao Chain (clique no + da entrada “Chat Model” do node) e escolha o provedor; cole sua credencial (ou aponte para o Ollama local).
No campo de prompt do Chain, escreva: Explique o que é o n8n em uma frase para um aluno do ensino médio.
Clique em “Execute Workflow”.
Resultado observável: o node Basic LLM Chain fica verde e o painel da direita mostra a resposta gerada pelo modelo em texto. Você acabou de colocar uma IA dentro de uma automação.
Variação: ligue a saída desse node a um node Edit Fields com a expression {{ $json.text }} para isolar só a resposta.
🏠 Onde rodar: Self-Host (npx/Docker) vs n8n Cloud
Você pode rodar o n8n de dois jeitos. Os dois têm as mesmas funcionalidades; a diferença é quem cuida do servidor.
flowchart TD
Q{Como quero rodar?}
Q -->|Quero controle total\ne custo baixo| SH[🏠 Self-Host]
Q -->|Não quero cuidar\nde servidor| CL[☁️ n8n Cloud]
SH --> SH1["npx n8n\n(testar rápido, local)"]
SH --> SH2["Docker\n(rodar 24/7 no servidor)"]
SH --> SH3["Grátis\n(paga só o servidor ~US$5/mês)"]
CL --> CL1["Pronto em minutos\nno navegador"]
CL --> CL2["A partir de ~€20/mês\n(cobra por execução)"]
CL --> CL3["Trial grátis\npra experimentar"]
style SH fill:#4A90D9,color:#fff,stroke:#2c5f8a
style CL fill:#2ECC71,color:#fff,stroke:#1a8a4a
style Q fill:#E8A838,color:#fff,stroke:#b07a1a
Critério
🏠 Self-Host
☁️ n8n Cloud
Custo
Grátis (paga só o servidor, ~US$5-12/mês)
A partir de ~€20/mês (Starter)
Setup
Você instala (npx ou Docker)
Pronto em minutos
Manutenção
Por sua conta (updates, backup, segurança)
A empresa cuida
Limite de execuções
Só o do seu servidor
Conforme o plano (ex.: 2.500/mês no Starter)
Dados
Ficam na sua máquina
Nos servidores do n8n (EU ou EUA)
Ideal para
Estudo, controle, muitas execuções
Quem não quer mexer com servidor
Para esta disciplina
Use npx n8n (local) para aprender, sem custo e sem compromisso. Quem tem um servidor próprio pode subir via Docker para deixar a automação rodando 24/7. A Cloud vale quando você não quer (ou não pode) administrar um servidor. Atenção: o npx n8n local não é seguro para produção real, só para estudo/teste.
💡 Casos de Uso Reais
O que dá pra automatizar com n8n
Avisos automáticos: novo e-mail importante chega → manda mensagem no Telegram/Slack.
Coleta de dados: todo dia às 8h, busca cotação do dólar/clima → salva numa planilha Google.
Atendimento com IA: mensagem chega no Webhook → AI Agent classifica e responde, ou encaminha para um humano.
Relatórios: toda sexta, reúne dados de várias APIs → IA resume → envia o resumo por e-mail.
Sincronização: lead novo no formulário → atualiza CRM + planilha + notifica a equipe, tudo num fluxo só.
A grande ideia da automação
Quase toda automação útil segue o mesmo desenho que você praticou aqui: um gatilho dispara, busca/recebe dados, transforma com expressions e entrega o resultado em outro lugar. Domine esse esqueleto e você monta praticamente qualquer fluxo. Veja também Automações e a linguagem por trás de tudo isso em Python - principal linguagem.
🧠 Quiz Conceitual (opcional)
Teste seu entendimento
Por que todo workflow do n8n precisa começar com um node de trigger?
Qual a diferença entre o Manual Trigger e o Schedule Trigger? Quando usar cada um?
O que a expression {{ $json.temp > 30 ? "calor" : "ameno" }} faz?
Qual node você usa para falar com qualquer API que não tem um node pronto?
Qual a diferença entre o Basic LLM Chain e o AI Agent?
Cite uma vantagem do self-host e uma vantagem da n8n Cloud.
