WhatsApp Cloud API: como funciona e custos

Como funciona a WhatsApp Cloud API da Meta no Brasil: configuração passo a passo, exemplo de disparo, limites de envio, custo por mensagem e o que construir.

A WhatsApp Cloud API é a API oficial do WhatsApp Business hospedada pela própria Meta. Seu sistema chama a Graph API em graph.facebook.com, a Meta cuida dos servidores e cobra por mensagem, sem mensalidade. A alternativa instalada no servidor da empresa, a On-Premises API, expirou em 23 de outubro de 2025.

O primeiro disparo pelo número de teste pede só uma conta de desenvolvedor e um celular com WhatsApp. Produção exige portfólio empresarial, número próprio, token de usuário do sistema, webhook público e forma de pagamento, com limite inicial de 250 clientes a cada 24 horas. A API entrega endpoints, não um produto: inbox, distribuição de conversas, gestão de modelos e conciliação de Pix ficam com você, e é essa lacuna que os provedores vendem.

O que é a Cloud API e o fim da On-Premises

Pela página de desativação da Meta, recursos novos saem só para a Cloud API desde janeiro de 2024. A partir de 1º de julho de 2024, números novos só podiam ser registrados nela. Em 23 de outubro de 2025 expirou a última versão On-Premises, a v2.63, e os números que ficaram lá pararam de enviar e receber.

Todo provedor oficial no Brasil roda, portanto, sobre essa mesma API, exposta quase crua ou embrulhada numa API própria ou num inbox; a 360dialog, por exemplo, põe a própria Messaging API na frente.

A versão atual da Graph API é a v26.0, de 29 de julho de 2026. O guia de primeiros passos da Meta ainda usa a v23.0, disponível até 8 de outubro de 2027. Fixe uma versão e leia o changelog antes de trocar.

Passo a passo: do app à primeira mensagem

App e portfólio. Cadastre-se como desenvolvedor na Meta, crie um app com o caso de uso "Connect with customers through WhatsApp" e escolha ou crie um portfólio empresarial.
Número de teste. A Meta cria um número comercial de teste. Adicione seu WhatsApp como destinatário, gere um token temporário (dura poucas horas) e envie o modelo hello_world.
Webhook. Publique um endpoint HTTPS com certificado TLS válido (autoassinado não serve). A Meta valida com um GET (hub.mode, hub.verify_token, hub.challenge): confira o token e devolva o challenge. Assine o campo messages, que traz mensagens recebidas e status, e, em produção, inscreva o app com POST /<WABA_ID>/subscribed_apps.
Token permanente. Em Configurações do negócio, crie um usuário do sistema, atribua a ele o app e a conta do WhatsApp e gere um token com business_management, whatsapp_business_management e whatsapp_business_messaging. Guarde-o num cofre de segredos.
Número real e cobrança. O número precisa ser seu, ter DDI e DDD e receber SMS ou ligação; se estiver ativo no aplicativo do WhatsApp, apague-o de lá. Registre pelo endpoint register com o PIN de duas etapas. O faturamento fica no Meta Business Suite.

Um portfólio novo registra só dois números antes da verificação ou do nível de 2.000. E, desde 1º de julho de 2026, quem tem país de faturamento (Sold-To) Brasil no Billing Hub pode abrir contas em reais, faturadas pela Facebook Brasil, e precisa migrar todas para BRL até 30 de junho de 2027.

Todo POST do webhook traz X-Hub-Signature-256, um HMAC-SHA256 com o segredo do app: valide e responda HTTP 200. A Meta reenvia falhas por até sete dias e não recupera eventos perdidos; grave os payloads e descarte duplicados pelo ID.

Como disparar um modelo e responder no atendimento

A mensagem ou ligação do cliente abre uma janela de atendimento de 24 horas. Dentro dela vale qualquer tipo de mensagem; fora, só modelo aprovado. Modelos são criados no Gerenciador do WhatsApp ou pela API, como marketing, utilidade ou autenticação, e a revisão automática leva até 24 horas.

Exemplo ilustrativo (troque os campos entre < >; pedido_enviado representa qualquer modelo de utilidade aprovado em português):

curl 'https://graph.facebook.com/v26.0/<PHONE_NUMBER_ID>/messages' \
  -H 'Authorization: Bearer <TOKEN_DO_USUARIO_DO_SISTEMA>' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "<NUMERO_DO_CLIENTE_COM_55>",
    "type": "template",
    "template": {
      "name": "pedido_enviado",
      "language": { "code": "pt_BR" },
      "components": [{
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Ana" },
          { "type": "text", "text": "4821" }
        ]
      }]
    }
  }'

A resposta de atendimento usa o mesmo endpoint, com "type": "text" e "text": { "body": "Seu pedido 4821 saiu para entrega hoje." } no lugar do objeto template, e só passa com a janela do cliente aberta. Como passar na revisão está no guia de templates do WhatsApp e aprovação.

Limites de envio e velocidade

Limite	O que controla	Documentação da Meta, 24 de setembro de 2026
Limite de mensagens	Clientes únicos alcançados fora da janela em 24 horas móveis, por portfólio	250 no início; depois 2.000, 10.000, 100.000 e ilimitado
Throughput	Mensagens por segundo, por número	80 por padrão; upgrade automático para 1.000
Taxa por par	Mensagens para o mesmo cliente	1 a cada 6 segundos; rajada de até 45 consome a cota seguinte
Números registrados	Por portfólio empresarial	2 no início; 20 após verificação ou nível de 2.000
Modelos	Por conta do WhatsApp Business	250 sem verificação; até 6.000 verificado

Respostas dentro da janela não contam. Para chegar a 2.000, verifique a empresa ou entregue 2.000 modelos de boa qualidade a clientes únicos em 30 dias. Depois a Meta sobe o nível sozinha, em até seis horas, se a qualidade se mantiver e você tiver usado metade do limite na última semana.

O upgrade para 1.000 por segundo exige nível ilimitado, 100.000 clientes únicos fora da janela em 24 horas e qualidade amarela ou verde. Os erros 130429 e 131056 indicam excesso de throughput e da taxa por par. Uma loja que abriu o portfólio em novembro e quer disparar para 20 mil clientes na Black Friday esbarra antes no teto de 250, com qualquer provedor.

Quanto custa integrando direto com a Meta

A Meta cobra por mensagem entregue, conforme a categoria e o código do país de quem recebe. Para números do Brasil (+55), os dados do catálogo mostram hoje R$ 0,3217 por modelo de marketing, R$ 0,0350 por modelo de utilidade e R$ 0,0350 por modelo de autenticação. Respostas livres dentro da janela de atendimento são gratuitas até 30 de setembro de 2026, assim como modelos de utilidade enviados com a janela aberta.

Em 1º de outubro de 2026 isso muda. Pela documentação de preços da Meta, o atendimento passa a ser cobrado pela tarifa de utilidade e autenticação do mercado, R$ 0,0350 no Brasil, depois de uma franquia de 1.000 mensagens por número por mês, sem acúmulo para o mês seguinte. Modelos de utilidade dentro da janela passam a custar R$ 0,0350. A janela gratuita de 72 horas das conversas vindas de anúncio de clique para o WhatsApp continua valendo. O Meta Business Agent, IA da própria Meta, é cobrado à parte, por token, desde 1º de agosto de 2026.

Direto com a Meta você não paga provedor, mas paga hospedagem, plantão do webhook e horas de desenvolvimento. Totais mensais estão no guia de preço da API do WhatsApp no Brasil.

O que sua equipe vai construir

Inbox de atendimento. A Meta documenta endpoints e webhooks, não uma tela para atendentes lerem e responderem conversas.
Distribuição e transbordo. Filas, horário de atendimento e passagem do bot para uma pessoa.
Gestão de modelos. Redação, aprovação, nota de qualidade e pausa dos disparos quando a nota cai.
Registro de opt-in. A Meta exige consentimento com o nome da empresa. Guardar a prova e atender pedidos de titulares sob a LGPD é com você.
Pix. A Payments API da Meta no Brasil envia uma mensagem order_details com Pix dinâmico, boleto ou link de pagamento. O código vem do seu banco ou PSP, o cliente paga no app do banco com o copia e cola, e você concilia pelo reference_id e atualiza o pedido.
Monitoramento. Nota de qualidade, nível de limite, códigos de erro, rotação de token.

Respostas com IA estão no guia de agente de IA no WhatsApp com MCP.

Quando um BSP ou uma plataforma compensa mais

Integrar direto faz sentido para um time com desenvolvedores e uma tarefa delimitada, como avisos de entrega disparados pelo ERP. Com inbox, vários atendentes ou chatbot, a lista acima costuma sair mais cara que um provedor.

Provedores de API somam onboarding, suporte e sandbox à API crua. A 360dialog cobra por número, a partir de € 49/mês, e repassa as tarifas da Meta, com um acréscimo documentado em parte dos envios de marketing. Twilio (Sem mensalidade, paga por mensagem) e Gupshup (Sem mensalidade, paga por mensagem) somam uma taxa própria por mensagem. Infobip (a partir de US$ 530/mês) e Sinch (Enterprise: preço sob consulta) vendem principalmente pelo comercial.

Entre as plataformas completas, Botmaker, Octadesk e VTEX CX Platform (Weni) documentam inbox compartilhado com filas e transbordo para atendente, com cobrança em reais: a partir de R$ 600/mês, a partir de R$ 2.499/mês e a partir de R$ 1.900/mês, nessa ordem. Como avaliar um provedor está em BSP do WhatsApp: o que é e como escolher; as notas, no ranking de plataformas de WhatsApp para o Brasil.

Guias relacionados

Sobre este guia

Escrito pela equipe editorial do WABA Index, catálogo independente de plataformas de WhatsApp Business para empresas que vendem para clientes no Brasil. Nenhuma plataforma paga por posição ou menção, e o site não usa links de afiliados.

Metodologia

Em 24 de setembro de 2026 lemos a documentação da Meta listada nas fontes, da Cloud API aos preços e à Payments API no Brasil. Tarifas, preços e notas vêm dos dados do catálogo. Nada foi testado na prática; o código é ilustrativo. A pontuação está explicada na metodologia.

Atualizado em

24 de setembro de 2026: conferimos as datas da On-Premises, a Graph API v26.0, limites, throughput, tarifas da Meta para o Brasil e a cobrança do atendimento a partir de 1º de outubro de 2026.

Perguntas frequentes

A WhatsApp Cloud API é gratuita?

Sem mensalidade. A Meta cobra modelos entregues e, a partir de 1º de outubro de 2026, o atendimento acima da franquia mensal. Provedores somam taxas próprias.

Ainda dá para usar a On-Premises API?

Não. A última versão expirou em 23 de outubro de 2025.

Posso usar o número do meu WhatsApp Business?

Direto, a Meta exige apagá-lo do aplicativo antes. Provedores com Embedded Signup conectam o número mantendo o app ativo (coexistência), com throughput fixo de 20 mensagens por segundo.

Preciso verificar a empresa para começar?

Não. O número de teste e os primeiros números reais funcionam sem verificação. Ela libera o nível de 2.000 e o teto de 20 números.

WhatsApp Cloud API: como funciona, configuração, limites e custos no Brasil