🔧 n8n como linguagem visual
n8n não é o sistema — é uma linguagem visual para expressar fluxos de integração. Como Python para scripts, n8n tem seu sweet spot específico: conectar SaaS, processar dados entre serviços, notificar times. Fora disso, vira peso.
⚡ Pontos fortes do n8n
- •600+ integrações nativas — Stripe, HubSpot, Slack, GitHub, Google Sheets, tudo
- •Self-host ou cloud — controle total dos dados, GDPR-friendly
- •Nodes de código — JavaScript ou Python inline quando lógica precisa de mais
- •Webhooks nativos — expose endpoint HTTP em segundos
- •Versão open source — sem lock-in, exporta workflow como JSON
💡 Analogia correta
n8n é para integrações o que SQL é para banco: a linguagem certa para o problema certo. Você não escreve SQL para calcular física newtoniana. Você não usa n8n para lógica de negócio complexa.
🛠️ Make (Integromat) — cloud-only polido
Make é a versão cloud-native, mais polida visualmente e com UI mais acessível para não-técnicos. O preço por operação e o lock-in são os trade-offs. Para times que não querem gerenciar infraestrutura, é uma escolha legítima.
n8n — escolha quando:
- ✓Dados sensíveis (self-host)
- ✓Team técnico, quer versionamento
- ✓Volume alto de execuções
- ✓Personalização avançada
Make — escolha quando:
- ✓Team não-técnico opera os fluxos
- ✓Velocidade sobre controle
- ✓Prototipagem rápida
- ✓Sem servidor para gerenciar
💡 Caso de uso: Sally (CMO)
Sally usa Make para o time de marketing — eles mesmos ajustam os fluxos de lead nurturing sem precisar de Dev. O CFO Marco usa n8n self-hosted para dados financeiros. Dois cenários, duas ferramentas corretas.
🔄 CLI × n8n × LangGraph — quando usar cada
A confusão mais comum é tentar usar uma ferramenta para tudo. Cada uma tem seu sweet spot: CLI para trabalho on-demand, n8n para integrações entre SaaS, LangGraph para orquestração stateful de agentes.
Matriz de decisão
- Claude Code CLI — trabalho criativo, análise, código, escrita. Demanda humana direta. Máximo contexto, máximo controle.
- n8n / Make — integrar Stripe com HubSpot, notificar Slack quando lead entra, transformar dados entre sistemas. Fluxo visual, sem código.
- LangGraph — orquestrar múltiplos agentes com estado, loops condicionais, human-in-the-loop. Quando fluxo tem ramificações complexas.
- Python + SDK direto — controle máximo, batching, evals, casos edge. Quando as outras não chegam lá.
Regra prática
Se envolve dois SaaS trocando dados → n8n/Make. Se envolve agentes tomando decisões → CLI ou LangGraph. Se envolve humano interagindo → CLI. Misturar sem critério é o caminho para o caos.
🌉 Webhook como ponte — Claude Code chama n8n
O maior poder vem da composição: hook do Claude dispara webhook que aciona workflow n8n. O agente faz a decisão inteligente; o n8n faz a integração pesada. Desacoplamento real.
💻 PostToolUse dispara n8n via webhook
#!/bin/bash
# .claude/hooks/post-tool-use.sh
# Quando agente finaliza análise, notifica n8n
TOOL=$(cat /dev/stdin | jq -r '.tool_name')
if [[ "$TOOL" == "Write" ]]; then
FILE=$(cat /dev/stdin | jq -r '.tool_input.path // ""')
# Só dispara para relatórios finais
if echo "$FILE" | grep -q "reports/.*final"; then
curl -s -X POST "https://n8n.empresa.com/webhook/agent-report" \
-H "Content-Type: application/json" \
-d "{\"file\": \"$FILE\", \"agent\": \"cfo-bot\", \"ts\": \"$(date -u +%s)\"}" &
fi
fi
exit 0💡 Padrão assíncrono
Note o & no curl — roda em background. O hook não espera n8n responder. Isso evita timeout e latência no fluxo do agente. n8n processa de forma assíncrona.
🤖 AI nodes em n8n — Anthropic, OpenAI, Ollama
n8n 1.x trouxe uma camada inteira de AI nodes: Anthropic, OpenAI, Gemini, Ollama, plus nodes especializados de Agent, Memory e Tools. Você pode construir agente simples direto no canvas visual — sem uma linha de código.
Stack de AI nodes nativos
- @n8n/n8n-nodes-langchain — pacote completo com todos AI nodes
- AI Agent node — loop ReAct com tools. Define objetivo, seleciona tools automaticamente.
- Chat Memory nodes — Window Buffer, PostgreSQL, Redis. Persiste contexto entre execuções.
- Tool nodes — Calculator, Code, HTTP Request, Wikipedia como tools para o agente.
- Vector Store nodes — Pinecone, Qdrant, Supabase. RAG direto no workflow.
Quando usar vs. Claude Code
n8n AI nodes são ideais para agentes simples, repetitivos, integrados a SaaS. Claude Code CLI é melhor para tarefas criativas, análises profundas, desenvolvimento. A regra: se cabe num workflow visual sem confusão, use n8n.
⚠️ Quando NÃO usar n8n — limites práticos
n8n vira monstro quando ultrapassa seu sweet spot. Lógica condicional profunda, debug difícil, versionamento ruim — são os sinais de que você saiu da linguagem certa para o problema errado.
✗ Sinais de que n8n não é a ferramenta
- ✗Workflow com >50 nodes e muitos IFs
- ✗Debugar requer rodar passo a passo
- ✗Time tem medo de editar o workflow
- ✗Lógica de negócio misturada com integração
- ✗Sem git diff — ninguém sabe o que mudou
✓ Refatorar para código quando:
- ✓Lógica precisa de testes unitários
- ✓Precisa de revisão em PR
- ✓Estado complexo entre execuções
- ✓Precisão matemática ou tipagem rígida
💡 Regra do polegar
Se você precisar explicar o workflow em mais de 5 minutos para um novo membro do time, ele é complexo demais para n8n. Mova a lógica para um serviço Python com testes — chame ele via HTTP node no n8n.
📋 Resumo do Módulo
Próximo Módulo:
5.3 — Computer Use & Browser Agents