WhatsApp Cloud API: guia completo da API hospedada pela Meta

Quando se fala em API oficial do WhatsApp, hoje se fala em Cloud API. Este guia detalha o que ela é, por que a Meta matou a alternativa auto-hospedada, quanto custa e o que você precisa para começar.

O que é a WhatsApp Cloud API

A Cloud API é o componente central da WhatsApp Business Platform. Lançada em 2022, ela roda inteiramente na infraestrutura da Meta: sua aplicação faz chamadas HTTPS para graph.facebook.com, e a Meta cuida de toda a conexão com a rede do WhatsApp.

Na prática, ela é um conjunto de endpoints da Graph API da Meta — mesma base de URL, mesmo versionamento (a versão mais recente é a v25, de fevereiro de 2026) e mesma autenticação por access token.

O fim da On-Premises API

Durante anos existiram duas arquiteturas: a Cloud API (hospedada pela Meta) e a On-Premises API (um cliente Docker que a empresa rodava em servidor próprio). Essa segunda morreu em etapas:

1. Janeiro de 2024 — fim do desenvolvimento de novos recursos
2. Julho de 2024 — bloqueio de registro de novos números
3. 23 de outubro de 2025 — desligamento definitivo: números que continuaram na On-Premises simplesmente pararam de entregar mensagens

A Meta justificou a decisão com números: a Cloud API entrega 4 vezes mais throughput, latência menor e reduziu em mais de 90% o custo de infraestrutura dos parceiros. Se você encontrar conteúdo ensinando a instalar a API do WhatsApp em servidor próprio, está desatualizado.

Como funciona na prática

O fluxo básico da Cloud API tem três peças:

1. Envio — sua aplicação faz um POST para /{phone-number-id}/messages com o JSON da mensagem (texto, mídia, botões ou template).
2. Recebimento — a Meta entrega mensagens dos clientes e atualizações de status (enviada, entregue, lida, falhou) no seu webhook.
3. Templates — para iniciar conversa fora da janela de 24 horas, você usa modelos pré-aprovados pela Meta, gerenciados no WhatsApp Manager ou por API.

A regra de ouro do WhatsApp está na janela de atendimento: quando o cliente manda mensagem, abre-se uma janela de 24 horas em que a empresa responde livremente e de graça. Fora dela, só é possível enviar template aprovado — e cada template entregue é cobrado.

Quanto custa a Cloud API

A Meta não cobra mensalidade nem taxa de setup — apenas as mensagens de template entregues, no modelo por mensagem vigente desde 1º de julho de 2025. Referência para o Brasil:

Valores de referência — o rate card oficial da Meta muda sem aviso. Utilidade e autenticação têm desconto progressivo por volume; marketing não.

O que você precisa para usar

• Conta no Meta Business Manager (portfólio de negócios)
• Uma WABA (WhatsApp Business Account)
• Um número de telefone dedicado, que não esteja registrado no app do WhatsApp
• Display name aprovado e, para escalar além de 250 contatos/dia, a verificação da empresa
• Um access token de System User para produção (o token do painel expira em 24 horas)

Com isso, os limites de envio evoluem por tiers — 250 → 2.000 → 10.000 → 100.000 → ilimitado — conforme volume e qualidade, como detalhado no guia da API oficial.

Integrar direto ou usar uma plataforma?

Acessar a Cloud API direto da Meta é gratuito, mas significa construir tudo: a integração, o webhook, a interface de atendimento, a gestão de templates e o controle de opt-in. Faz sentido para produtos com time de engenharia dedicado.

Para operação comercial — vendas, atendimento, campanhas — o mais comum é usar uma plataforma que já roda sobre a Cloud API. A Wizebot faz o onboarding da sua WABA de forma assistida e entrega a Cloud API operável sem código: multiatendimento, agentes de IA, construtor visual de fluxos e CRM, com o custo por mensagem da Meta repassado sem markup.

Perguntas frequentes

A Cloud API transformou a API oficial do WhatsApp em algo acessível: sem servidor, sem mensalidade da Meta e com escala de sobra. Se quiser usá-la sem montar um time técnico, a Wizebot coloca sua empresa na API oficial com aprovação assistida e tudo pronto para atender e vender.