n8n: automação visual e cola entre sistemas

Nem toda automação precisa virar código no repo. Às vezes você só quer ligar duas APIs e disparar algo — rápido, visual, sem deploy. Pra isso existe o n8n, a ferramenta de automação low-code do stack.

O que é

Plataforma de automação de workflows open-source e visual: você arrasta nós (triggers, ações, condições), conecta serviços e monta um fluxo sem escrever um job inteiro. É o primo "arrasta-e-solta" do Trigger.dev (#04).

Onde usamos

• Resumos diários de WhatsApp — hoje parte dessa orquestração roda em n8n.
• Cola entre sistemas — quando é mais rápido conectar APIs num fluxo visual do que escrever código.

Direção atual: migrar o crítico e recorrente pro Trigger.dev (retry, observabilidade, código versionado). O n8n fica pro experimento, cola pontual e prototipagem.

Conceitos-chave

• Nós (nodes) — triggers (webhook, cron, evento) e ações (HTTP, integrações prontas, código).
• Credenciais — cofre próprio do n8n pra chaves dos serviços.
• Self-host × cloud — dá pra rodar a própria instância ou usar a hospedada.
• Queue mode — modo de escala pra rodar muitos fluxos em paralelo.
• Error workflows — fluxo que dispara quando outro falha (seu "retry/alerta").

Boas práticas

• Versione exportando o JSON do fluxo pro git — assim ele deixa de ser caixa-preta.
• Proteja webhooks (segredo/assinatura) — endpoint aberto é porta de entrada.
• Documente o fluxo — quem mantém precisa entender sem abrir cada nó.
• Tenha error workflow pra não falhar em silêncio.

Pegadinhas

• ⚠️ Fluxo visual é difícil de versionar e revisar — não passa pelo PR + AI review (#06). Maior motivo da migração pro Trigger.dev.
• ⚠️ Vira caixa-preta — lógica importante que só uma pessoa entende é risco de manutenção.
• ⚠️ Credenciais e self-host — mais uma peça pra manter no ar e proteger; instância caída = automação parada, muitas vezes em silêncio.
• ⚠️ Difícil de testar de forma automatizada.

n8n × Trigger.dev (a régua)

• n8n — cola rápida, experimento, fluxo que muda toda hora, automação tocada por quem não é dev.
• Trigger.dev — automação crítica, recorrente, com retry/log e versionada junto da app.

Se a automação é importante o bastante pra alguém depender dela, ela merece virar código.

Quando usar (e quando não)

Use pra prototipar e colar sistemas sem fricção. Não deixe lógica de negócio crítica morar só num fluxo visual sem versão.

n8n é ótimo pra ir rápido; Trigger.dev é melhor pra ir seguro. Saber quando promover um fluxo de um pro outro é a habilidade que importa.

Fim da trilha Ferramentas. Volte ao #01 pra o mapa do stack.