O que é o n8n e onde ele ganha

Field Note

Reunião de segunda. Alguém mostra um agente de IA que lê a planilha de pedidos, cruza com o cadastro e escreve para cada fornecedor atrasado. A demo é linda. Na terceira rodada, ele decide que "atrasado" inclui o pedido que vence amanhã e manda cobrança para quem está em dia. Ninguém sabe dizer por quê. O mesmo trabalho cabia em cinco caixinhas: ler a planilha, filtrar por data, juntar com o cadastro, montar a mensagem, enviar. Sem nenhuma decisão criativa no meio. O problema nunca pediu um agente. Pediu um fluxo.

Conceito

O n8n se descreve como "fair-code workflow automation platform with native AI capabilities". Traduzindo para o dia a dia: você desenha a automação numa tela visual, escreve código quando a caixinha pronta não basta e pluga IA onde ela faz sentido. Ele roda na nuvem do próprio n8n ou no seu servidor.

Quatro palavras que você vai usar o tempo todo:

• Workflow: o desenho inteiro. Uma sequência de nós ligados, do começo ao fim.
• Nó: cada passo, e cada nó faz uma coisa. Um chama uma API, outro filtra, outro ajusta campos. A saída de um vira a entrada do próximo.
• Trigger: o nó especial que começa o workflow quando algo acontece (um horário, uma requisição, um clique seu). Na busca de nós, os triggers aparecem com um ícone de raio.
• Execução: uma rodada completa do workflow. A doc define assim: "An execution is a single run of a workflow." Execução manual é a que você dispara com Execute workflow enquanto constrói. Execução de produção é a que roda sozinha depois que você clica em Publish.

Um detalhe que explica metade dos sustos do começo: entre nós, o dado sempre viaja como uma lista de objetos, cada item com seus campos dentro da chave json. Um nó que recebe dez itens processa os dez, um por um. Você não precisa escrever o loop.

Onde o n8n ganha. Ele ganha quando o problema é ligar sistemas com regra clara: puxar daqui, transformar, decidir por regra, mandar para lá.

• Contra um script solto: o script resolve, mas mora no computador de alguém. Quando quebra às três da manhã, ninguém vê qual passo falhou. No n8n cada execução fica registrada, e dá para abrir e ver o que entrou e saiu de cada nó. E o código não some: o nó Code aceita JavaScript e Python quando a regra não cabe em caixinha.
• Contra ferramenta no-code fechada: ganha quando você precisa escrever código no meio do fluxo, rodar no próprio servidor ou chamar uma API sem conector pronto com o nó HTTP Request.
• Contra agente: ganha sempre que o caminho é conhecido. Agente decide o próprio caminho, e isso custa previsibilidade e rastreabilidade. Se o caminho cabe num desenho, desenhe.

A escada. Antes de escolher ferramenta, escolha o degrau. A escada do Kit de Campo, em doug.ia.br/kit-de-campo/degrau, tem cinco:

• Degrau 0: eliminar ou resolver sem IA.
• Degrau 1: automação determinística (fluxo).
• Degrau 2: fluxo determinístico com etapas de IA pontuais.
• Degrau 3: agente de tarefa (task agent).
• Degrau 4: agente autônomo.

A regra é usar o degrau mais baixo que resolve. O n8n mora confortável nos degraus 1 e 2, e alcança o 3 com o nó AI Agent. Mas poder subir não é motivo para subir.

Prova de que o degrau baixo ganha. No meu laboratório, a consulta de candidato tinha um prazo formal de sete dias. Eram 40 consultas por mês, 1h30 cada somando checagem e coordenação: 60 horas por mês. A tentação era um agente. Ficou no degrau dois: fluxo determinístico com IA pontual, orquestrado em n8n, com um formulário de quatro campos na frente. Checagem de candidato é regra, consulta e política. Trabalho de compliance que decide diferente com a mesma entrada não é inovação, é passivo regulatório. Resultado: a execução da consulta caiu de sete dias para cerca de 15 segundos e 60 horas por mês voltaram para o time. As regras e a trilha de auditoria ficaram com a área que carrega o risco.

Quando usar

• Integração entre sistemas com API, planilha, e-mail ou banco, com regra que dá para escrever.
• Tarefa repetida que hoje alguém faz copiando e colando entre telas.
• Fluxo que precisa de um passo de IA bem delimitado: classificar, resumir, extrair campos.
• Quando você quer ver cada execução, passo a passo, sem montar log na mão.

Quando não usar

• Quando o degrau zero resolve: uma regra no sistema que já existe, um filtro na planilha, ou parar de fazer a tarefa.
• Processamento pesado de dados, com milhões de linhas. Isso é trabalho de banco ou de pipeline de dados.
• Produto em que o seu cliente vai montar os próprios workflows. Aí entra a licença, assunto da próxima lição.
• Quando ninguém consegue escrever a regra. Se nem a pessoa que faz hoje sabe dizer como decide, o problema é de processo antes de ser de ferramenta.

Faça agora

O entregável é a Ficha de decisão: n8n ou não, preenchida para um problema real seu.

1. Escolha uma tarefa repetida do seu trabalho. Anote volume por mês e tempo por vez, antes de qualquer desenho.
2. Escreva a tarefa como passos, um por linha, no formato verbo e objeto: "ler planilha", "filtrar atrasados", "enviar e-mail".
3. Em cada passo, marque: é regra (sempre a mesma saída para a mesma entrada) ou é julgamento (precisa interpretar texto, decidir algo ambíguo)?
4. Escolha o degrau. Tudo regra: degrau 1. Uma ou duas etapas de julgamento bem delimitadas: degrau 2. Caminho que muda a cada caso: só aí pense no 3.
5. Abra a biblioteca de templates em n8n.io/workflows e procure um workflow parecido com o seu. Não para copiar: para ler.
6. Leia o workflow em voz alta. Comece pelo trigger, siga as conexões e, em cada nó, diga o que entra e o que sai. Anote quantos nós são regra e quantos usam IA.
7. Compare com a sua lista do passo 2. O template subiu um degrau a mais do que o seu problema pede? Anote.
8. Preencha a ficha abaixo e decida: n8n, outra coisa ou nada.

Armadilhas

• Começar pela ferramenta. "Vamos fazer no n8n" antes de escrever os passos é escolher martelo sem ver o prego.
• Subir degrau por empolgação. O AI Agent está ali, a um clique. Isso não transforma regra em julgamento.
• Confundir execução manual com produção. Clicar em Execute workflow testa. Só depois de Publish o trigger dispara sozinho.
• Copiar template sem ler. Template vem com o desenho de outra pessoa e, muitas vezes, com credenciais e configurações para ajustar.
• Esquecer que o dado é lista. Dez itens entram, dez itens saem. Quem espera um só leva susto com dez e-mails.

Material para levar

FICHA DE DECISÃO: N8N OU NÃO

Tarefa:
Volume por mês:
Tempo por vez:
Horas por mês (volume x tempo):

Passos (verbo + objeto)       Regra ou julgamento?
1.
2.
3.
4.
5.

Sistemas envolvidos (API, planilha, e-mail, banco):
Algum sistema sem API? Qual?

Degrau escolhido (0 a 4):
Por que não o degrau abaixo:

O degrau 0 resolve? (eliminar, regra no sistema atual)  sim / não

Template lido (link):
O template sobe degrau além do necessário?  sim / não

Decisão: n8n / outra ferramenta / não automatizar
Quem é dono da regra:
Quem vê quando falhar: