MÓDULO 2.3

🔧 n8n na Prática

Hands-on. Você sai com 1 fluxo n8n funcionando que gera valor mensurável. A ferramenta favorita do Nei pra começar.

"Automação que não roda em produção é só PowerPoint."— princípio prático
6
Tópicos
~60
Minutos
Prático
Nível
Hands-on
Tipo
1

🔧 O que é n8n

n8n é uma ferramenta open-source de automação visual. Você arrasta blocos (nodes) que conversam com APIs, IA, planilhas, e-mails, bancos de dados — e conecta com setinhas. Pode rodar self-hosted (servidor próprio, custo < R$30/mês) ou na nuvem deles (a partir de US$20/mês). Hoje é uma das skills mais demandadas do mercado de automação BR.

⚡ Por que n8n e não Zapier/Make

  • Open-source: self-host = custo previsível, zero limite por execução.
  • Nodes nativos de IA: OpenAI, Claude, Gemini, agentes — tudo pronto.
  • JavaScript embutido: quando o node não basta, você escreve 3 linhas e resolve.
  • Mercado BR: demanda explodindo, agências cobram R$5-30k por implementação.
2

🧱 Anatomia de um workflow

Todo fluxo n8n (e, na real, toda automação) tem três peças: trigger (o que dispara), nodes (o que processa) e output (onde a coisa pousa). Esse modelo mental serve pra Zapier, Make, scripts Python ou agente de IA — uma vez aprendido, só muda a sintaxe.

1

Trigger (gatilho)

O que faz o fluxo começar. Tipos comuns: webhook (URL recebe POST), schedule (cron — toda terça às 9h), evento de app (novo e-mail, novo lead).

2

Nodes (processamento)

Cada bloco faz uma coisa: chama IA, busca dado, faz IF, transforma, junta arrays. Output de um vira input do próximo.

3

Output (destino)

Onde o resultado pousa: planilha, Slack, e-mail, CRM, banco. Se não tem destino útil, é demo, não automação.

3

🎯 Escolhendo a primeira automação

A pior decisão é começar pelo fluxo errado. Critério: repetitivo, semanal+, mensurável e reversível. Multiplique frequência × valor por execução — quanto maior o produto, melhor o ROI. E comece por algo reversível: se quebrar, ninguém perde dinheiro.

✓ Bons primeiros candidatos

  • Resumo diário de e-mails / WhatsApp Business
  • Pré-qualificação de leads (form → IA → planilha)
  • Geração de conteúdo (briefing → IA → rascunho no Notion)
  • Relatórios semanais automáticos (dados → IA → PDF/Slack)

✗ Evite no primeiro fluxo

  • Pagamentos / financeiro (irreversível)
  • Disparo em massa pra cliente (risco de spam)
  • Coisas anuais (você nunca testa)
  • Fluxos de 30+ nodes (debugar é inferno)
4

🏗️ Construindo passo a passo

Walkthrough do seu primeiro fluxo: resumo diário do que importa na sua caixa de entrada via IA. Pra fazer agora.

1

Criar conta n8n

n8n.cloud (trial grátis 14 dias) ou self-host (Coolify/Railway/Hetzner por R$20-50/mês).

2

Novo workflow

"+ New Workflow". Dê um nome com data: "2026-05 — Resumo de inbox v1".

3

Trigger: Schedule

Adicione node "Schedule Trigger". Configure pra rodar todo dia às 8h.

4

Buscar e-mails

Adicione node Gmail (ou IMAP). Filtro: últimas 24h, não lidos. Conecte ao Schedule.

5

Node IA

Adicione "OpenAI" ou "Anthropic". Prompt: "Resuma esses e-mails em até 5 bullets, marcando o que exige resposta minha."

6

Output: WhatsApp ou Slack

Adicione node WhatsApp (via Z-API) ou Slack. Manda o resumo pra você. Teste manual com "Execute Workflow", depois ative.

💡 Atalho realista

Não tente buildar do zero. Pegue templates da galeria n8n (n8n.io/workflows), copie um parecido com seu caso, customize. Aprende-se 10x mais rápido modificando do que criando.

5

🧪 Testando, debugando, observando

90% dos fluxos quebram em produção por edge cases — e-mail vazio, JSON malformado, API fora do ar. Aprenda 3 disciplinas: testar com casos reais, ler logs, configurar retry e error workflow.

🐛 5 erros mais comuns

  • 1. Campo vazio — IA volta string nula, próximo node quebra. Use IF antes pra checar.
  • 2. Rate limit — você dispara 200 reqs em 1s na API. Use SplitInBatches + wait.
  • 3. Credencial expirada — token OAuth caduca. Configure renovação ou notificação.
  • 4. Loop infinito — fluxo dispara ele mesmo via webhook. Sempre teste com flag de execução única.
  • 5. Sem timezone — Schedule roda em UTC, você pensou em Brasília. Confira fuso.

✓ Disciplina de produção

  • Testar com 10+ casos reais antes de ativar
  • Configurar Error Workflow (avisa no Slack quando quebra)
  • Retry: 3 tentativas com 30s de espera

✗ Não faça

  • Ativar sem testar caso real
  • Confiar em "happy path" — sempre tem caso esquisito
  • Editar fluxo em produção sem versionar
6

📈 Medindo o valor

Automação sem métrica é hobby. Tempo economizado × frequência × valor da hora = ROI. E não é só pra você — esse mesmo cálculo vira arma de venda: na próxima reunião com cliente, você abre uma planilha mostrando "essa automação economiza 12h/mês a R$200/h = R$2.400/mês — e custo R$1.500/mês de mensalidade".

🧮 Fórmula básica de ROI

Pegue qualquer fluxo. Aplique:

  • Tempo manual: minutos pra fazer 1x sem automação
  • Frequência: quantas vezes por mês isso roda
  • Valor da hora: sua hora ou da pessoa que faria (R$50-300+)
  • Economia mensal = (minutos ÷ 60) × frequência × valor da hora
  • ROI = economia ÷ custo de operar fluxo (geralmente > 10x).

💡 Hábito do operador

Toda quinta-feira, abra o n8n e veja: quantas execuções rodaram? Quanto tempo economizei? Anota num doc. Em 90 dias você tem case study real pra vender o próximo cliente.

🎯 Resumo do Módulo

n8n é open-source visual — self-host barato, nodes IA nativos, JS embutido.
Trigger → Nodes → Output — modelo mental que serve pra qualquer ferramenta.
Primeira automação: repetitiva e reversível — frequência × valor. Não comece por pagamento.
Build copiando templates — galeria n8n.io/workflows, customize, aprende 10x mais rápido.
5 erros clássicos — campo vazio, rate limit, credencial, loop, timezone.
ROI = (min ÷ 60) × freq × R$/h — vira métrica pessoal e arma de venda.

Próximo Módulo:

2.4 — Stack econômica do solo: o que comprar agora, o que esperar.