Pular para o conteúdo

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.

Cofundador da Tolky

Atualizado em 19 de novembro de 2026

12 min de leitura
Agente de IA para WhatsApp com n8n: passo a passo e quando 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.

PassoNó do n8nO que configurarComo conferir
1CredenciaisAPI key (Access Token e Business Account ID) e OAuth2 (Client ID e Client Secret)Teste da credencial sem erro
2WhatsApp TriggerEvento MessagesUma mensagem ao número gera uma execução
3IfSeguir só com mensagens do clienteStatus não chegam ao agente
4AI AgentChat model, memória, ao menos uma ferramenta e instruçãoA resposta lembra o que foi dito
5WhatsApp Business CloudOperação Send, remetente e número do clienteA 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.

ComponenteComo é cobradoExemplo ilustrativo por mês
n8nAssinatura do n8n Cloud, ou servidor e banco própriosR$ 150
Modelo de IAPor tokens, conforme o provedorR$ 200
Tarifas da MetaPor 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çãoHoras de quem cuida do fluxo e dos incidentes10 h × R$ 120 = R$ 1.200
Total ilustrativoR$ 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:

  1. Exporte o fluxo no n8n como JSON.
  2. Em Fluxos, use Importar e escolha o arquivo.
  3. 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.

Captura real da tela Automatizações da Tolky, no tema escuro, com os módulos de automação na lateral e uma automação aberta, Falha no Teste de Placa, com a condição Quando escrita em linguagem natural e a ação Criar Ticket

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

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

Leia também sobre CRM conversacional e AI CRM