A WhatsApp Cloud API é o serviço hospedado da Meta que permite a uma empresa enviar e receber mensagens do WhatsApp em escala pelo seu próprio software, como um CRM, um sistema de agendamento ou uma ferramenta de suporte. Desde que a Meta desativou a On-Premises API, que era auto-hospedada, em 23 de outubro de 2025, ela é a única versão da WhatsApp Business API que ainda consegue entregar mensagens.[1] API, sigla em inglês para interface de programação de aplicações, é um conjunto de regras que permite a um programa passar instruções e dados para outro. Com a Cloud API, uma clínica pode lembrar pacientes de consultas, uma companhia aérea pode confirmar uma reserva e um banco pode enviar um código de acesso de uso único. A Meta mantém os servidores, então a empresa só precisa conectar o software que decide quais mensagens são enviadas e que trata cada resposta.
Principais conclusões
- A Cloud API é a única versão da WhatsApp Business API que ainda entrega mensagens, porque a última versão da On-Premises API da Meta expirou em 23 de outubro de 2025.
- “Cloud API” e “WhatsApp Business API” agora nomeiam o mesmo produto para enviar e receber mensagens, então a decisão real é como você se conecta a ele.
- A Meta hospeda e mantém a Cloud API; do seu lado fica o software, desenvolvido internamente ou fornecido por um provedor, que envia mensagens e recebe respostas.
- Há dois caminhos de acesso: conectar-se diretamente pela Meta ou passar por um BSP (Business Solution Provider), uma empresa que a Meta autoriza a oferecer acesso à API e suporte a outras empresas.
- A Meta cobra por mensagem entregue, com tarifas definidas pela categoria da mensagem e pelo país do destinatário, e um BSP, se você usar um, normalmente acrescenta suas próprias taxas.
O que é a WhatsApp Cloud API?
A WhatsApp Cloud API é uma API hospedada pela Meta que conecta o software da própria empresa ao WhatsApp para que ela possa enviar mensagens a clientes em escala. Nas palavras da Meta, ela “permite enviar mensagens e fazer chamadas no WhatsApp de forma programática”.[2] De forma programática significa que um software faz o envio e o recebimento: um CRM que envia uma mensagem de acompanhamento, um sistema de agendamento que envia um lembrete ou uma ferramenta de suporte em que atendentes respondem a perguntas.
A WhatsApp Business Platform é o conjunto de APIs de mensagens comerciais da Meta que permite às empresas se comunicar com clientes em escala. Além da Cloud API, ela inclui a Business Management API, que gerencia contas, números de telefone e templates.
Para enviar mensagens, uma empresa também precisa de contas na plataforma. A mais conhecida é a conta do WhatsApp Business (WABA), a conta única que vem reunindo os números de telefone, os templates e o faturamento de uma empresa. A Meta afirma que a WABA “está se tornando duas contas distintas”.[3] Uma WhatsApp account contém um único número de telefone comercial e representa a empresa no WhatsApp. Uma Messaging account contém os templates de mensagem, que são mensagens escritas com antecedência e que geralmente precisam de aprovação antes de serem enviadas, junto com os dados de faturamento. A Meta está implementando esse modelo em etapas a partir de 23 de setembro de 2026, chegando a todas as empresas até meados de outubro de 2026, e migra as contas existentes automaticamente.
Um BSP (Business Solution Provider) é uma empresa que a Meta autoriza a fornecer serviços da WhatsApp Business Platform a outras empresas, como envio de mensagens, faturamento, suporte à integração e suporte ao cliente.[4] A 360Dialog é um Official Meta Solution Partner e BSP que fornece infraestrutura de API do WhatsApp e dá a empresas e empresas de software acesso à WhatsApp Business API. Se você quer esse acesso por meio de um Official Meta Solution Partner, com seu número de telefone comercial conectado e sua primeira mensagem enviada cerca de 30 minutos após o cadastro, trabalhe conosco para começar a usar a API de forma simples.
A Cloud API é a mesma coisa que a WhatsApp Business API?
Sim, a Cloud API agora é a WhatsApp Business API para enviar e receber mensagens. Os dois nomes existem porque a Meta oferecia duas versões: a Cloud API, que a Meta hospeda e lançou em 2022, e a On-Premises API, um cliente de software que a própria empresa ou seu provedor configurava, hospedava e mantinha.
A última versão da On-Premises API da Meta expirou em 23 de outubro de 2025, e a página de descontinuação da Meta direciona as empresas para a Cloud API na WhatsApp Business Platform. O nome antigo também continua em uso, por exemplo na WhatsApp Business API Status Page, que informa a disponibilidade (uptime) e a latência da Cloud API.
A mesma plataforma também inclui a Marketing Messages API for WhatsApp, uma API separada que a Meta criou para enviar mensagens de marketing otimizadas. Para as mensagens do dia a dia, “Cloud API ou Business API” é hoje uma falsa escolha. A decisão que uma empresa realmente enfrenta é como se conectar: diretamente pela Meta ou por meio de um BSP.
O que aconteceu com a On-Premises API?
A Meta desativou a On-Premises API em etapas, e as mensagens enviadas para ou a partir de números ainda registrados nela deixaram de ser entregues em 23 de outubro de 2025. A página de descontinuação da On-Premises API da Meta lista três datas.
| Data | O que mudou |
|---|---|
| 9 de janeiro de 2024 | Depois da On-Premises API v2.53, novos recursos são lançados apenas para a Cloud API; as versões da On-Premises trazem correções de bugs e patches de segurança |
| 1º de julho de 2024 | Números de telefone comerciais só podem ser registrados para uso com a Cloud API |
| 23 de outubro de 2025 | A última versão da On-Premises, v2.63, expira, e as mensagens enviadas para ou a partir de números ainda registrados nela não são entregues |
A página de registro da Meta acrescenta que um número que migra da On-Premises API para a Cloud API precisa de etapas extras antes de poder ser registrado.[5]
O que uma empresa pode fazer com a Cloud API?
Uma empresa pode usar a Cloud API para quatro tipos de mensagem: suporte ao cliente, notificações, marketing e códigos de acesso. Cada um corresponde a uma categoria de mensagem que a Meta usa para definir preços.[6]
- Suporte ao cliente: Uma empresa de telecomunicações ou de serviços públicos responde a dúvidas sobre cobrança e serviços no chat, usando mensagens de serviço.
- Notificações: Uma clínica envia lembretes de consulta, um hotel confirma uma reserva ou um varejista envia uma atualização de entrega, usando mensagens de utilidade.
- Marketing: Uma marca de viagens ou uma academia envia uma oferta a clientes que deram opt-in, usando mensagens de marketing.
- Códigos de acesso: Um banco ou um app envia uma senha de uso único, usando mensagens de autenticação.
A Meta permite que uma empresa envie mensagens apenas a clientes que deram opt-in, ou seja, que concordaram em receber as mensagens dela. Como as mensagens passam por software, você pode conectar seu número comercial às ferramentas que você já usa, de um CRM a um sistema de agendamento.
Como a Cloud API funciona para desenvolvedores
Do ponto de vista técnico, a Cloud API envia mensagens pela Graph API da Meta, a interface baseada em HTTP sobre a qual a plataforma é construída, e entrega as mensagens dos clientes ao seu servidor por webhook. Um webhook é o endereço web onde o WhatsApp entrega as mensagens que os clientes enviam para você. Os webhooks da Meta entregam payloads JSON, que são blocos de dados de texto estruturados, para mensagens recebidas, atualizações de status de entrega e erros assíncronos, e as duas direções trafegam por HTTPS protegido por TLS.
A Cloud API lida com dois tipos de mensagem. Uma mensagem de formato livre, que a Meta chama de mensagem de serviço, não precisa de aprovação prévia e pode ser enviada enquanto uma janela de atendimento ao cliente estiver aberta. Essa janela é um cronômetro de 24 horas que começa quando um cliente envia uma mensagem ou liga para a empresa e é reiniciado a cada nova mensagem ou chamada.[7] Uma mensagem de template é uma mensagem personalizável que a empresa cria com antecedência. Os templates se dividem em três categorias (marketing, utilidade e autenticação) e são o único tipo de mensagem que uma empresa pode enviar fora de uma janela de atendimento ao cliente.[8]
O armazenamento local (local storage) é uma configuração da Cloud API no nível do número de telefone comercial que permite a uma empresa escolher o país onde o conteúdo das suas mensagens fica armazenado em repouso.[9] A Meta cita finanças, governo e saúde como setores regulados que podem preferir esse recurso. A configuração só pode ser ativada enquanto o número não está registrado, então um número que já está em uso precisa ter o registro cancelado e ser registrado novamente com o armazenamento local ativado. Para o lado da proteção de dados, veja o que o GDPR significa para o seu BSP.
A Meta lista chamadas e grupos entre seus lançamentos mais recentes, e ambos fazem parte da Cloud API: uma empresa pode fazer e receber chamadas com clientes, além de criar, gerenciar e enviar mensagens em conversas de grupo do WhatsApp.[10] A plataforma também oferece o Meta Business Agent, o serviço da Meta para configurar e executar agentes com IA que conduzem conversas no WhatsApp.
Throughput é o número de mensagens por segundo, recebidas e enviadas, que um único número de telefone comercial consegue processar. As páginas de throughput e de descontinuação da On-Premises API da Meta trazem os números operacionais abaixo.[11]
| Medida | Valor da Cloud API |
|---|---|
| Hospedagem | Hospedada pela Meta |
| Throughput padrão | Até 80 mensagens por segundo por número de telefone comercial |
| Throughput máximo | Até 1.000 mensagens por segundo com upgrade automático |
| Disponibilidade (uptime) | 99,9% |
| Latência | Menos de 5 segundos no p99 |
O upgrade vale apenas para números que atendem aos critérios de elegibilidade da Meta: limite de mensagens ilimitado para a empresa, mensagens para 100.000 ou mais usuários únicos fora de uma janela de atendimento ao cliente em um período móvel de 24 horas e classificação de qualidade Medium ou superior. A Meta aplica o upgrade sem custo.
Se você quer ver como lembretes, atualizações de entrega ou respostas de suporte funcionariam a partir do CRM ou da ferramenta de agendamento que você já usa, o caminho é começar a usar a API e conectar seu número por meio de ferramentas como Zapier, Make e n8n.
Como obter acesso à Cloud API?
Há dois caminhos para a Cloud API: a empresa se conecta diretamente pela Meta ou passa por um BSP.
Na rota direta, a empresa configura seu próprio portfólio empresarial, um app da Meta criado no App Dashboard da Meta, uma WhatsApp account, uma Messaging account e um número de telefone comercial, e depois desenvolve e opera o software que envia mensagens e recebe webhooks.[12] O portfólio empresarial é o contêiner da Meta para os ativos comerciais de uma empresa. Aqui ele contém principalmente WhatsApp accounts e Messaging accounts, e a Meta exige um portfólio antes que uma empresa possa usar a plataforma. Tratamos do lado das contas no nosso guia sobre como conseguir a aprovação da sua primeira conta.
Na rota do parceiro, o BSP passa as instruções à empresa, que normalmente envolvem concluir o fluxo de Embedded Signup da Meta.[13] O Embedded Signup é o fluxo de onboarding da Meta que coleta informações sobre a empresa e cria uma WhatsApp account e uma Messaging account para ela. A empresa então trabalha com essas contas pelo app do parceiro, que é a camada de software fornecida pelo BSP.
As duas rotas terminam na mesma Cloud API hospedada pela Meta, então a escolha se resume a quem desenvolve e opera o software ao redor dela. Se você está comparando a rota direta com um BSP, fale conosco e compare o que cada plano da 360Dialog inclui com o trabalho de desenvolver essa camada de software por conta própria.
Perguntas frequentes
A WhatsApp Cloud API é gratuita?
A WhatsApp Cloud API é cobrada por mensagem: a Meta cobra as empresas por cada mensagem que elas entregam a usuários do WhatsApp, com tarifas que variam conforme a categoria da mensagem e o código de país do destinatário. A Meta publica suas tabelas de tarifas atuais na página de preços, e um BSP normalmente cobra suas próprias taxas pelo serviço. Nosso artigo sobre como funcionam os preços da WhatsApp Business API explica o modelo.
A On-Premises API ainda pode enviar mensagens?
A On-Premises API não pode mais enviar mensagens. Sua última versão, v2.63, expirou em 23 de outubro de 2025, e a página de descontinuação da Meta afirma que a On-Premises API não pode mais ser usada para enviar mensagens a usuários do WhatsApp. A Meta orienta as empresas a usar a Cloud API na WhatsApp Business Platform.
O que acontece com um número que continuava registrado na On-Premises API?
Um número que ficou na On-Premises API não consegue enviar nem receber mensagens do WhatsApp: a página de descontinuação da Meta afirma que as mensagens enviadas para ou a partir de números comerciais ainda registrados para uso com a On-Premises API não são entregues. Para funcionar com a Cloud API, o número precisa ser registrado nela, e a página de registro da Meta indica etapas extras que a empresa precisa realizar antes ao migrar um número nessa situação.
Preciso de um BSP para usar a Cloud API?
O BSP é opcional para a Cloud API. A Meta documenta uma rota direta, em que a empresa cria seu próprio app da Meta, suas contas e seu número de telefone comercial e opera seu próprio software, e uma rota de parceiro, em que um BSP normalmente faz o onboarding da empresa pelo fluxo de Embedded Signup da Meta e oferece serviços como envio de mensagens, faturamento e suporte ao cliente pelo seu app. As duas rotas levam à mesma API hospedada pela Meta.
Qual é a diferença entre o aplicativo WhatsApp Business e a API?
O aplicativo WhatsApp Business é o app de celular da Meta para pequenas empresas que gerenciam pessoalmente as conversas com clientes, baixado no Google Play ou na App Store. A WhatsApp Business API conecta o WhatsApp ao software da própria empresa para que ela possa enviar mensagens a clientes em escala. A Meta também oferece suporte à coexistência, que significa usar o aplicativo WhatsApp Business e a API com o mesmo número de telefone.
Fontes
[1] Meta for Developers, On-Premises API Sunset. https://developers.facebook.com/docs/whatsapp/on-premises/sunset (accessed September 28, 2026)
[2] Meta for Developers, About the WhatsApp Business Platform. https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform (accessed September 28, 2026)
[3] Meta for Developers, Updates to WhatsApp Business accounts. https://developers.facebook.com/documentation/business-messaging/whatsapp/account-model-evolution (accessed September 28, 2026)
[4] Meta for Developers, Partners. https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview/ (accessed September 28, 2026)
[5] Meta for Developers, Register a business phone number. https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration/ (accessed September 28, 2026)
[6] WhatsApp Business, WhatsApp Business Platform Pricing. https://whatsappbusiness.com/products/platform-pricing/ (accessed September 28, 2026)
[7] Meta for Developers, Service messages. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages (accessed September 28, 2026)
[8] Meta for Developers, Pricing on the WhatsApp Business Platform. https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing (accessed September 28, 2026)
[9] Meta for Developers, Local storage. https://developers.facebook.com/documentation/business-messaging/whatsapp/local-storage (accessed September 28, 2026)
[10] Meta for Developers, WhatsApp Business Platform. https://developers.facebook.com/documentation/business-messaging/whatsapp/overview (accessed September 28, 2026)
[11] Meta for Developers, Throughput. https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput (accessed September 28, 2026)
[12] Meta for Developers, WhatsApp Cloud API Get Started. https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started (accessed September 28, 2026)
[13] Meta for Developers, WhatsApp accounts and Messaging accounts. https://developers.facebook.com/documentation/business-messaging/whatsapp/whatsapp-business-accounts (accessed September 28, 2026)
