WhatsApp Cloud API da Meta: o que é, como funciona e quando usar
A Cloud API é a versão do WhatsApp hospedada pela própria Meta: sem servidor seu, com atualização automática e limites definidos. Entenda como funciona e quando usar.
A WhatsApp Cloud API é a versão da API do WhatsApp hospedada pela própria Meta: você não sobe servidor, não aplica atualização e não cuida da disponibilidade da mensageria — só envia requisições HTTP e recebe as mensagens por webhook. É hoje a forma padrão de acessar o WhatsApp Business Platform, e substituiu a antiga On-Premises API, que ficava na sua infraestrutura e está sendo descontinuada.
Se o que você quer primeiro é entender a diferença entre os produtos da Meta e os nomes envolvidos, comece por WhatsApp Business Platform: o que é. Aqui o foco é a Cloud API em si: como ela funciona, o que muda na prática e quando ela é a escolha certa.
O que "cloud" significa aqui
O nome não é decorativo. Ele descreve quem hospeda a camada de mensageria.
Na On-Premises API, a Meta entregava um contêiner que rodava na sua infraestrutura. Você provisionava máquina, banco, balanceador, aplicava cada atualização de versão à mão e monitorava disponibilidade. Dava controle total e um trabalho considerável — e era um projeto de infraestrutura antes de ser um projeto de produto.
Na Cloud API, tudo isso fica com a Meta. O que sobra do seu lado é o que realmente importa: o que a sua aplicação faz com as mensagens.
| Cloud API | On-Premises API | |
|---|---|---|
| Quem hospeda | Meta | Você |
| Atualização de versão | Automática | Manual |
| Custo de infraestrutura | Nenhum | Servidor, banco, monitoramento |
| Tempo para primeiro envio | Curto | Projeto de infra |
| Situação atual | Padrão recomendado | Em descontinuação |
Como funciona, na prática
O modelo é simples e tem duas direções.
Saindo (você envia). Uma requisição HTTP autenticada por token para o endpoint da Meta, com o número de destino e o conteúdo. Se a conversa estiver dentro da janela de 24 horas, você manda texto livre; fora dela, precisa ser um template aprovado.
Entrando (você recebe). A Meta chama a sua URL de webhook toda vez que algo acontece: mensagem recebida, mensagem entregue, mensagem lida, mudança de status. É aqui que mora o detalhe que pega muita gente desprevenida — a Cloud API não tem caixa de entrada. Não existe tela para o atendente abrir. Se você não gravar a mensagem que chegou no webhook, ela não fica guardada em lugar nenhum do seu lado.
Ou seja: a Meta entrega o transporte. A caixa de entrada, o histórico e o painel de atendimento são construídos por você — ou vêm de uma plataforma.
Esse é exatamente o ponto em que a maioria dos projetos que começam "direto na Meta" trava: a integração de envio sai em um dia, e a operação de atendimento em volta leva semanas.
Os limites que importam
São três, e todos são previsíveis — o que é justamente a vantagem do caminho oficial:
Tier de envio. Número novo começa num limite baixo de conversas iniciadas por dia e sobe conforme mantém qualidade boa e volume crescente. Não dá para começar disparando: a mecânica está em quality rating e limite de mensagens.
Janela de 24 horas. A partir da última mensagem do cliente, você tem 24 horas de texto livre. Depois disso, só template aprovado para reabrir a conversa.
Aprovação de template. Toda mensagem proativa passa por revisão da Meta antes de existir. Isso significa planejar conteúdo com antecedência, não improvisar campanha na véspera.
Nenhum desses limites é obstáculo para quem atende quem procurou primeiro. Eles pesam para quem quer disparar para lista fria — e essa é a intenção do desenho.
Quanto custa
A Meta não cobra pelo acesso nem pela hospedagem. A cobrança é por mensagem, variando por categoria e país; os valores por categoria estão em quanto custa a API do WhatsApp.
Duas mudanças relevantes já estão marcadas para 2026: a cobrança do Meta Business Agent, a partir de agosto, e a cobrança de mensagens de serviço por mensagem a partir de outubro, sem faixa mensal gratuita e sem desconto por volume. O cronograma completo, as tarifas para o Brasil e um simulador estão em novos preços do WhatsApp em 2026.
Como começar
Pelo caminho direto na Meta, a sequência é:
- Conta Meta Business criada e negócio verificado.
- Aplicativo criado no painel de desenvolvedores, com o produto WhatsApp adicionado.
- Número registrado e verificado na conta.
- Token de acesso permanente gerado (e guardado com cuidado).
- Webhook publicado numa URL pública com HTTPS, respondendo ao desafio de validação.
- Templates submetidos e aprovados.
- Integração da sua aplicação com os endpoints de envio e o tratamento do webhook.
É factível, e é um projeto. Os passos 4 e 5 costumam ser onde o cronograma escorrega: token que expira em produção e webhook que precisa de endpoint público estável são duas das causas mais comuns de retrabalho.
Quando a Cloud API é a escolha certa — e quando não é
É a escolha certa quando você precisa de previsibilidade, quer a conta reconhecida pela Meta, depende do canal para faturar e tem volume ou equipe que justifica a estrutura. O risco de perder o número por "suspeita de automação" simplesmente não existe aqui, porque a automação é o propósito declarado.
Pode não ser quando o volume é pequeno, o uso é de atendimento simples com opt-in e o custo por mensagem não se paga — cenário em que uma API não oficial com assinatura fixa pode fazer mais sentido. O trade-off honesto está em API oficial vs não oficial: mais liberdade e menos custo, em troca de mais risco.
Vale ser claro sobre o limite disso: a Cloud API não é imunidade. Conta que envia sem opt-in e acumula denúncia é penalizada também — com a diferença de que a penalidade é gradual, visível e recorrível.
Onde a WAME entra
A WAME é parceira oficial da Meta, e isso resolve os sete passos acima: o número chega conectado à Cloud API, sem criar aplicativo, sem gerenciar token, sem publicar webhook próprio. Você trabalha na camada de conversa desde o primeiro dia — e com WhatsApp, Instagram e Messenger na mesma instância.
Com a Coexistência, dá ainda para manter o atendimento pelo celular no mesmo número. Se você já opera em outro lugar, migrar sem perder o número é o caminho, e nossa relação com a Meta está em WAME, parceira oficial.
Conclusão
Cloud API é a Meta hospedando a mensageria para você — menos infraestrutura, atualização automática e regras claras de janela, template e tier. O que ela não entrega é a operação em volta: caixa de entrada, histórico e painel são seu problema, ou da plataforma que você escolher. Decidir isso antes de começar é o que separa um projeto de duas semanas de um de dois meses.
Pronto para automatizar seu WhatsApp?
Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.
Começar grátisPerguntas frequentes
O que é a WhatsApp Cloud API da Meta?+
É a versão da API do WhatsApp para empresas hospedada nos servidores da própria Meta. Você não instala nem mantém nada da infraestrutura de mensageria: envia requisições HTTP para a API da Meta e recebe as mensagens de volta por webhook. É a forma recomendada e padrão de acessar o WhatsApp Business Platform hoje, em substituição à antiga On-Premises API, que está em descontinuação.
Qual a diferença entre Cloud API e On-Premises API?+
Na Cloud API a Meta hospeda tudo: você não provisiona servidor, não aplica atualização de versão e não cuida de disponibilidade da camada de mensageria. Na On-Premises, esse contêiner rodava na sua infraestrutura, o que dava mais controle e dava muito mais trabalho — atualização manual, escalonamento e monitoramento por sua conta. A Meta está descontinuando a On-Premises e concentrando tudo na Cloud API.
A WhatsApp Cloud API é gratuita?+
A hospedagem e o acesso à API não têm mensalidade cobrada pela Meta. O que é cobrado são as mensagens, com preço que varia por categoria (marketing, utilidade, autenticação e serviço) e por país. Vale considerar as mudanças de cobrança de 2026: a partir de outubro, mensagens de serviço passam a ser cobradas por mensagem, sem faixa mensal gratuita.
Quais são os limites da WhatsApp Cloud API?+
Os principais são o limite de envio por tier, que começa baixo em número novo e sobe conforme a qualidade se mantém boa e o volume cresce; a janela de 24 horas, fora da qual só é possível iniciar conversa com template aprovado; e a necessidade de aprovação prévia dos templates. Há também limites técnicos de requisições por segundo, que raramente são o gargalo de uma operação típica.
Como começar a usar a WhatsApp Cloud API?+
Pelo caminho direto, você precisa de uma conta Meta Business verificada, criar um aplicativo no painel de desenvolvedores, adicionar o produto WhatsApp, registrar e verificar um número, gerar um token de acesso permanente, configurar a URL de webhook com validação e submeter os templates. Pelo caminho via parceira oficial, como a WAME, o número já chega conectado e você trabalha direto na camada de conversa, sem montar essa infraestrutura.
Continue lendo
API oficial vs não oficial do WhatsApp: qual escolher? (comparativo 2026)
Comparativo completo entre a API oficial e a não oficial do WhatsApp: custo, aprovação, limites de envio, templates, suporte e risco de bloqueio.
WhatsApp Business API e Cloud API (oficial): o que é, preços e como funciona
Entenda a WhatsApp Business API oficial e a Cloud API da Meta: o que é, como funciona, requisitos, modelo de preços (por mensagem/conversa), templates e quando uma API não oficial é uma alternativa melhor.
Bloqueios em massa do WhatsApp: o que aconteceu e quem foi atingido
A onda de bloqueios de contas do WhatsApp em agosto de 2026 atingiu negócios inteiros. O que os casos tinham em comum, por que a Meta agiu em lote e quem passou ileso.