Agente de IA para WhatsApp com n8n: passo a passo e quando migrar
Como criar um agente de IA para WhatsApp com n8n e a API oficial: credenciais, gatilho, nó AI Agent com memória, testes, custo total e os sinais de que é hora de migrar.

TL;DR
Um agente de IA para WhatsApp com n8n liga a API oficial do WhatsApp (Cloud API) a um fluxo com o gatilho WhatsApp Trigger, o nó AI Agent com modelo, memória e ferramentas, e o nó WhatsApp Business Cloud para responder. Montar leva algumas horas; operar exige caixa para humanos, fila, CRM, monitoramento, hospedagem 24/7 e cuidado com a LGPD. Quando isso pesa mais que o fluxo, é hora de migrar, e os Fluxos da Tolky importam o JSON do n8n.
Compartilhar
Criar um agente de IA para WhatsApp com n8n é possível em uma tarde: um gatilho recebe a mensagem pela API oficial, um nó de agente de IA pensa e um nó do WhatsApp responde. Os tutoriais mais vistos param aí.
Eles não mostram o dia seguinte: o cliente que pede uma pessoa, o token que expira, a resposta duplicada, a conta da Meta. Este guia traz o passo a passo, o que falta para virar operação, o custo total e quando migrar.
Atualizado em novembro de 2026.
O que é um agente de IA para WhatsApp com n8n?
Um agente de IA para WhatsApp com n8n é um fluxo do n8n que recebe as mensagens do WhatsApp pela API oficial, entrega cada uma a um modelo de linguagem com memória e ferramentas, e envia a resposta ao cliente. O agente de IA decide o que dizer e quando usar uma ferramenta, como consultar uma planilha.
As peças: a WhatsApp Cloud API, o n8n, o modelo de linguagem e a memória de cada conversa.
O n8n é uma ferramenta de automação excelente, mas não é uma plataforma de atendimento: não traz caixa de entrada para a equipe, fila nem CRM.
O que você precisa antes de começar?
Você precisa de uma instância do n8n acessível por HTTPS, um app da Meta com WhatsApp, um número e uma chave de API de um modelo de linguagem. A lista segue a documentação de credenciais do WhatsApp no n8n, conferida em 19 de novembro de 2026.
- n8n na nuvem ou no seu servidor. O n8n Cloud é uma assinatura paga; a versão auto-hospedada é gratuita para uso interno, sob a Sustainable Use License (FAQ da licença).
- Conta de desenvolvedor da Meta e portfólio empresarial, com um app que tenha o produto WhatsApp e esteja em modo Live.
- Um número. A Meta oferece um número de teste; para produção, use o da empresa. Veja como conseguir a API oficial do WhatsApp Business.
- Chave de API de um modelo de linguagem, com limite de gasto.
- Endereço público com certificado válido. A Meta só entrega webhooks a endpoints HTTPS e não aceita certificado autoassinado (documentação da Meta, conferida em 19 de novembro de 2026).
A documentação de instalação do n8n recomenda a auto-hospedagem só para usuários experientes.
Como criar um agente de IA para WhatsApp no n8n, passo a passo
O fluxo mínimo tem cinco passos: credenciais, gatilho de mensagem recebida, filtro, nó AI Agent com modelo, memória e ferramenta, e envio da resposta. Os nomes são os da documentação do n8n em 19 de novembro de 2026.
| Passo | Nó do n8n | O que configurar | Como conferir |
|---|---|---|---|
| 1 | Credenciais | API key (Access Token e Business Account ID) e OAuth2 (Client ID e Client Secret) | Teste da credencial sem erro |
| 2 | WhatsApp Trigger | Evento Messages | Uma mensagem ao número gera uma execução |
| 3 | If | Seguir só com mensagens do cliente | Status não chegam ao agente |
| 4 | AI Agent | Chat model, memória, ao menos uma ferramenta e instrução | A resposta lembra o que foi dito |
| 5 | WhatsApp Business Cloud | Operação Send, remetente e número do cliente | A resposta chega no celular |
1. Crie as credenciais da Meta no n8n
O nó WhatsApp Business Cloud usa credencial API key, com o Access Token e o ID da conta do WhatsApp Business (em WhatsApp > API Setup, no app da Meta). O WhatsApp Trigger usa OAuth2, com o App ID e o App Secret de App settings > Basic.
O cuidado que derruba muito agente no segundo dia: o token da tela de configuração é um token de usuário, que expira em poucas horas. Para produção, a Meta orienta usar um token de usuário do sistema, de longa duração (tokens de acesso, conferido em 19 de novembro de 2026).
2. Configure o gatilho de mensagem recebida
Use o nó WhatsApp Trigger com o evento Messages. Pela documentação do WhatsApp Trigger, o WhatsApp aceita um só webhook por app: alternar entre a URL de teste e a de produção sobrescreve o registro. E publicar o fluxo não inscreve o app na conta do WhatsApp Business; sem essa inscrição, nada chega e nenhum erro aparece.
O evento Messages também traz as atualizações de status (enviada, entregue, lida), que a Meta entrega no mesmo campo. Um nó If logo depois do gatilho deixa seguir só as mensagens do cliente.
3. Monte o nó AI Agent com memória e ferramentas
O AI Agent funciona com um modelo de chat e pelo menos uma ferramenta conectada (AI Agent no n8n). Escreva a instrução do sistema (quem o agente é, o que responde, quando passa para uma pessoa) e conecte a ferramenta, como uma requisição HTTP ao seu sistema.
Na memória, o Simple Memory pede uma Session Key: use o número do cliente, para cada conversa ter a sua. A documentação do Simple Memory avisa que ele não funciona em produção com o n8n em modo de fila (queue mode); nesse caso, use uma memória em banco, como o Postgres Chat Memory.
4. Envie a resposta e teste
No nó WhatsApp Business Cloud, use a operação Send, com o número do cliente vindo do gatilho como destinatário. Teste com o número de teste da Meta, mandando perguntas fora do escopo, um áudio e três mensagens seguidas.
Há fluxos prontos da comunidade com IA na página de integração do WhatsApp Business Cloud no n8n; revise cada nó antes de usar.
Quais erros mais aparecem na montagem?
Os erros mais comuns são de infraestrutura, não de IA: mensagens duplicadas, webhook sobrescrito, app não inscrito e tipos de mensagem não tratados.
- Resposta duplicada. A Meta reenvia o webhook sem confirmação por até 7 dias e recomenda tratar repetições. Guarde o ID de cada mensagem.
- Agente respondendo a status. Sem o filtro, cada "entregue" pode disparar uma resposta.
- Silêncio total. App não inscrito na conta do WhatsApp Business.
- Fluxo que para após um teste. A URL de teste sobrescreveu a de produção.
- Áudio, imagem e documento. O gatilho recebe, mas o agente só entende o que você tratar.
- Respostas inventadas. Falta instrução clara e uma base de conhecimento.
O que falta para o agente virar operação?
Um fluxo que responde não é um atendimento: falta onde a equipe trabalha, como o caso chega a uma pessoa e como a empresa mede e protege o que acontece.
- Caixa para humanos. O n8n não tem tela de conversas para o time responder no mesmo número, com multiatendimento.
- Fila e transferência com contexto. O caso chega à pessoa certa com o resumo. Veja as regras de handoff da IA para o humano.
- CRM e histórico num lugar só, e não espalhados em execuções do n8n.
- Templates para retomar clientes fora da janela de 24 horas.
- Métricas de resolução da IA, tempo de resposta e transferências.
- Monitoramento e hospedagem 24/7, com alertas, backups e atualizações.
- Segurança e LGPD. A lei exige medidas técnicas e administrativas que protejam dados pessoais de acessos não autorizados (Lei 13.709, art. 46). Isso vale para o servidor, os logs de execução e o que vai ao modelo (LGPD).
Quanto custa um agente de IA no WhatsApp com n8n?
O custo total soma hospedagem do n8n, uso do modelo de IA, tarifas da Meta e horas de manutenção, e a última costuma ser a maior. Só as tarifas da Meta têm valor público fixo.
| Componente | Como é cobrado | Exemplo ilustrativo por mês |
|---|---|---|
| n8n | Assinatura do n8n Cloud, ou servidor e banco próprios | R$ 150 |
| Modelo de IA | Por tokens, conforme o provedor | R$ 200 |
| Tarifas da Meta | Por mensagem entregue, com 1.000 respostas de serviço grátis por número ao mês | (6.000 − 1.000) × R$ 0,035 = R$ 175 |
| Manutenção | Horas de quem cuida do fluxo e dos incidentes | 10 h × R$ 120 = R$ 1.200 |
| Total ilustrativo | R$ 1.725 |
Servidor, modelo e hora são valores inventados, só para a conta. As tarifas da Meta são reais: pela tabela vigente desde 1º de outubro de 2026, conferida em 17 de novembro de 2026, uma mensagem de serviço para número brasileiro custa R$ 0,035 depois das 1.000 gratuitas, e um template de marketing, R$ 0,3217 (preços da WhatsApp Business Platform). Simule na calculadora de custo da API do WhatsApp e veja quanto custa um agente de IA para WhatsApp.
Quando ficar no n8n e quando migrar?
O n8n é a melhor escolha quando o WhatsApp é uma peça de uma automação maior e alguém técnico cuida do fluxo; migrar faz sentido quando o atendimento vira o centro.
Fique no n8n quando o volume é pequeno, sem equipe humana no número, ou quando a empresa já roda o n8n e tem quem o mantenha.
Sinais de que é hora de migrar:
- mais de uma pessoa precisa responder no mesmo número;
- clientes recebem respostas repetidas, perdidas ou fora de hora;
- só uma pessoa entende o fluxo;
- a gestão pede métricas de atendimento;
- o jurídico pergunta onde ficam as conversas e quem tem acesso;
- as horas de manutenção superam o preço de uma plataforma.
Para comparar os caminhos (n8n, plataforma ou a IA da Meta), veja como criar um agente de IA para WhatsApp e o guia de automação de WhatsApp para empresas.
E as APIs não oficiais, como Evolution API e WAHA?
Muitos tutoriais de n8n conectam o número pelo WhatsApp Web, lendo um QR Code, sem a API oficial. É grátis e rápido de testar, mas o WhatsApp diz que apps não oficiais violam os termos e que a conta pode ser banida.
A Evolution API suporta tanto o WhatsApp Web (com a biblioteca Baileys) quanto a Cloud API oficial: o risco está no modo de conexão. Os detalhes estão no guia sobre API não oficial do WhatsApp.
Como migrar do n8n para a Tolky sem perder o trabalho?
Os Fluxos da Tolky importam o JSON de um fluxo do n8n para revisão no editor visual e exportam fluxos no formato do n8n, com ressalvas nos passos que não têm equivalente. Quem começou no n8n não redesenha do zero.
O caminho, descrito na integração com o n8n:
- Exporte o fluxo no n8n como JSON.
- Em Fluxos, use Importar e escolha o arquivo.
- Revise os nós e publique. Passos sem equivalente são refeitos, em geral com requisição HTTP ou código avançado.
O que no n8n eram peças soltas já vem pronto: gatilho de mensagem nativo, agente de IA com a base de conhecimento da conta, transferência para uma pessoa que pausa a IA e leva o histórico, e passos de CRM (negócio, etapa, tag e tarefa). Veja os fluxos de automação para WhatsApp e o CRM da Tolky.

As Automações, da captura, agem durante a conversa com condições em linguagem natural. Para outros sistemas, há mais de 1.000 apps, requisição HTTP, webhooks, API REST e MCP (integrações).
O que a Tolky não faz: não tem conector pronto para Zapier ou Make (a ponte é por webhooks e requisição HTTP, como explica a pergunta sobre Zapier e Make), e a importação não converte todos os nós do n8n. O WhatsApp entra a partir do Starter (R$ 500 por mês, 500 atendimentos, 2 usuários, 10 fluxos e 1.000 execuções); o Individual é gratuito, mas sem WhatsApp. As tarifas da Meta ficam fora do plano. Veja os planos.
Perguntas frequentes
Dá para criar um agente de IA para WhatsApp com n8n de graça?
O n8n auto-hospedado é gratuito para uso interno, mas servidor, modelo de IA e tarifas da Meta são pagos. A Meta dá 1.000 mensagens de serviço grátis por número ao mês; acima disso, cada resposta é cobrada.
Qual API do WhatsApp usar com o n8n?
A API oficial, pela Cloud API da Meta, que tem nós próprios no n8n: WhatsApp Trigger para receber e WhatsApp Business Cloud para enviar. Conexões pelo WhatsApp Web trazem risco de bloqueio do número.
Existe template pronto de agente de IA para WhatsApp no n8n?
Sim. A página de integração do WhatsApp Business Cloud no site do n8n lista fluxos da comunidade com IA. Revise credenciais, memória e regras antes de usar.
O n8n permite vários atendentes no mesmo número?
Não diretamente. O n8n automatiza o fluxo, mas não tem caixa de entrada para a equipe. Para várias pessoas no mesmo número, é preciso uma plataforma de atendimento ligada à API oficial.
Por que meu agente no n8n responde duas vezes?
Em geral, a Meta reenviou o webhook ou o gatilho disparou com uma atualização de status. Filtre as mensagens do cliente e guarde o ID de cada uma.
Consigo levar meus fluxos do n8n para a Tolky?
Sim. Os Fluxos da Tolky importam o JSON do n8n para revisão no editor visual e exportam no formato do n8n. Passos sem equivalente precisam de ajuste manual.
Conclusão
Um agente de IA para WhatsApp com n8n é um ótimo jeito de validar um caso de uso. Quando ele vira atendimento, com equipe, fila, CRM e métricas, o custo passa a estar na manutenção, e vale comparar com uma plataforma que já traz essas peças.
Veja os planos, conheça os Fluxos da Tolky, traga seus fluxos do n8n ou fale com o time →. Vamos conversar?
Compartilhar
Tags
- agente de ia para whatsapp n8n
- como criar agente de ia para whatsapp n8n
- api whatsapp para n8n
- automação whatsapp n8n
- whatsapp cloud api
- ai agent n8n
- migrar do n8n
- #CRM conversacional
Citado em
- API não oficial do WhatsApp: riscos de bloqueio e o que a Meta permite
- Automação de WhatsApp para empresas: o que automatizar e como começar
- Como criar um agente de IA para WhatsApp: n8n, plataforma ou Meta
- Quanto custa agente de IA para WhatsApp? Plataforma e tarifa da Meta
- Chatbot para WhatsApp: como funciona e como criar
Sobre o autor

Cofundador da Tolky
Marlos Carmo é empreendedor em IA e fundador da Tolky, a infraestrutura e AI CRM da era conversacional que unifica atendimento inteligente, multicanalidade (como WhatsApp e voz), CRM vivo e inteligência operacional em um único ecossistema. É finalista do SXSW Innovation Awards e integrante do Francesco's Economy, rede global de jovens empreendedores com foco em inovação e impacto social. Atua conectando Inteligência Artificial e transformação digital em projetos para grandes organizações.
Próximo passo
Quer levar isso para a sua operação?
A Tati, assistente de IA da Tolky, entende o seu cenário em poucas perguntas, sugere o melhor caminho e te conecta com uma pessoa do time levando todo o contexto.
Compartilhar



