WhatsApp Cloud API explicada para quem vai disparar mensagens

O que é a WhatsApp Cloud API?

A WhatsApp Cloud API é a interface de programação da WhatsApp Business Platform, a plataforma da Meta para empresas. Segundo a documentação da Meta, ela serve para enviar e receber mensagens do WhatsApp a partir do número comercial da empresa. Quem conversa com ela é um sistema (um CRM, uma plataforma de atendimento, uma ferramenta de disparo), não uma pessoa digitando no aplicativo.

Antes dela existia a On-Premises API, que a empresa instalava e mantinha em servidor próprio. A Meta encerrou esse modelo: desde 1º de julho de 2024 os números novos só podem ser registrados na Cloud API, e a última versão da On-Premises expirou em 23 de outubro de 2025, quando as mensagens de números que ainda estavam nela deixaram de ser entregues. Hoje a Meta descreve a plataforma como totalmente hospedada em nuvem.

Para quem contrata disparo, o resumo é simples: Cloud API é a porta oficial por onde o disparo em massa passa. Tudo o que a Meta cobra, limita ou pausa acontece nela. Se a sua dúvida é mais ampla (o que é a API oficial e como contratar), a página sobre a API oficial do WhatsApp cobre o caminho completo.

Cloud API, WhatsApp Business Platform e API oficial são a mesma coisa?

Os nomes se misturam em propostas e em conversas de vendas. Esta tabela separa cada um deles:

Na prática, quando alguém fala em disparo pela API oficial, está falando de mensagens enviadas pela Cloud API. Se você ainda compara esse caminho com extensões e programas não oficiais, leia API oficial ou não oficial: os Termos do WhatsApp proíbem o envio em massa automatizado fora dos meios autorizados, e a Cloud API é o meio autorizado.

Como a Cloud API funciona por dentro?

Por trás de uma mensagem enviada existem cinco peças. Entender cada uma ajuda a saber onde o problema está quando algo não sai:

• App na Meta: criado no painel de desenvolvedores com o caso de uso do WhatsApp. É onde ficam as credenciais e as configurações.
• Portfólio empresarial: a empresa dentro da Meta (muita gente ainda chama de BM). Veja BM do Facebook para WhatsApp.
• Conta do WhatsApp Business (WABA): a documentação atual chama de Messaging account. Reúne os números, os templates e as configurações de envio.
• Número comercial: o remetente das mensagens. As regras de quais números servem estão em número para API oficial do WhatsApp.
• Token e webhook: o token autoriza o sistema a enviar; o webhook é o endereço que recebe as respostas dos clientes e os status de cada mensagem.

O envio em si é uma chamada ao endpoint de mensagens do número, no Graph API da Meta, com o destinatário e o conteúdo. A resposta do cliente e o status (enviada, entregue, lida, falhou) voltam por webhook, como explica webhook do WhatsApp API. Para uso real, a Meta orienta criar um usuário do sistema em Business Settings e gerar um token permanente, com as permissões business_management, whatsapp_business_messaging e whatsapp_business_management. O token temporário do painel expira rápido e serve só para teste.

O que a Cloud API permite e quais são os limites?

Quanto custa usar a WhatsApp Cloud API?

Na Cloud API, o custo que vem da Meta está nas mensagens. Desde 01/07/2025 a Meta cobra por mensagem entregue, conforme a categoria (marketing, utilidade ou autenticação) e o país de quem recebe; a mensagem que o cliente manda para a empresa não é cobrada. Os valores de cada categoria ficam na tabela oficial da Meta, que muda com o tempo, e por isso este guia não cita preço em reais. O que é e o que não é grátis está em API oficial do WhatsApp é grátis?.

Preciso de um provedor para usar a Cloud API?

A Cloud API é aberta a qualquer empresa que cumpra as políticas da Meta. Você não é obrigado a passar por um intermediário, mas na prática existem três caminhos:

• Integrar direto: um time técnico cria o app, gera o token, mantém o webhook e acompanha as mudanças da Meta. Faz sentido para quem tem desenvolvedores e um produto próprio em cima do WhatsApp.
• Usar a ferramenta de um provedor: o provedor oferece telas prontas para templates, envio e atendimento. Para entender os papéis e escolher bem, leia o que é BSP no WhatsApp.
• Terceirizar o disparo: você envia a base e a copy, e a campanha sai da estrutura de quem presta o serviço. Esse é o caminho do disparo em massa terceirizado.

Os caminhos não se excluem. Muita empresa usa uma API própria para o atendimento do dia a dia e entrega as campanhas grandes a quem já tem a operação pronta. A comparação de custo e esforço está em terceirizar ou fazer disparo próprio.

Como ir do zero ao primeiro envio pela Cloud API?

1. 1
   Criar o app e o portfólio

   No painel de desenvolvedores da Meta, crie um app com o caso de uso do WhatsApp e escolha o portfólio empresarial da empresa (ou crie um).

2. 2
   Verificar a empresa

   A verificação libera mais números, mais templates e o caminho para limites maiores. O passo a passo está em verificação da empresa na Meta.

3. 3
   Registrar o número

   Informe o nome de exibição, confirme o número por SMS ou ligação e defina o PIN da verificação em duas etapas, que a Meta exige no registro.

4. 4
   Gerar o token permanente

   Crie o usuário do sistema, dê acesso ao app e à conta do WhatsApp e guarde o token em lugar seguro. Nunca coloque o token em planilha ou em mensagem de chat.

5. 5
   Configurar o webhook

   Sem webhook, as respostas dos clientes e os status de entrega não chegam ao seu sistema. Teste com uma mensagem de ida e volta.

6. 6
   Criar o template e testar

   A análise de um template pode levar até 24 horas. Com o template aprovado, envie para números reais da equipe e confira variáveis, mídia e links antes de qualquer base.

Quais erros mais atrasam quem começa com a Cloud API?

• Deixar o token temporário em produção. Ele expira rápido e o envio para de funcionar sem aviso na hora.
• Tentar registrar um número que ainda está no aplicativo. A Meta não registra número em uso no WhatsApp sem excluí-lo antes (ou sem usar a coexistência).
• Esquecer a forma de pagamento. Sem ela o envio falha com o erro 131042, de método de pagamento. Veja forma de pagamento do WhatsApp API.
• Escrever template com variável no começo ou no fim do texto. É um dos motivos de rejeição listados pela Meta. Veja template reprovado.
• Não ter webhook. O disparo sai, mas ninguém vê quem respondeu.
• Disparar para quem não deu opt-in. A política exige que a pessoa tenha autorizado receber mensagens da empresa. Veja opt-in no WhatsApp.

[ ] Portfólio empresarial na Meta criado e com administradores corretos
[ ] Empresa verificada (ou pedido de verificação enviado)
[ ] Número definido: ______ (próprio, com DDI e DDD, recebe SMS ou ligação)
[ ] Número fora do aplicativo do WhatsApp (ou coexistência escolhida de propósito)
[ ] Nome de exibição escolhido: ______
[ ] PIN de verificação em duas etapas guardado em local seguro
[ ] Forma de pagamento cadastrada na Meta
[ ] App criado e conta do WhatsApp Business vinculada
[ ] Usuário do sistema criado e token permanente guardado
[ ] Webhook configurado e testado (mensagem de ida e volta)
[ ] Pelo menos 1 template enviado para análise (prazo de até 24 horas)
[ ] Lista de contatos com opt-in e regra de saída definida
[ ] Quem atende as respostas: ______

Como a AD PRO usa a Cloud API no seu disparo?

Quando a Cloud API precisa existir na sua própria conta (para o atendimento diário, por exemplo), a AD PRO faz a estruturação da API oficial na estrutura do cliente, com valor base de R$ 2.000, sem incluir custos da Meta, de provedores e de ferramentas. Se as respostas dos disparos precisam cair num CRM, veja a implementação de CRM. Para o valor do disparo por volume, consulte quanto custa disparo em massa. O resumo de tudo está no hub de disparo em massa.