Falar com um especialista

Agente de IA no WhatsApp com n8n: passo a passo

Por Raphael Popiolek ·

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:

  1. Uma VPS com Docker Swarm, Traefik e Portainer. É o ambiente que eu uso em todos os tutoriais do canal.
  2. Dois subdomínios apontados para a VPS: um para o editor do n8n e outro para a API (webhooks).
  3. Uma API de WhatsApp que envie as mensagens recebidas para um webhook.
  4. 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:

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.

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.

  1. 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.
  2. Filtro de grupos. Ignora mensagens de grupo, a não ser que você queira o agente neles.
  3. Quem mandou. Se a mensagem saiu da empresa (um atendente respondeu), o fluxo pausa a IA para aquele contato.
  4. Tipo de mensagem. Texto segue; áudio é transcrito; imagem é descrita.
  5. Junção de mensagens. Cliente que manda três mensagens seguidas recebe uma resposta só.
  6. Histórico. Busca as últimas mensagens do contato (Redis para o recente, Postgres para o histórico) e descarta o que é antigo demais.
  7. Nó de agente de IA. Recebe a mensagem, o histórico, o prompt e as ferramentas (base de conhecimento, agenda, consulta de pedido).
  8. 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:

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á.

Mais artigos de IA no atendimento e o Guia completo do Chatwoot, com todos os assuntos organizados.

Leia também

17 de novembro de 2026

Chatbot para Instagram com IA e n8n: passo a passo

Chatbot para Instagram com IA no n8n: conecte o Direct pela API oficial, responda texto, áudio e imagem com contexto e coloque o fluxo em produção.

02 de novembro de 2026

Como criar um agente de IA para WhatsApp: método e 3 caminhos

Como criar um agente de IA para WhatsApp: função, tom, base de conhecimento, regra de passar para humano e testes. Sem programar, com n8n ou com código.

28 de outubro de 2026

Chatbot com IA no WhatsApp: memória e passagem para humano

Chatbot com IA no WhatsApp que lembra a conversa, consulta seus preços e passa para um atendente no Chatwoot. Veja o fluxo no n8n com Evolution API.