Agente de IA no WhatsApp com n8n: passo a passo
Para ter um agente de IA no WhatsApp com n8n, você sobe o n8n em modo fila (editor, webhook, worker e runners, com Postgres e Redis), liga uma API de WhatsApp que mande as mensagens para um webhook do n8n e monta o fluxo: receber, tratar o tipo de mensagem, buscar o histórico, chamar o nó de agente de IA e devolver a resposta. A passagem para humano fica numa regra do Chatwoot ou numa pausa dentro do próprio fluxo.
A maior parte dos problemas que vejo nesse tipo de agente não está no prompt, e sim na infraestrutura: n8n instalado de qualquer jeito, webhook de teste em produção, código travando todos os fluxos. Por isso começo pela stack, que é o tema do vídeo, gravado em março de 2026 com a versão 2 do n8n. Depois mostro o fluxo do agente e onde ele se encaixa no atendimento.
O que você precisa antes de começar
São quatro peças, e cada uma pode ser trocada por outra equivalente:
- Uma VPS com Docker Swarm, Traefik e Portainer. É o ambiente que eu uso em todos os tutoriais do canal.
- Dois subdomínios apontados para a VPS: um para o editor do n8n e outro para a API (webhooks).
- Uma API de WhatsApp que envie as mensagens recebidas para um webhook.
- Uma chave de um provedor de IA (OpenAI, Gemini, Anthropic, Groq ou outro aceito pelo n8n).
Se for usar o Chatwoot como tela de atendimento, ele entra como quinta peça. Ele não é obrigatório para o agente funcionar, mas é ele que deixa a equipe ver e assumir as conversas.
A stack do n8n para agente de IA no WhatsApp
A stack do vídeo separa o n8n em serviços, para que um fluxo pesado não derrube os outros. É o que eu chamo de instalação para grande escala, e ela faz diferença justamente em agente de WhatsApp, que recebe mensagem o dia inteiro.
| Serviço | Função | Pode escalar? |
|---|---|---|
| Editor | Interface onde você monta os fluxos | Não, só uma réplica |
| Webhook | Recebe as requisições externas (as mensagens do WhatsApp) | Sim |
| Worker | Processa as execuções da fila, incluindo agendamentos | Sim |
| Runners | Executa os nós de código (JavaScript e Python) em container separado | Sim |
| MCP | Atende o servidor MCP do n8n, com ajustes no Traefik | Não é o foco |
| Postgres 16 com pgvector | Banco do n8n, já pronto para embeddings | Não |
| Redis | Fila de execução no modo queue | Não |
Três detalhes da stack que evitam dor de cabeça:
- Variáveis centralizadas. Banco, Redis e endereços ficam declarados uma vez e são reaproveitados pelos cinco serviços. Na stack antiga eu repetia as mesmas informações cinco vezes.
- Runners separados. Um nó de código mal escrito pode entrar em loop. Com os runners num container próprio, o resto do n8n continua rodando.
- Postgres 16. A versão anterior usava o 14. Não atualize só trocando a tag: faça backup e restaure na versão nova. Se já tem um n8n rodando, faça um merge das novidades na sua stack em vez de colar a nova por cima.
A instalação em si é trocar as duas URLs na stack, colar no Portainer e fazer o deploy. A stack pronta está na página de apoio do vídeo.
Qual API de WhatsApp ligar no n8n
O n8n não conversa com o WhatsApp sozinho. Você precisa de uma API que receba a mensagem e chame o webhook do fluxo, e a escolha muda o risco e o trabalho.
- API oficial (Cloud API da Meta). Sem risco de bloqueio por usar ferramenta não autorizada, mas com custo por mensagem fora da janela de atendimento e regras de template.
- APIs não oficiais (WAHA, Evolution, AstraCalls, entre outras). O software é gratuito e conecta por QR Code, mas existe risco de bloqueio do número. A AstraCalls, que mantemos na Astra Online, tem node próprio para o n8n, o pacote
n8n-nodes-astracalls, segundo o README oficial.
A comparação entre as duas mais usadas está em WAHA ou Evolution API. Para o agente, o que importa é que a API mande texto, áudio e imagem para o webhook e aceite o envio de volta.
O fluxo do agente, etapa por etapa
O fluxo que eu uso tem oito etapas. Detalhei memória, prompt e base de conhecimento no artigo de chatbot com IA no WhatsApp; aqui fica o esqueleto para você montar o seu.
- Webhook recebe a mensagem. Use a URL de produção, que passa pelo serviço de webhook; a de teste só roda com o editor aberto.
- Filtro de grupos. Ignora mensagens de grupo, a não ser que você queira o agente neles.
- Quem mandou. Se a mensagem saiu da empresa (um atendente respondeu), o fluxo pausa a IA para aquele contato.
- Tipo de mensagem. Texto segue; áudio é transcrito; imagem é descrita.
- Junção de mensagens. Cliente que manda três mensagens seguidas recebe uma resposta só.
- Histórico. Busca as últimas mensagens do contato (Redis para o recente, Postgres para o histórico) e descarta o que é antigo demais.
- Nó de agente de IA. Recebe a mensagem, o histórico, o prompt e as ferramentas (base de conhecimento, agenda, consulta de pedido).
- Resposta. Quebra o texto em mensagens curtas e envia pela API.
Comece só com as etapas 1, 7 e 8 e vá acrescentando. Testar tudo de uma vez esconde onde está o erro.
Passagem para humano e pausa da IA
O agente precisa saber quando parar. Há duas formas que funcionam bem juntas:
- No Chatwoot: uma automação com o evento "mensagem criada" e a condição "contém a frase combinada" atribui a conversa a um atendente. No prompt, você manda a IA dizer exatamente essa frase quando o cliente pedir uma pessoa.
- No fluxo: quando a mensagem sai da empresa, a IA pausa por um tempo para aquele contato. No meu fluxo de 2025 eram 180 segundos; para venda consultiva, eu aumentaria para uma hora (3.600 segundos).
Sem a pausa, o robô responde por cima do vendedor no meio da negociação. É o erro que mais irrita o cliente.
Migrar do n8n V1 para o V2
Quem já tem agentes rodando no n8n V1 precisa de cuidado. O V2 traz o Migration Report, uma tela que lista os fluxos com pendência, porque vários nós mudaram entre as versões.
A minha recomendação no vídeo: instale um n8n novo e leve os fluxos aos poucos, conferindo cada um no relatório. Atualizar em cima da operação que está em produção pode quebrar o agente que responde os seus clientes. E leia as releases do n8n no GitHub antes de qualquer atualização, porque é lá que aparecem as mudanças que quebram a stack.
O lado honesto
O n8n é uma ferramenta muito boa e fácil de explicar para o cliente, mas a stack ficou grande. Como falo no vídeo, montar um agente simples de IA no n8n já exige vários containers e um servidor maior. Para agente de IA, hoje existem caminhos mais leves, como um criador de agente dentro da plataforma de atendimento ou um agente construído com código.
Também vale olhar a licença. O n8n usa a Sustainable Use License, que permite uso interno na sua empresa, mas restringe oferecer o n8n a terceiros de forma comercial. Se você é agência e pensa em revender, leia a licença antes. Os outros caminhos estão comparados em como criar um agente de IA para WhatsApp.
Perguntas frequentes
Dá para fazer um agente de IA no WhatsApp com n8n grátis?
O n8n roda no seu servidor sem mensalidade para uso interno. Você paga a VPS, o consumo do modelo de IA e, se usar a API oficial, as mensagens cobradas pela Meta.
Qual API de WhatsApp usar com o n8n?
Qualquer uma que envie as mensagens para um webhook e aceite o envio de volta. A API oficial não tem risco de bloqueio por ferramenta, mas cobra por mensagem; as não oficiais, como WAHA, Evolution e AstraCalls, são gratuitas e têm risco de bloqueio do número.
Preciso de Redis e Postgres para o n8n com IA?
Para o modo fila, sim: o Redis gerencia a fila de execução e o Postgres guarda os dados do n8n. Os dois também servem de memória do agente, o Redis para as mensagens recentes e o Postgres para o histórico.
Como fazer o chatbot do n8n passar para um atendente?
Combine uma frase no prompt e crie uma automação no Chatwoot que atribui a conversa quando essa frase aparece. No fluxo, pause a IA quando a mensagem sair da empresa.
Vale a pena migrar meus fluxos do n8n V1 para o V2?
Vale, com calma. Instale o V2 em paralelo, use o Migration Report para ver os fluxos com pendência e mova um por vez.
Sem montar a stack inteira
No AstraChat, o Chatwoot Pro da Astra Online, o agente de IA fica dentro do atendimento, com flows, Kanban, disparador e ligações pelo WhatsApp, e sem cobrança por atendente. Quem quer continuar no n8n também pode: o AstraChat tem API e webhooks para isso.
Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Me chame no WhatsApp contando quantos fluxos você tem no n8n hoje e o que cada um faz; eu digo quais valem a pena manter lá.


