Como conectar um modelo de IA ao WhatsApp pela API da Meta
A Cloud API do WhatsApp da Meta liga seu número a um webhook que recebe e envia mensagens em JSON; o LLM entra como o cérebro que lê a mensagem recebida, decide a resposta (ou chama uma função) e devolve o texto pela mesma API, respeitando a janela de 24 horas e as regras de template fora dela.
Monte o seu agente e veja ele respondendo com as informações do seu negócio.
Criar meu agente de graça Montar é livre, sem cadastro e sem cartão.O que você vai encontrar neste artigo
Em resumo
- A Cloud API da Meta manda mensagens por webhook em JSON, sem app instalado no celular.
- O LLM fica entre o webhook e a resposta: lê o texto, decide o que fazer, devolve o texto pronto.
- Fora da janela de 24h após a última mensagem do cliente, só template aprovado reabre a conversa.
O que é a cloud API do WhatsApp da meta
A Cloud API é o jeito oficial da Meta de ligar um número de telefone ao WhatsApp sem precisar de um celular ligado o tempo todo. Ela roda nos servidores da Meta, não no seu aparelho. Você manda e recebe mensagem por chamadas HTTP para a Graph API, o mesmo sistema usado por Facebook e Instagram.
Existem duas formas de acessar: direto pela Meta, com conta no Meta for Developers, ou por um BSP (parceiro de negócio, sigla de Business Solution Provider). O BSP cobra uma taxa extra, mas cuida de parte da aprovação de template e do suporte quando algo trava.
Como funciona o webhook do WhatsApp business API
Quando alguém manda mensagem pro seu número, a Meta faz uma chamada POST pra um endereço da web que você cadastrou como webhook. Essa chamada chega em JSON, com o texto, o número de quem escreveu e o tipo de mensagem: texto, áudio, imagem ou botão clicado.
- O cliente manda mensagem pelo WhatsApp.
- A Meta envia essa mensagem pro seu webhook em JSON.
- Seu servidor lê o conteúdo e decide o que responder — é aqui que entra o LLM.
- Seu servidor chama a Graph API de volta pra entregar a resposta ao cliente.
Seu webhook precisa responder com status 200 em poucos segundos. Se demorar, a Meta considera falha e tenta de novo, o que pode duplicar mensagem na conversa.
O que são templates de mensagem no WhatsApp business API
Templates, também chamados de HSM (Highly Structured Message), são textos pré-aprovados pela Meta. Você cadastra o modelo com variáveis, manda pra revisão, e só depois de aprovado pode usá-lo pra iniciar uma conversa com o cliente.
Existem três categorias: marketing, utilidade (utility) e autenticação. Cada uma tem regra própria de aprovação e de frequência de envio. Marketing é a mais fiscalizada, porque é a que mais vira spam na caixa de entrada.
O que é a janela de 24 horas do WhatsApp
A janela de 24 horas conta a partir da última mensagem que o cliente mandou pra você. Dentro dela, você responde com texto livre, sem precisar de aprovação. Fora dela, só um template aprovado reabre a conversa.
| Situação | O que você pode enviar |
|---|---|
| Cliente escreveu há menos de 24h | Texto livre, imagem, áudio, botão — qualquer formato |
| Cliente escreveu há mais de 24h | Só template já aprovado pela Meta |
| Você quer começar a conversa sem o cliente ter escrito antes | Só template, categoria marketing ou utility |
Onde entra o LLM no meio do fluxo de mensagens
O LLM entra depois que o webhook recebe a mensagem, e antes da resposta ser enviada. Ele não fala direto com o WhatsApp: alguém no meio — seu código, ou uma ferramenta de automação — recebe o texto, monta o prompt com o histórico da conversa e manda pro modelo.
O modelo devolve texto puro ou uma chamada de função. Seu código pega essa saída, formata como mensagem do WhatsApp e chama a Graph API pra entregar. Se o agente precisa responder com base em catálogo ou manual da empresa, é nesse meio de campo que entra RAG: buscar o trecho certo antes de montar o prompt.
A Meta não guarda memória de conversa pra você. Se o LLM precisa lembrar o que foi dito antes, é você quem salva o histórico num banco e manda de volta a cada chamada.
Quanto custa usar a API oficial do WhatsApp da meta
A Meta cobra por conversa, não por mensagem solta. Uma conversa dura 24 horas e agrupa todas as trocas dentro dela, dividida por categoria: marketing, utility, authentication ou service. O valor exato e as regras de cada categoria mudam com frequência: consulte a página oficial de preços do WhatsApp antes de fechar conta.
Se você usa um BSP, some a taxa dele em cima do valor cobrado pela Meta. Peça o preço da conversa e o preço da assinatura do BSP em separado — é isso que muda a conta quando o volume de mensagem cresce.
Leia também
Perguntas frequentes
- Preciso de um BSP pra usar a API oficial do WhatsApp?
- Não. Dá pra acessar a Cloud API direto pela Meta, sem parceiro nenhum. Um BSP normalmente ajuda no suporte técnico e na aprovação de template, mas cobra uma taxa por isso.
- A Cloud API do WhatsApp tem plano gratuito?
- A Meta libera um volume inicial de conversa de serviço sem custo, mas os limites mudam com frequência. Confira a página oficial de preços antes de planejar o projeto.
- O LLM guarda o histórico da conversa sozinho?
- Não. Você precisa salvar as mensagens num banco de dados e mandar esse histórico de volta a cada chamada ao modelo.
- Preciso de aprovação da Meta pra usar IA generativa no WhatsApp?
- Não existe aprovação específica pra usar IA nas respostas. A aprovação da Meta vale só pra templates usados fora da janela de 24 horas.
