WhatsApp Cloud API explicada
A WhatsApp Cloud API é a versão da API da WhatsApp Business Platform que a Meta hospeda para você. O seu software envia mensagens por requisições HTTPS e recebe respostas e status de entrega por webhook. A Meta encerrou a antiga API On-Premises em 23 de outubro de 2025, então quem usa a API hoje usa a Cloud API.
Por Mousa Alhelo, fundador, E-SAFQA · Atualizado em · 7 min de leitura · Como escrevemos e testamos estes guias
O que é a WhatsApp Cloud API?
A WhatsApp Cloud API é a interface hospedada pela Meta para a WhatsApp Business Platform. Um desenvolvedor, ou um provedor que cria a integração para você, a chama por HTTPS pela Graph API da Meta para enviar mensagens de texto, de mídia e interativas de um número de telefone comercial. As respostas e as atualizações de status das mensagens voltam para uma URL de webhook que você controla. Você não administra nenhum servidor do WhatsApp, e é por isso que o blog para desenvolvedores da Meta a descreve como a Cloud API, hospedada pela Meta.
É um produto para desenvolvedores, não um aplicativo. Não existe caixa de entrada nem painel até que você ou um provedor construa um, e por isso muitas lojas encontram a Cloud API por meio de um Business Solution Provider ou de um app construído sobre ela.
O que aconteceu com a API On-Premises?
Antes da Cloud API, uma empresa podia hospedar o cliente On-Premises do WhatsApp nos próprios servidores. A Meta o desativou em etapas, e a página de encerramento dela traz as datas abaixo (conferidas em outubro de 2026).
- Se um provedor ou uma integração antiga ainda fala em hospedagem On-Premises, pergunte se ela já foi migrada para a Cloud API.
| Data | O que mudou |
|---|---|
| 9 de janeiro de 2024 | Os novos recursos passam a sair só para a Cloud API. O cliente On-Premises recebe apenas correções de bugs e de segurança. |
| 1º de julho de 2024 | Novos números de telefone comerciais só podem ser registrados para a Cloud API. Tentar registrar um para a On-Premises retorna o código de erro 1005. |
| 23 de outubro de 2025 | A última versão On-Premises expirou. Ela não envia mais mensagens, e as mensagens de ou para números ainda registrados nela não são entregues. |
O que você precisa para começar a usar a Cloud API?
O guia Primeiros passos da Meta lista os pré-requisitos em outubro de 2026: uma conta do Facebook ou uma conta Meta gerenciada, o registro como desenvolvedor, um portfólio empresarial e um dispositivo com WhatsApp para mensagens de teste. Os principais passos vêm a seguir.
- Crie um app da Meta com o caso de uso do WhatsApp no Painel de Apps da Meta e vincule o seu portfólio empresarial.
- Conecte uma conta do WhatsApp e uma conta de Mensagens. A documentação mais recente da Meta usa esses dois termos; a conta de Mensagens guarda os seus modelos de mensagem e os dados de cobrança, e o seu antigo WABA ID agora a identifica.
- Envie uma mensagem de teste do número de teste com um token de acesso temporário.
- Configure um webhook para que as atualizações de status e as respostas dos clientes cheguem ao seu servidor.
- Crie um usuário do sistema e um token de acesso permanente com as permissões whatsapp_business_messaging e whatsapp_business_management.
- Registre o seu próprio número de telefone comercial e defina um nome de exibição. Um número que já está em uso no WhatsApp precisa ser excluído antes, a menos que você o integre pelo recurso de coexistência da Meta para usuários do app WhatsApp Business.
Como funcionam as mensagens e os limites na Cloud API?
A Meta lista três formas de elevar o limite inicial de 250 para 2.000: verificar a sua empresa, pedir a um parceiro que a verifique ou entregar 2.000 mensagens de modelo de alta qualidade em 30 dias. Níveis maiores, de 10.000, 100.000 e ilimitado, são liberados automaticamente conforme a sua qualidade e o seu uso crescem.
| Regra | O que a Meta documenta |
|---|---|
| Opt-in | Você só pode enviar mensagens a pessoas que optaram por receber contato da sua empresa. |
| Janela de atendimento ao cliente | Quando um cliente escreve para você, abre-se uma janela de 24 horas que é reiniciada a cada nova mensagem do cliente. Dentro dela você pode enviar mensagens de atendimento de texto livre. |
| Mensagens de modelo | Fora da janela, você só pode enviar modelos pré-aprovados nas categorias marketing, utilidade ou autenticação. |
| Limite de mensagens | O número de clientes únicos para quem você pode escrever fora de uma janela de atendimento em 24 horas corridas é definido por portfólio empresarial. Os novos portfólios começam em 250. |
| Taxa de envio | Um número de telefone comercial envia até 80 mensagens por segundo por padrão, e você pode pedir mais. |
Quanto custa a WhatsApp Cloud API?
A Meta cobra por mensagem entregue. Desde 1º de julho de 2025 o preço é por mensagem, e não por conversa, e a tarifa depende da categoria da mensagem (marketing, utilidade, autenticação ou atendimento) e do código telefônico do país do destinatário. A Arábia Saudita é um dos mercados citados na tabela de tarifas da Meta, então as mensagens para números +966 são cobradas na tarifa própria dela (veja /pt/blog/whatsapp-api-saudi-arabia-pricing). A Meta não cobra pelas mensagens que os clientes enviam para uma empresa.
Desde 1º de outubro de 2026, as respostas de atendimento dentro da janela de 24 horas também são cobradas. A página de preços da Meta lista uma faixa gratuita de 1.000 mensagens de atendimento por número de telefone comercial a cada mês. Os provedores somam as próprias taxas de plataforma por cima, e elas não constam na tabela de tarifas da Meta. Para as tarifas atuais e um exemplo calculado, veja o nosso guia de preços em /pt/blog/whatsapp-business-api-pricing-explained.
Cloud API, app WhatsApp Business ou app de dispositivo conectado?
| Cloud API | App WhatsApp Business | App de dispositivo conectado (WhatsApp Pilot) | |
|---|---|---|---|
| Quem cria a experiência | Um desenvolvedor ou um provedor | O WhatsApp, como app gratuito | WhatsApp Pilot, um app Shopify da E-SAFQA |
| Número | Um número de telefone comercial registrado na API | O seu número no app | O seu próprio número, conectado por QR code |
| Tarifas da Meta por mensagem | Sim, por mensagem entregue | Nenhuma | Nenhuma |
| Modelos | Obrigatórios fora da janela de 24 horas | Não são usados | Texto livre que você edita no app |
| Status de entrega e de leitura | Informados por webhook | Exibidos no app | Indisponíveis com um dispositivo conectado |
| Ideal para | Alto volume, campanhas, vários atendentes, chatbots | Uma pessoa respondendo às conversas | Uma loja que envia mensagens de pedido do próprio número |
Uma loja Shopify precisa da Cloud API?
Nem sempre. Se você precisa de alto volume, modelos aprovados, status de entrega e de leitura ou de um chatbot, a Cloud API é a base certa, em geral por meio de um provedor. Se uma única loja quer principalmente confirmações de pedido, avisos de envio e lembretes baseados em consentimento pelo número de WhatsApp que os clientes já conhecem, um app de dispositivo conectado é mais simples.
O WhatsApp Pilot, um app Shopify da E-SAFQA, conecta o seu próprio número de WhatsApp como dispositivo conectado ao escanear um QR code. Não há WhatsApp Business API nem tarifa por mensagem da Meta; o Pro custa USD 15 a cada 30 dias. A contrapartida é que as confirmações de entrega e de leitura não estão disponíveis. Os detalhes estão em /pt/how-it-works/whatsapp-connection.
Perguntas frequentes
O que é a WhatsApp Cloud API?
É a API hospedada pela Meta para a WhatsApp Business Platform. O software envia mensagens a ela por HTTPS e recebe respostas e atualizações de status por webhook, sem administrar servidores próprios do WhatsApp.
A WhatsApp Cloud API é gratuita?
Não. A Meta cobra por mensagem entregue, por categoria e por país, e os provedores somam taxas de plataforma. Desde 1º de outubro de 2026, as respostas de atendimento também são cobradas, depois de uma faixa gratuita de 1.000 por número de telefone a cada mês.
O que aconteceu com a API On-Premises?
A Meta parou de adicionar recursos em janeiro de 2024, encerrou os novos registros em 1º de julho de 2024 e acabou com o suporte em 23 de outubro de 2025. Os números comerciais agora funcionam na Cloud API.
Posso usar a Cloud API e o app WhatsApp Business no mesmo número?
Só pelo recurso de coexistência da Meta, que é configurado na integração. Caso contrário, um número que já está em uso no WhatsApp precisa ser excluído antes de ser registrado na Cloud API.
Preciso de verificação da empresa para usar a Cloud API?
Você pode começar sem ela. A Meta lista a verificação como uma das formas de elevar o limite de mensagens de 250 para 2.000 clientes por dia, e o status de Conta Comercial Oficial a exige.
Pronto para colocar o WhatsApp para trabalhar na sua loja?
Comece com o botão gratuito. Faça upgrade para o Pro para ter mensagens de pedido e de envio, recuperação de carrinho, cupons de recompra, o botão inteligente de produto, alertas de volta ao estoque e a Demanda de Produtos.