Voltar para o blog IA aplicada

Agente de IA no WhatsApp com n8n: arquitetura, custo e riscos

Como montar um agente de IA no WhatsApp com n8n e a API oficial da Meta: arquitetura, custo por conversa com exemplo e o que dá errado (alucinação e LGPD).

Um agente de IA no WhatsApp com n8n tem quatro peças: a API oficial do WhatsApp Business (Cloud API da Meta) recebe a mensagem e avisa o n8n por webhook; o n8n passa a mensagem para um modelo de linguagem com memória da conversa, base de conhecimento e ferramentas; e devolve a resposta pela mesma API. Quando o agente não sabe ou o cliente pede, a conversa vai para uma pessoa.

O custo de rodar fica, no exemplo que detalhamos abaixo, entre R$ 0,53 e R$ 1,30 por conversa, somando modelo, WhatsApp e n8n. O que custa caro de verdade não é rodar: é o agente responder errado com confiança. A maior parte deste texto é sobre como evitar isso.

API oficial ou não oficial: a decisão que vem antes de tudo

A API oficial (WhatsApp Business Platform). A Meta oferece a Cloud API, hospedada por ela. Você cadastra o número da empresa numa conta comercial da Meta, cria um aplicativo, assina o webhook e passa a receber e enviar mensagens por API, pagando por mensagem entregue. O n8n tem nós prontos: o WhatsApp Trigger, que recebe os eventos, e o WhatsApp Business Cloud, que envia.

As soluções não oficiais. São serviços e bibliotecas que conectam um número comum lendo o QR code do WhatsApp Web, como os baseados na biblioteca Baileys. Fáceis de começar, sem cobrança por mensagem.

Sejamos claros: para empresa, não use solução não oficial. Os Termos de Serviço do WhatsApp proíbem mensagens automáticas e acesso por meios automatizados não autorizados, e preveem suspensão e desativação da conta. Na prática, isso significa que o número da empresa pode ser banido de um dia para o outro — junto com o histórico e os contatos que dependem dele. Além disso, a integração quebra quando o WhatsApp muda o aplicativo, e não há a quem recorrer.

Mais um ponto da política da Meta: desde 15 de janeiro de 2026, os termos da plataforma comercial vetam chatbots de IA de uso geral, aqueles em que o próprio assistente é o produto. Um agente que atende os clientes da sua empresa, sobre os seus produtos e serviços, está no uso previsto.

Quanto a Meta cobra pela API do WhatsApp em 2026

Regras conferidas em novembro de 2026 na documentação oficial da Meta para desenvolvedores.

Desde julho de 2025, a Meta cobra por mensagem entregue, não mais por conversa. O cliente nunca paga pelo que envia. A cobrança depende da categoria da mensagem que a empresa manda:

CategoriaO que éCobrança
ServiçoResposta livre, sem modelo aprovado, dentro da janela de 24 horas1.000 grátis por mês por número; depois, cobrada por mensagem
UtilidadeModelo aprovado sobre um pedido ou conta (confirmação, status)Por mensagem, com desconto por volume
AutenticaçãoModelo com código de acessoPor mensagem, com desconto por volume
MarketingModelo de oferta, novidade, reativaçãoPor mensagem; a categoria mais cara

Três regras que mudam o desenho do agente:

  • A janela de 24 horas. Quando o cliente manda mensagem, abre uma janela de 24 horas, e cada nova mensagem dele reinicia o relógio. Só dentro dela a empresa pode responder com texto livre — que é o que o agente faz. Fora dela, só com modelo aprovado e pago.
  • Mensagem de serviço voltou a ser cobrada. Desde 1º de outubro de 2026, cada número tem 1.000 mensagens de serviço grátis por mês, sem acumular. A partir da 1.001ª, cobra. Sem forma de pagamento cadastrada, a Meta para de entregar depois da franquia.
  • Anúncio que leva ao WhatsApp abre janela grátis. Quando o cliente chega por um anúncio de clique para o WhatsApp, abre uma janela de até 7 dias em que as mensagens da empresa não são cobradas.

Quanto custa cada mensagem no Brasil: no exemplo que a própria Meta publica para o país, a mensagem de serviço sai a US$ 0,0068 (0,68 centavo de dólar), a mesma tarifa de utilidade e autenticação. Desde julho de 2026, empresas com faturamento no Brasil podem ser cobradas em reais, pela Facebook Brasil. As tabelas completas ficam na página de preços da plataforma; confira antes de orçar.

A arquitetura do agente no n8n

O caminho de uma mensagem, do cliente até a resposta:

Cliente → WhatsApp → Cloud API da Meta → webhook → n8n
   n8n: filtra e agrupa → busca memória → agente (modelo + base + ferramentas)
        → decide: responder ou passar para humano
   n8n → Cloud API → WhatsApp → Cliente

1. Entrada: webhook e filtro

O WhatsApp Trigger do n8n recebe o evento. Antes de chamar a IA, o fluxo precisa:

  • separar mensagem de cliente de aviso de status (enviada, entregue, lida), que chegam pelo mesmo canal;
  • agrupar mensagens em sequência. Muita gente manda três mensagens curtas seguidas. Esperar alguns segundos e juntar evita três respostas atravessadas;
  • tratar duplicidade pelo identificador da mensagem, para não responder duas vezes;
  • transcrever áudio, se a empresa aceitar áudio — e o cliente brasileiro manda áudio.

Atenção: a Meta aceita um webhook só por aplicativo, então a URL de teste e a de produção do n8n se sobrescrevem.

2. Memória da conversa

O modelo não lembra nada sozinho. A cada mensagem, o n8n busca as últimas trocas daquele número e envia junto. Para produção, guarde a memória num banco — o n8n tem nó de memória em PostgreSQL —, e não na memória do processo, que some quando o servidor reinicia.

3. Base de conhecimento

É o que o agente pode afirmar: catálogo, prazos, política de troca, horários, perguntas frequentes. Os documentos são divididos em trechos e indexados num banco vetorial; a cada pergunta, o fluxo busca os trechos mais parecidos e entrega ao modelo. Essa técnica se chama RAG. O n8n tem nós para isso, inclusive com PostgreSQL, o que permite usar o mesmo banco.

A base precisa de dono. Preço que mudou e não foi atualizado vira resposta errada dita com segurança.

4. Ferramentas

Ferramentas são as ações que o agente pode chamar: consultar pedido no ERP, ver estoque, abrir chamado, marcar visita. No n8n, cada ferramenta pode ser uma requisição HTTP ou um subfluxo. Regra de ouro: número que importa vem de ferramenta, não do modelo. Preço, saldo, prazo e status de pedido o agente consulta; nunca deduz.

5. Passagem para humano

O agente precisa saber a hora de sair. Defina gatilhos claros: o cliente pediu uma pessoa, reclamou, a pergunta não está na base, ou envolve dinheiro, contrato ou exceção. Nesse momento, o fluxo marca a conversa como “em atendimento humano”, para de responder e avisa a equipe — numa caixa de entrada compartilhada (o Chatwoot é uma opção de código aberto) ou num grupo interno. Quando a pessoa encerra, o agente volta.

Quanto custa por conversa: um exemplo com conta

Premissas, para você trocar pelas suas na calculadora de custo de IA:

  • 1.000 conversas por mês, todas iniciadas pelo cliente, num número só;
  • 6 mensagens do cliente e 6 respostas do agente por conversa;
  • cada resposta usa 2 chamadas ao modelo (uma para decidir a ferramenta, outra para responder), com cerca de 5 mil tokens de entrada (instruções, trechos da base e histórico) e 250 de saída;
  • por conversa: 12 chamadas, 60 mil tokens de entrada e 3 mil de saída.

Preços conferidos em novembro de 2026: Claude Sonnet 5.5 a US$ 2 por milhão de tokens de entrada e US$ 10 por milhão de saída; Claude Haiku 5.5 a US$ 0,10 e US$ 0,50. n8n Cloud Pro 10k a 50 € por mês (anual). Câmbio: US$ 1 = R$ 5,42 e 1 € = R$ 6,05 (PTAX de 30/10/2026).

ItemContaPor mêsPor conversa
Modelo (Sonnet 5.5)1.000 × (60 mil × US$ 2 + 3 mil × US$ 10) ÷ 1 milhão = US$ 150R$ 813R$ 0,81
WhatsApp (serviço)(6.000 − 1.000 grátis) × US$ 0,0068 = US$ 34R$ 184R$ 0,18
n8n Cloud Pro 10k6.000 execuções, uma por mensagem recebidaR$ 302,50R$ 0,30
TotalR$ 1.299,50R$ 1,30

Com o modelo menor, o Haiku 5.5, a linha do modelo cai de US$ 150 para US$ 7,50 (R$ 41), e o total vai para cerca de R$ 527,50 por mês, ou R$ 0,53 por conversa. O modelo menor erra mais em pergunta difícil; teste com conversas reais antes de escolher pelo preço.

O que o exemplo mostra:

  • O modelo é a linha que mais pesa, e é a mais sensível ao desenho. Prompt inchado, histórico inteiro a cada mensagem e trecho demais da base multiplicam os tokens. O cache de prompt dos provedores barateia a parte fixa das instruções.
  • O n8n pode estourar sem você perceber. Se os avisos de status dispararem o fluxo, cada resposta gera até três execuções a mais, e as 6 mil viram 24 mil. Aí o plano precisa ser o Pro 50k, de R$ 731. Comparamos Cloud e servidor próprio em quanto custa o n8n.
  • A conta não inclui construir o agente, manter a base nem a equipe que assume as conversas passadas para humano.

O que dá errado (e como evitar)

Alucinação

O modelo preenche lacuna com texto plausível. No atendimento, isso é prazo inventado, desconto que não existe, especificação técnica errada. Como reduzir:

  • instrua o agente a responder só com o que veio da base e das ferramentas, e a dizer “vou confirmar com a equipe” quando não achar;
  • tire do modelo tudo o que é número: preço, prazo e estoque vêm de ferramenta;
  • revise uma amostra de conversas toda semana nas primeiras semanas. É o único jeito de achar o erro que ninguém reclamou.

Prompt sem limite

Um agente sem limites conversa sobre qualquer coisa, aceita “ignore as instruções anteriores” e entra em laço chamando ferramenta. Defina:

  • escopo — o que ele atende e o que recusa;
  • teto de iterações por mensagem e de tamanho da resposta;
  • ferramentas com o mínimo de permissão. Consultar pedido, sim; cancelar pedido, só com confirmação. O n8n tem aprovação humana para chamadas de ferramenta, o que serve para as ações que escrevem em sistema;
  • limite por número, contra quem tenta usar o seu agente como chatbot grátis.

Dado sensível e LGPD

Cliente manda CPF, endereço, foto de documento, às vezes dado de saúde. Tudo isso passa pelo n8n e vai para o provedor do modelo. A LGPD não proíbe o agente, mas exige o básico:

  • transparência: diga logo na primeira mensagem que o cliente está falando com um assistente automatizado e como chegar a uma pessoa;
  • necessidade: não peça o que o atendimento não precisa;
  • transferência internacional: os grandes provedores de modelo processam fora do Brasil. Isso exige base contratual adequada e precisa estar na sua política de privacidade;
  • retenção: o n8n guarda o histórico das execuções, com o conteúdo das mensagens. Defina por quanto tempo ele fica, na memória e na caixa de entrada também, e quem acessa.

Quando não vale montar um agente

O agente compensa com volume de perguntas repetidas cuja resposta depende de dado que existe em algum sistema. Não compensa quando:

  • chegam poucas conversas por dia. Uma pessoa com respostas rápidas salvas sai mais barato;
  • cada atendimento é uma negociação. Venda técnica pede gente; o agente faz no máximo a triagem;
  • ninguém vai cuidar da base de conhecimento. Agente com informação velha é pior que nenhum.

Os casos de IA que se pagam têm um padrão — volume, entrada não estruturada, regra existente e erro verificável —, descrito em onde a IA realmente gera retorno na indústria. E, se a dúvida é o custo de um atendimento com IA de forma mais ampla, veja quanto custa um chatbot com IA para empresas.

Perguntas frequentes

Dá para fazer um agente de IA no WhatsApp com n8n sem programar?

Dá para montar um protótipo só com os nós do n8n: WhatsApp Trigger, agente de IA, memória e envio pela Cloud API. Para produção, com filtro de status, duplicidade, passagem para humano e ferramentas ligadas ao ERP, alguém com conhecimento técnico precisa desenhar e manter.

Preciso da API oficial do WhatsApp Business?

Para empresa, sim. As soluções não oficiais, que conectam pelo WhatsApp Web, violam os Termos de Serviço do WhatsApp e podem levar ao banimento do número. A API oficial cobra por mensagem, mas tem 1.000 mensagens de serviço grátis por mês por número.

Quanto custa a API do WhatsApp Business em 2026?

A Meta cobra por mensagem entregue. Respostas dentro da janela de 24 horas são mensagens de serviço: 1.000 grátis por mês por número e, no exemplo da Meta para o Brasil, US$ 0,0068 por mensagem depois disso. Modelos de marketing custam bem mais. Confira a tabela oficial antes de orçar.

O agente pode iniciar a conversa com o cliente?

Pode, mas só com modelo de mensagem aprovado pela Meta e pago por mensagem — de utilidade, como aviso de pedido, ou de marketing. Texto livre só é permitido dentro da janela de 24 horas aberta pelo cliente.

Qual modelo de IA usar no WhatsApp?

O menor que acerte as suas perguntas reais. Separe 50 a 100 perguntas de clientes com a resposta certa e compare os modelos nelas. O maior só se justifica onde o menor erra.


Quer saber se um agente no WhatsApp se paga na sua operação, e o que ele deveria responder? Agende um diagnóstico ou veja a frente de IA aplicada.

agente de iawhatsappn8nwhatsapp businessatendimentolgpd

Pronto para destravar a sua operação?

Agende um diagnóstico: a gente mapeia os gargalos e mostra por onde começar.

Agende um diagnóstico