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

- **Versão em HTML:** https://tolky.to/blog/agente-de-ia-para-whatsapp-com-n8n
- **Autor:** [Marlos Carmo](https://tolky.to/autor/marlos), Cofundador da Tolky
- **Publicado em:** 19 de novembro de 2026
- **Revisado em:** 19 de novembro de 2026
- **Idioma:** pt-BR

## Resumo

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.

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](https://tolky.to/glossario/agente-de-ia) decide o que dizer e quando usar uma ferramenta, como consultar uma planilha.

As peças: a [WhatsApp Cloud API](https://tolky.to/glossario/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](https://docs.n8n.io/integrations/builtin/credentials/whatsapp/), 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](https://docs.n8n.io/n8n-community-license/community-license/license-faq)).
- **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](https://tolky.to/blog/como-conseguir-api-oficial-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](https://tolky.to/glossario/webhook) a endpoints HTTPS e não aceita certificado autoassinado ([documentação da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/create-webhook-endpoint), conferida em 19 de novembro de 2026).

A [documentação de instalação do n8n](https://docs.n8n.io/hosting/installation/docker/) 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens), 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](https://docs.n8n.io/integrations/builtin/trigger-nodes/n8n-nodes-base.whatsapptrigger/), 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](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/)). 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](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.memorybufferwindow/) 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](https://n8n.io/integrations/whatsapp-business-cloud/); 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](https://tolky.to/blog/treinar-agente-ia-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](https://tolky.to/funcionalidades/multiatendimento-whatsapp).
- **Fila e transferência com contexto.** O caso chega à pessoa certa com o resumo. Veja as regras de [handoff da IA para o humano](https://tolky.to/blog/handoff-ia-humano-regras).
- **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](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm)). Isso vale para o servidor, os logs de execução e o que vai ao modelo ([LGPD](https://tolky.to/glossario/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](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing)). Simule na [calculadora de custo da API do WhatsApp](https://tolky.to/recursos/calculadora-custo-api-whatsapp) e veja [quanto custa um agente de IA para WhatsApp](https://tolky.to/blog/quanto-custa-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](https://tolky.to/blog/como-criar-agente-de-ia-para-whatsapp) e o guia de [automação de WhatsApp para empresas](https://tolky.to/blog/automacao-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](https://tolky.to/blog/api-nao-oficial-whatsapp-riscos).

## 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](https://tolky.to/integracoes/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](https://tolky.to/funcionalidades/fluxos-de-automacao-whatsapp) e o [CRM da Tolky](https://tolky.to/solucoes/crm).

![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](https://tolky.to/screenshots/automacao.png)

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](https://tolky.to/integracoes)).

**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](https://tolky.to/perguntas/a-tolky-funciona-com-zapier-ou-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](https://tolky.to/precos).

## 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](https://tolky.to/precos), [conheça os Fluxos da Tolky](https://tolky.to/funcionalidades/fluxos-de-automacao-whatsapp), [traga seus fluxos do n8n](https://tolky.to/integracoes/n8n) ou [fale com o time →](https://tolky.to/contato). Vamos conversar?

---

Esta é a versão em Markdown da página. A versão completa, com imagens e navegação, está em https://tolky.to/blog/agente-de-ia-para-whatsapp-com-n8n

Tolky: https://tolky.to
