A WhatsApp Cloud API é a versão da API oficial do WhatsApp hospedada pela própria Meta. A empresa não precisa manter servidores: integra seus sistemas pela Graph API, recebe mensagens e status por webhooks e paga só as tarifas por mensagem. Desde 23 de outubro de 2025, é a única forma de usar a API oficial, porque a versão On-Premises foi descontinuada. Cada número começa com capacidade de 80 mensagens por segundo, que pode chegar a 1.000. Empresas podem integrar direto, com desenvolvedores, ou usar uma plataforma pronta que já roda sobre a Cloud API.
Quem pesquisa sobre a API oficial do WhatsApp encontra vários nomes: API Business, On-Premises, Cloud API, BSP, WABA. Na prática, hoje existe um único caminho oficial para empresas integrarem sistemas ao WhatsApp, e ele se chama WhatsApp Cloud API.
Neste guia, você vai entender o que é a Cloud API, como ela funciona por dentro, o que dá para fazer, os limites, quanto custa, como começar (direto ou por uma plataforma), os erros mais comuns e os cuidados de segurança. O conteúdo serve tanto para o gestor que vai decidir quanto para o desenvolvedor que vai integrar.
O que é a WhatsApp Cloud API
É a interface de programação oficial da Meta que permite que sistemas de empresas enviem e recebam mensagens no WhatsApp. “Cloud” significa que a infraestrutura fica na nuvem da Meta: a empresa não instala nem mantém servidores do WhatsApp, apenas faz chamadas à API e recebe as notificações.
É sobre a Cloud API que funcionam as plataformas de atendimento, chatbots e CRMs oficiais do mercado. Quando uma ferramenta diz que usa a “API oficial do WhatsApp”, na prática ela está usando a Cloud API.
Cloud API, On-Premises, aplicativo e ferramentas não oficiais
| Cloud API | On-Premises API | WhatsApp Business (app) | Ferramentas pelo QR code | |
|---|---|---|---|---|
| Situação | Ativa, recebe todas as novidades | Descontinuada em 23/10/2025 | Ativo | Não autorizadas |
| Onde roda | Nuvem da Meta | Servidores da empresa | Celular | WhatsApp Web automatizado |
| Integração com sistemas | Sim, por API e webhooks | Sim (até a descontinuação) | Não | Sim, fora das regras |
| Custo de infraestrutura | Nenhum; hospedagem da Meta | Servidores próprios | Nenhum | Mensalidade do fornecedor |
| Risco de banimento pela ferramenta | Não | Não | Não | Alto |
A Meta parou de lançar novidades na On-Premises em janeiro de 2024, deixou de registrar novos números nela em julho de 2024 e encerrou o envio de mensagens em 23 de outubro de 2025. Quem ainda tinha números na On-Premises precisou migrar para a Cloud API.
Como a Cloud API funciona por dentro
Os componentes
| Componente | O que é |
|---|---|
| Portfólio empresarial | A conta da empresa no gerenciador de negócios da Meta, onde fica a verificação do CNPJ |
| Conta do WhatsApp Business (WABA) | A conta que agrupa os números, os modelos de mensagem e a cobrança |
| Número de telefone | O número da empresa registrado na Cloud API, com um identificador próprio |
| Aplicativo na Meta for Developers | O app que dá acesso à API e onde se configuram os webhooks |
| Token de acesso | A credencial que autoriza o sistema a chamar a API; em produção, um token de usuário do sistema |
| Webhook | O endereço do seu sistema que recebe mensagens e status em tempo real |
| Modelos de mensagem | Textos aprovados pela Meta para mensagens iniciadas pela empresa |
O fluxo de uma mensagem
- O cliente manda uma mensagem para o número da empresa.
- A Meta envia essa mensagem para o webhook do seu sistema (ou da plataforma que você usa).
- O sistema processa: chatbot, distribuição para atendente, registro no CRM.
- A resposta volta por uma chamada à API, com o identificador do número e o conteúdo.
- A Meta entrega a mensagem e avisa pelo webhook cada mudança de status: enviada, entregue, lida ou com falha.
O que dá para fazer com a Cloud API
- Mensagens de texto, imagem, vídeo, áudio, documento, localização e contato.
- Mensagens interativas: até 3 botões de resposta, listas com até 10 itens e botões com link.
- Modelos de mensagem: para falar com o cliente fora da janela de 24 horas, com variáveis, mídia no cabeçalho e botões.
- WhatsApp Flows: formulários com várias telas dentro do WhatsApp, para agendamentos, cadastros e pesquisas.
- Status de entrega e leitura: por webhook, para cada mensagem.
- Gestão de modelos e do perfil comercial pela própria API.
- Coexistência: em números elegíveis, usar o aplicativo WhatsApp Business e a Cloud API no mesmo número.
Veja como esses recursos viram atendimento na prática no guia de menu interativo no WhatsApp.
Limites técnicos e de uso
| Limite | Como funciona |
|---|---|
| Capacidade (throughput) | 80 mensagens por segundo por número, contando entrada e saída. Números elegíveis sobem automaticamente para 1.000 por segundo |
| Números em coexistência | Capacidade fixa de 20 mensagens por segundo |
| Limite de envio | Quantos clientes diferentes a empresa pode contatar por iniciativa própria em 24 horas, por portfólio: 250, 2.000, 10.000, 100.000 ou ilimitado |
| Janela de atendimento | Mensagens livres só em até 24 horas após a última mensagem do cliente; fora disso, só modelos aprovados |
| Qualidade | Bloqueios e denúncias afetam a avaliação da conta e dos modelos |
| Inteligência artificial | Desde janeiro de 2026, assistentes de IA de uso geral são proibidos; IA focada no atendimento da empresa é permitida |
Para subir para 1.000 mensagens por segundo, a Meta exige portfólio com limite de envio ilimitado, volume de pelo menos 100 mil clientes únicos fora da janela de atendimento em 24 horas e qualidade média ou alta. Para a maioria das empresas, 80 por segundo é muito mais do que o necessário.
Quanto custa a Cloud API
A hospedagem é gratuita. A Meta cobra por mensagem entregue, conforme a categoria. No Brasil, em reais desde julho de 2026:
| Categoria | Preço por mensagem |
|---|---|
| Marketing | R$ 0,3217 |
| Utilidade | R$ 0,035 |
| Autenticação | R$ 0,035 |
| Serviço (respostas na janela de 24h) | 1.000 grátis por mês por número; depois, R$ 0,035 |
Conversas iniciadas por anúncios de clique para WhatsApp têm uma janela gratuita de até 7 dias. Os detalhes estão em nova cobrança do WhatsApp em outubro. Além das tarifas, entra na conta o custo de quem desenvolve e mantém a integração, ou a mensalidade de uma plataforma pronta.
Como começar: integração direta ou plataforma pronta
| Integração direta | Plataforma pronta sobre a Cloud API | |
|---|---|---|
| Para quem | Empresas com equipe de desenvolvimento e necessidades muito específicas | Empresas que querem atender, automatizar e vender sem desenvolver |
| Tempo até funcionar | Semanas, para ter atendimento, chatbot e painel | Dias, principalmente pela verificação da empresa |
| Painel de atendimento | Precisa ser construído | Pronto, com vários atendentes |
| Chatbot, CRM e campanhas | Precisam ser construídos ou integrados | Incluídos ou como módulos |
| Manutenção e novas versões da API | Equipe da empresa | Fornecedor |
| Custo | Tarifas da Meta mais desenvolvimento e manutenção | Tarifas da Meta mais mensalidade |
Passo a passo da integração direta (visão geral)
- Crie ou use um portfólio empresarial e faça a verificação da empresa.
- Crie um app na Meta for Developers e adicione o produto WhatsApp. A Meta oferece um número de teste para os primeiros envios.
- Adicione o número da empresa à conta do WhatsApp Business e registre-o na Cloud API, definindo o PIN de confirmação em duas etapas.
- Gere um token de usuário do sistema com as permissões do WhatsApp, para uso em produção.
- Configure o webhook: um endereço HTTPS público que responde à verificação da Meta e recebe os eventos de mensagens.
- Crie e aprove os modelos de mensagem que o sistema vai usar.
- Envie a primeira mensagem e confirme o status pelo webhook.
Exemplo de envio de um modelo pela API, em formato genérico:
POST https://graph.facebook.com/{versão}/{id-do-número}/messages
Authorization: Bearer {token}
Content-Type: application/json
{
"messaging_product": "whatsapp",
"to": "5516999999999",
"type": "template",
"template": {
"name": "confirmacao_pedido",
"language": { "code": "pt_BR" },
"components": [{
"type": "body",
"parameters": [
{ "type": "text", "text": "Ana" },
{ "type": "text", "text": "12345" }
]
}]
}
}Use sempre a versão mais recente da Graph API indicada na documentação da Meta.
Boas práticas com webhooks
- Responda rápido: devolva HTTP 200 imediatamente e processe o evento depois, em uma fila. Respostas lentas fazem a Meta reenviar o evento.
- Trate duplicidades: o mesmo evento pode chegar mais de uma vez. Use o identificador da mensagem para não processar duas vezes.
- Valide a assinatura: confira o cabeçalho de assinatura enviado pela Meta para garantir que o evento é legítimo.
- Registre os status: enviada, entregue, lida e falha. Eles mostram a entrega real e ajudam a conferir a fatura.
- Monitore falhas: alertas para quando o webhook ficar fora do ar ou os erros aumentarem.
Erros comuns na Cloud API
| Código | Significado | O que fazer |
|---|---|---|
| 131047 | Mais de 24 horas desde a última mensagem do cliente | Usar um modelo aprovado em vez de mensagem livre |
| 131049 | Mensagem de marketing não entregue para manter a experiência do usuário | Reduzir a frequência de marketing para esse cliente e tentar mais tarde |
| 130429 | Capacidade de envio excedida | Distribuir os envios no tempo, respeitando o limite por segundo |
| 131026 | Mensagem não entregue ao destinatário | Verificar se o número tem WhatsApp e se o aplicativo está atualizado |
| 132000 | Quantidade de parâmetros diferente da definida no modelo | Conferir as variáveis enviadas com as do modelo aprovado |
Segurança e LGPD
- Guarde o token em local seguro: nunca no código-fonte ou no navegador. Quem tem o token pode enviar mensagens em nome da empresa.
- Restrinja permissões: o usuário do sistema deve ter só as permissões necessárias.
- Proteja o webhook: HTTPS, validação da assinatura e registro de acessos.
- Colete só o necessário: e defina por quanto tempo as conversas e mídias ficam armazenadas.
- Registre as autorizações: campanhas de marketing só para quem aceitou receber, com data e canal.
Cloud API com o Azallon Dispara PRO
Para quem não quer desenvolver a integração, o Azallon Dispara PRO é uma plataforma pronta que funciona na API oficial da Meta: atendimento com vários usuários no mesmo número, chatbot com menus, CRM com funil e campanhas com modelos aprovados. A conexão do número, os modelos e a configuração são feitos com a ajuda da equipe da Azallon, com o número atual da empresa, por R$ 167 por mês e sem taxa de implantação.
Para entender o que muda ao contratar a API oficial, veja como contratar a API oficial do WhatsApp.
Conclusão
A WhatsApp Cloud API é hoje o único caminho oficial para integrar sistemas ao WhatsApp: hospedada pela Meta, sem servidores para manter, com cobrança por mensagem e recursos como botões, listas, Flows e status de entrega. A capacidade de 80 mensagens por segundo atende a grande maioria das empresas, e os limites que realmente importam no dia a dia são o limite de envio, a janela de 24 horas e a qualidade da conta.
A decisão principal não é técnica: é entre integrar direto, com equipe própria, ou usar uma plataforma pronta. Para a maioria das pequenas e médias empresas, a plataforma pronta chega ao resultado mais rápido e com menos custo de manutenção.
FAQ – Perguntas frequentes sobre a WhatsApp Cloud API
O que é a WhatsApp Cloud API?
É a API oficial do WhatsApp hospedada pela Meta, que permite que sistemas de empresas enviem e recebam mensagens sem manter servidores próprios.
A WhatsApp Cloud API é gratuita?
A hospedagem é gratuita, mas a Meta cobra por mensagem entregue. No Brasil, R$ 0,3217 por marketing e R$ 0,035 por utilidade, autenticação e atendimento acima da franquia de 1.000 respostas por mês por número.
Qual a diferença entre Cloud API e On-Premises?
A On-Premises rodava em servidores da empresa e foi descontinuada em 23 de outubro de 2025. A Cloud API roda na nuvem da Meta e é a única versão ativa.
Quantas mensagens por segundo a Cloud API envia?
80 mensagens por segundo por número, podendo subir automaticamente para 1.000 em números elegíveis. Números em coexistência têm 20 por segundo.
Preciso de programador para usar a Cloud API?
Para integrar direto, sim. Para atender, automatizar e fazer campanhas sem desenvolver, existem plataformas prontas que funcionam sobre a Cloud API.
Posso usar o mesmo número no aplicativo e na Cloud API?
Em números elegíveis, sim, com a coexistência. Nesse caso, a capacidade fica em 20 mensagens por segundo.
Como receber as mensagens dos clientes na Cloud API?
Por webhook: a Meta envia cada mensagem e cada mudança de status para um endereço HTTPS do seu sistema ou da plataforma que você usa.
