Como conectar o WhatsApp a um assistente pela Cloud API da Meta?
Você cria um app no painel de desenvolvedores da Meta, adiciona o produto WhatsApp, aponta o webhook para o sistema que escreve as respostas e inscreve o app na conta do WhatsApp Business. A partir daí, as mensagens chegam ao seu sistema e o assistente responde pela Cloud API dentro da janela de atendimento de 24 horas. O número, a conta da Meta e o histórico continuam sendo da empresa.
A maioria das primeiras configurações trava na configuração, não no assistente: um app que nunca foi inscrito na conta comercial, um número no formato errado ou um número de teste que não entrega para alguns países.
Como funciona
Criar o app na Meta
No painel de desenvolvedores da Meta, crie um app do tipo Business e adicione o produto WhatsApp. A Meta oferece um número de teste gratuito e permite cadastrar até cinco números que podem receber as respostas de teste.
Conectar o webhook
Informe a URL de retorno e um token de verificação e assine o campo messages. A partir daí, toda mensagem que o cliente envia é entregue ao seu sistema.
Inscrever o app na conta comercial
Chame POST /{WABA-ID}/subscribed_apps com o token do seu app. Sem esse passo, o webhook aparece como verificado, mas não recebe nada, e o painel não mostra o motivo.
Escrever as respostas
O sistema lê a mensagem, responde só com as informações da própria empresa (horários, preços, serviços, regras de agendamento) e envia a resposta com POST /{phone-number-id}/messages. O que ele não sabe, ou o que pede avaliação, vai para uma pessoa com um resumo curto.
Trocar o token temporário
O token de acesso do painel dura cerca de um dia. Para algo que precisa continuar funcionando, crie um usuário do sistema nas Configurações do Negócio e gere um token permanente com as permissões de mensagens e de gerenciamento do WhatsApp.
Passar para o número real e cadastrar o pagamento
Registre o número da própria empresa, cadastre uma forma de pagamento no Billing Hub e conclua a verificação da empresa na Meta quando ela pedir. É a verificação que aumenta quantas pessoas a empresa pode contatar primeiro por dia.
Quanto custa manter
A Meta cobra por mensagem entregue; as mensagens que os clientes enviam não são cobradas. O modelo que escreve as respostas é cobrado à parte pelo fornecedor dele. A Meta pode mudar as tarifas até uma vez por trimestre; confira a tabela do país de quem recebe.
| Item | Preço de tabela | Fonte |
|---|---|---|
| Mensagens que os clientes enviam para a empresa | Sem cobrança | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 10 Sep 2026)Consultado em 28 de set. de 2026 |
| Respostas dentro da janela de 24 horas (mensagens de serviço) | Gratuitas até 30/09/2026; cobradas por mensagem entregue a partir de 01/10/2026, com a mesma tarifa das mensagens de utilidade do país | Meta for Developers, Upcoming pricing updates for Meta Business Agent, service and utility messages (updated 25 Aug 2026)Consultado em 28 de set. de 2026 |
| Mensagem de utilidade ou de serviço para um usuário no Brasil | US$ 0,0068 por mensagem entregue (tarifa da Meta em 01/07/2026) | Meta for Developers, Upcoming pricing updates for Meta Business Agent, service and utility messages (updated 25 Aug 2026)Consultado em 28 de set. de 2026 |
| Modelos que a empresa envia primeiro (marketing, utilidade, autenticação) | Por mensagem entregue; a tarifa depende da categoria e do país de quem recebe | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 10 Sep 2026)Consultado em 28 de set. de 2026 |
| Mensagens nas 72 horas depois de um anúncio de clique para o WhatsApp | Gratuitas (janela de ponto de entrada gratuito) | Meta for Developers, Pricing on the WhatsApp Business Platform (updated 10 Sep 2026)Consultado em 28 de set. de 2026 |
| O modelo que escreve as respostas | Cobrado pelo fornecedor do modelo conforme o uso, separado da cobrança de entrega da Meta | Meta for Developers, Upcoming pricing updates for Meta Business Agent, service and utility messages (updated 25 Aug 2026)Consultado em 28 de set. de 2026 |
Preços de tabela de terceiros, consultados na data indicada. Não são preços da Betterlane.
O que aprendemos montando
Da nossa clínica de demonstração fictícia, montada num número de teste da Meta em setembro de 2026. Não é um sistema de cliente.
- O webhook estava verificado, mas nada chegava
- A conta comercial de teste estava inscrita só no app de exemplo da própria Meta. Uma chamada a /subscribed_apps com o nosso app resolveu.
- Erro 131030: destinatário fora da lista permitida
- Os celulares brasileiros chegavam ao webhook sem o nono dígito (12 dígitos), enquanto a lista permitida guardava o número com ele (13 dígitos). As respostas falharam até a etapa de envio recolocar o 9.
- Erro 130497: envio bloqueado para um país
- Um número de teste de uma empresa não verificada não conseguia entregar para um número brasileiro. O assistente escreveu todas as respostas; a Meta recusou a entrega. Teste com um número de outro país ou use a conta verificada e o número real da empresa.
- O token venceu durante a noite
- O token do painel dura cerca de um dia. O token permanente de usuário do sistema é a primeira coisa a configurar em algo que precisa continuar respondendo.
Quando não vale a pena
- Se a empresa recebe poucas mensagens por semana, uma pessoa respondendo pelo app WhatsApp Business é mais simples e não exige configuração.
- Se as respostas dependem de informações que ninguém escreveu (preços, regras, disponibilidade), escreva primeiro: o assistente só responde com o que recebe.
- Se o objetivo é contatar pessoas que nunca escreveram para a empresa, isso é envio de modelos com consentimento, um projeto diferente de um assistente que responde.
Perguntas
Preciso de um provedor de soluções (BSP)?
Não. A Cloud API é hospedada pela Meta e pode ser usada diretamente pela empresa. Um provedor pode ajudar com cobrança e suporte, mas não é obrigatório.
O que muda em 1º de outubro de 2026?
A Meta passa a cobrar por mensagem entregue as mensagens de serviço, as respostas dentro da janela de 24 horas, que eram gratuitas desde novembro de 2024. Segundo a Meta, contas sem forma de pagamento cadastrada até 30/09/2026 deixam de ter essas mensagens entregues.
O assistente pode responder dúvidas de saúde, jurídicas ou de pagamento?
Ele não deve decidir essas questões. Uma configuração cuidadosa responde só com o que a empresa aprovou e passa para uma pessoa, com um resumo, tudo o que for clínico, jurídico, financeiro ou fora do comum.
Quem fica com o número e as conversas?
A empresa. O app, a conta do WhatsApp Business, o número e o histórico devem ficar na conta da Meta da própria empresa, não na de quem implementa.
Quer um assistente assim no seu número e na sua conta da Meta?
Ver o serviço: Assistentes para WhatsAppFale com a genteTodos os guias
- O que um agente de voz deve atender, e o que precisa passar para uma pessoa?
- O que um chatbot faz no site de uma pequena empresa, e quando vale a pena?
- Como automatizar a caixa de suporte sem enviar uma resposta errada?
- n8n, Zapier ou Make: qual escolher para uma pequena empresa?
- Como extrair dados de centenas de PDFs?
- Como montar um relatório que se atualiza sozinho quando os dados mudam?
- Como um assistente interno responde com os documentos da empresa sem inventar?
- Como automatizar a produção de conteúdo sem perder o controle editorial?
- Como montar uma lista de prospects com fontes, sem comprar uma?
- O que um site de pequena empresa precisa para ser encontrado pelo Google e pelo ChatGPT?
- Quando uma empresa precisa de um portal do cliente em vez de e-mail?
- Quando vale tirar um processo da planilha e levar para uma ferramenta interna?
- Por que o meu fluxo do n8n roda duas vezes para a mesma coisa?
- Meu fluxo do n8n funcionava e agora falha com 401 ou 403. Por quê?
- Como saber quando um fluxo do n8n falha em silêncio?