# WhatsApp Cloud API explicada para quem vai disparar mensagens

> A WhatsApp Cloud API é a interface da Meta, hospedada na nuvem, que permite a uma empresa enviar e receber mensagens do WhatsApp por meio de um sistema. É o caminho oficial para disparo em massa, com templates aprovados, limites e cobrança definidos pela Meta. A AD PRO dispara por ela na estrutura própria ou estrutura a API oficial na conta do cliente.

Página original: https://www.adprotecnologia.com.br/disparo-em-massa/whatsapp-cloud-api
Autor: AD PRO Tecnologia. Publicado em 2026-10-31. Atualizado em 2026-11-07.

## 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](https://www.adprotecnologia.com.br/crm/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:

**Os nomes que aparecem quando se fala de API do WhatsApp**

| Nome | O que é | Onde você vê |
| --- | --- | --- |
| API oficial do WhatsApp | Expressão do mercado para o uso autorizado pela Meta, com número comercial, templates e cobrança por mensagem | Propostas, sites de fornecedores, conversas comerciais |
| WhatsApp Business Platform | A plataforma da Meta, que reúne as APIs de mensagens e de chamadas | Documentação e políticas da Meta |
| Cloud API | A API de mensagens dessa plataforma, usada pelo número comercial da empresa | Parte técnica e telas de ferramentas conectadas |
| Aplicativo WhatsApp Business | Aplicativo de celular para pequenos negócios, operado por uma pessoa | Loja de aplicativos. Não é a API |
| Marketing Messages API | Variante da Cloud API para mensagens de marketing, com otimizações, usando o mesmo número (veja [Marketing Messages API](https://www.adprotecnologia.com.br/disparo-em-massa/marketing-messages-api-whatsapp)) | Painel e documentação da Meta |

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](https://www.adprotecnologia.com.br/crm/api-oficial-ou-nao-oficial-whatsapp): 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](https://www.adprotecnologia.com.br/disparo-em-massa/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](https://www.adprotecnologia.com.br/disparo-em-massa/numero-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](https://www.adprotecnologia.com.br/disparo-em-massa/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?

**Regras da Cloud API que mais afetam um disparo em massa**

| Tema | Regra oficial | O que muda na campanha |
| --- | --- | --- |
| Fora da janela de 24 horas | Só se envia template aprovado | Todo disparo em massa sai por template. Veja a [janela de 24 horas](https://www.adprotecnologia.com.br/crm/blog/janela-de-24-horas-do-whatsapp) |
| Limite de envio | Por portfólio: 250, 2.000, 10.000, 100.000 e ilimitado de pessoas diferentes em 24 horas | Base grande exige estrutura madura. Detalhes em [limite de envio do WhatsApp API](https://www.adprotecnologia.com.br/disparo-em-massa/limite-de-envio-whatsapp-api) |
| Velocidade | Até 80 mensagens por segundo por número. Sobe para 1.000 por segundo se o portfólio é ilimitado, o número contatou 100 mil pessoas ou mais em 24 horas e a qualidade é amarela ou melhor | Define em quanto tempo uma base grande sai |
| Templates por conta | 250 se o portfólio não é verificado; 6.000 se é verificado e o nome de exibição está aprovado | Quem faz muitas campanhas precisa verificar a empresa |
| Cobrança | Por mensagem entregue desde 1º de julho de 2025, por categoria e país do destinatário | Toda campanha pela API tem esse custo por trás. Veja [preço da API oficial](https://www.adprotecnologia.com.br/crm/blog/preco-da-api-oficial-do-whatsapp) |
| Marketing por pessoa | A Meta limita quantas mensagens de marketing cada pessoa recebe; o envio barrado volta com o erro 131049 | Insistir no mesmo contato não adianta. Veja [mensagem de marketing não entregue](https://www.adprotecnologia.com.br/crm/blog/mensagem-de-marketing-nao-entregue-whatsapp) |
| Coexistência (app e API no mesmo número) | Velocidade fixa de 20 mensagens por segundo; listas de transmissão do aplicativo ficam desativadas; grupos não são suportados | Serve para atendimento. Para disparo grande, número só da API |

## 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?](https://www.adprotecnologia.com.br/disparo-em-massa/api-oficial-do-whatsapp-gratis).

**Dois jeitos de pagar pela Cloud API numa campanha**

| Caminho | O que você paga | Quem cuida da estrutura |
| --- | --- | --- |
| Cloud API na sua própria conta | Tarifa da Meta por mensagem entregue + provedor ou sistema + estruturação (na AD PRO, valor base de R$ 2.000) | A sua empresa, com o portfólio, o número e os templates |
| Disparo pela estrutura da AD PRO | Um valor por disparo entregue, que já inclui a tarifa da Meta: média de R$ 0,35 até 10.000 e de R$ 0,25 a R$ 0,28 acima de 30.000 | A AD PRO, que trata a base, testa e dispara pela Cloud API |

## 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](https://www.adprotecnologia.com.br/disparo-em-massa/o-que-e-bsp-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](https://www.adprotecnologia.com.br/disparo-em-massa/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](https://www.adprotecnologia.com.br/disparo-em-massa/terceirizar-ou-fazer-disparo-proprio).

## Como ir do zero ao primeiro envio pela Cloud API?

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. **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](https://www.adprotecnologia.com.br/disparo-em-massa/como-verificar-a-empresa-na-meta).
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. **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. **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. **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](https://www.adprotecnologia.com.br/disparo-em-massa/forma-de-pagamento-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](https://www.adprotecnologia.com.br/crm/blog/template-reprovado-whatsapp).
- **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](https://www.adprotecnologia.com.br/crm/blog/opt-in-whatsapp).

**Ficha de pré-requisitos para ativar a Cloud API (copie e preencha)**

```text
[ ] 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?

> **Como a AD PRO faz:** Todo o passo a passo técnico desta página (app, token, webhook, número registrado) fica do lado da AD PRO, que dispara pela Cloud API na estrutura dela. Do seu lado ficam o conteúdo e a decisão: você manda a planilha de contatos, a copy, o criativo, o link e o objetivo, recebe o teste em números reais e aprova. Depois disso a campanha sai em lotes, na data e hora combinadas, e você recebe o relatório de entrega. A operação é feita com a Nexor Company, empresa parceira do mesmo grupo.

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](https://www.adprotecnologia.com.br/crm/implementacao-de-crm). Para o valor do disparo por volume, consulte [quanto custa disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa/quanto-custa-disparo-em-massa). O resumo de tudo está no [hub de disparo em massa](https://www.adprotecnologia.com.br/disparo-em-massa).

## Perguntas frequentes

### O que é a WhatsApp Cloud API?

É a interface da Meta, hospedada na nuvem, que permite a uma empresa enviar e receber mensagens do WhatsApp por meio de um sistema, a partir do número comercial dela. É a base da WhatsApp Business Platform e o caminho oficial para disparo em massa.

### Cloud API é a mesma coisa que API oficial do WhatsApp?

Na prática, sim. API oficial é a expressão que o mercado usa para o uso autorizado pela Meta, e hoje esse uso acontece pela Cloud API. A On-Premises API, modelo anterior, teve a última versão expirada em 23 de outubro de 2025.

### A Cloud API é gratuita?

A Meta cobra por mensagem entregue desde 1º de julho de 2025, por categoria e país do destinatário. Mensagem que o cliente manda para a empresa não é cobrada. As regras e o valor de cada categoria ficam na página de preços da Meta, e o que não tem custo está em [API oficial do WhatsApp é grátis?](https://www.adprotecnologia.com.br/disparo-em-massa/api-oficial-do-whatsapp-gratis).

### Preciso saber programar para usar a Cloud API?

Para integrar direto, sim, porque é preciso criar app, token e webhook. Quem não quer fazer isso pode usar a ferramenta de um provedor ou contratar um serviço de disparo, em que a campanha sai pela estrutura de quem presta o serviço.

### Quantas mensagens por segundo a Cloud API envia?

Por padrão, até 80 mensagens por segundo por número. A Meta sobe para 1.000 por segundo quando o portfólio tem limite ilimitado, o número falou com 100 mil pessoas ou mais em 24 horas e a qualidade está amarela ou melhor. Esse ritmo define quanto tempo uma base grande leva para sair.

### A AD PRO dispara pela Cloud API?

Sim. A AD PRO dispara pela API oficial do WhatsApp, na estrutura dela, depois que você aprova o teste. Se você prefere ter a API na sua própria conta, a estruturação tem valor base de R$ 2.000, sem os custos da Meta, de provedores e de ferramentas.

## Fontes

- [Meta for Developers, visão geral da WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/overview), conferido em 2026-10-31
- [Meta for Developers, encerramento da On-Premises API](https://developers.facebook.com/docs/whatsapp/on-premises/sunset), conferido em 2026-10-31
- [Meta for Developers, primeiros passos com a Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started), conferido em 2026-10-31
- [Meta for Developers, limites de envio](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits), conferido em 2026-10-31
- [Meta for Developers, velocidade de envio (throughput)](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput), conferido em 2026-10-31
- [Meta for Developers, templates (visão geral e limites)](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview), conferido em 2026-10-31
- [Meta for Developers, preços da WhatsApp Business Platform](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing), conferido em 2026-10-31
- [Meta for Developers, coexistência com o aplicativo WhatsApp Business](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/), conferido em 2026-10-31
- [WhatsApp, Termos de Serviço](https://www.whatsapp.com/legal/terms-of-service), conferido em 2026-10-31

---

AD PRO Tecnologia LTDA, CNPJ 68.425.611/0001-15, São Paulo/SP. Atendimento on-line para todo o Brasil. Diagnóstico comercial gratuito de 30 minutos: https://www.adprotecnologia.com.br/#agendar. WhatsApp +55 11 98604-5939. Fatos e preços publicados: https://www.adprotecnologia.com.br/fatos