O que é a API oficial do WhatsApp

O que ela é, em concreto

Uma API HTTP. Você faz uma requisição autenticada para enviar uma mensagem e recebe os eventos — mensagem recebida, entregue, lida, falhou — de volta em um endpoint seu, por webhook. Não existe tela e não existe sessão para manter viva. A Meta descreve a plataforma como a forma de as empresas conversarem com clientes em escala, e a documentação dela é escrita para desenvolvedores.

A plataforma reúne mais de uma API, e vale saber o nome de cada uma:

• Cloud API — envia e recebe mensagens (texto, mídia, botões, listas), faz e recebe ligações e, desde outubro de 2025, cria e administra grupos. É a parte que quase todo mundo chama de “a API do WhatsApp”.
• Business Management API — administra a conta: números, templates e métricas.
• Marketing Messages API — envio de marketing com otimização de entrega, em disponibilidade geral desde novembro de 2025.

E três fatos práticos sobre quem opera e quem paga:

• Quem opera — a Meta. A infraestrutura é dela, a documentação é dela e a autorização de acesso passa por ela. A comunicação é por HTTPS, e as mensagens continuam protegidas pelo protocolo de criptografia do WhatsApp.
• De quem é a conta — da empresa dona do número. Quando a conexão é feita por um provedor, pelo Embedded Signup, a conta continua no portfólio da empresa, que mantém acesso total a ela; o provedor recebe só a autorização para operar.
• Como se paga — por mensagem entregue: template, em regra, e, desde 1º de outubro de 2026, também a resposta dentro da janela acima da franquia mensal. A Meta cobra a empresa dona do número, ou o parceiro que fatura por ela, conforme o caminho de acesso (abaixo). Veja quanto custa.

Um produto, vários nomes

“WhatsApp Business API”, “API oficial”, “Cloud API” e “WhatsApp Business Platform” aparecem como se fossem coisas diferentes, e boa parte do conteúdo em português ainda as trata assim. Até 2025 havia, de fato, duas versões: a Cloud API, hospedada pela Meta, e a On-Premises API, que a empresa ou o provedor instalava no próprio servidor.

A On-Premises deixou de entregar mensagens em 23 de outubro de 2025. Desde então, para quem integra, os quatro nomes descrevem a mesma coisa: a Cloud API, operada pela Meta. Fornecedor que ainda fala em “servidor próprio da API do WhatsApp” está descrevendo um produto que não existe mais — ou está falando de uma integração não oficial.

O que ela não é

A confusão mais comum é achar que qualquer coisa que envie WhatsApp por código é “a API”. Não é. Boa parte do que se vende como API de WhatsApp no Brasil abre uma sessão de navegador contra o WhatsApp Web — o mesmo mecanismo do aparelho conectado — e opera contra os termos de uso da Meta, que proíbem expressamente ferramentas de terceiros não autorizadas.

A comparação completa, com o que cada modelo custa em manutenção, está em API oficial x não oficial.

Aplicativo WhatsApp Business x API oficial

A Meta descreve o aplicativo WhatsApp Business como feito para o dono de pequena empresa conversar com cada cliente, e a plataforma como APIs de nível empresarial. Na prática, a diferença é quem opera o número: uma pessoa, no celular, ou um sistema.

Não é preciso escolher um dos dois. Com a coexistência, o mesmo número fica no aplicativo e na API, e o histórico é sincronizado entre eles.

Como ter acesso: direto ou por um provedor

Ninguém “compra” a API oficial; ela é acessada com uma conta na Meta. O que muda é quem monta e mantém a integração. São três caminhos:

• Direto pela Meta — você cria um aplicativo no painel de desenvolvedores da Meta, liga o portfólio da empresa, gera um token e usa a API para o próprio negócio. Quem usa só para si não precisa de revisão do aplicativo pela Meta. Em troca, cabe a você manter o servidor de webhook, renovar credenciais, acompanhar mudanças de versão e montar a conexão do número.
• Por um Tech Provider — um parceiro aprovado pela Meta conecta o número do cliente pelo Embedded Signup e opera a integração. A Meta cobra as mensagens direto do cliente, no meio de pagamento dele; o Tech Provider cobra só pelo próprio serviço. É o modelo do CRPRO Hub.
• Por um Solution Partner (o antigo BSP) — parceiro com linha de crédito na Meta, que paga as mensagens e repassa ao cliente na própria fatura.

A diferença entre os dois tipos de parceiro, e por que ela importa para quem paga a conta, está em Tech Provider ou BSP.

O que é preciso para começar

A Meta organiza os ativos da empresa em camadas, e os nomes mudaram recentemente. Desde setembro de 2026, a antiga conta WhatsApp Business (WABA) está sendo dividida em duas, e o painel de cada empresa pode mostrar o nome novo ou o antigo até o fim da migração.

• Portfólio de negócios (o antigo Business Manager) — obrigatório. É onde ficam os ativos da empresa na Meta.
• Conta do WhatsApp e conta de mensagens (juntas, a antiga WABA) — a primeira guarda o número, o perfil e o catálogo; a segunda, os templates, a cobrança e os webhooks.
• Um número elegível — com código de país e de área, capaz de receber SMS ou ligação. Se estiver no WhatsApp comum, a conta precisa ser apagada antes; se estiver no aplicativo WhatsApp Business, entra por coexistência.
• Meio de pagamento — cadastrado na conta da empresa, para a Meta cobrar as mensagens. A conta de teste dispensa.

A verificação da empresa não é exigida para começar. Ela é um dos caminhos para sair do primeiro nível de limite de mensagens e para registrar mais de 2 números (20 depois dela), e é pré-requisito do selo azul de conta oficial. O passo a passo da conexão está em como conectar um número.

As regras que valem para todo mundo

Algumas regras são da Meta, não do provedor, e valem igual para qualquer integração oficial. São elas que explicam a maior parte das surpresas de quem sai do aplicativo.

• Janela de atendimento de 24 horas — começa quando o cliente manda mensagem e reinicia a cada nova mensagem dele. Com ela aberta, a empresa responde livremente; fechada, só sai template.
• Templates aprovados — mensagens pré-cadastradas e revisadas pela Meta, nas categorias marketing, utilidade e autenticação. São o único jeito de iniciar uma conversa. A Meta pode reclassificar a categoria depois, se o conteúdo enviado não bater com ela.
• Consentimento — antes de mandar template, a empresa precisa do opt-in do cliente, deixando claros o nome dela e o que vai enviar.
• Limite de mensagens — quantos clientes diferentes a empresa alcança fora da janela em 24 horas, somando todos os números do portfólio. Os níveis são 250, 2.000, 10.000, 100.000 e ilimitado, e a subida é automática para quem usa o limite com qualidade alta.
• Qualidade — bloqueios, denúncias e taxa de leitura dão nota a cada template. Nota baixa pausa ou desativa o template e trava a subida do limite.

Como essas regras aparecem num fluxo automatizado, com os erros que cada uma provoca, está em automação de WhatsApp por API e webhooks; o lado técnico da Cloud API — endpoints, tokens, webhooks e versões — está em WhatsApp Cloud API.

Quanto custa, em uma frase

A Meta cobra por mensagem entregue desde 1º de julho de 2025 (antes era por conversa de 24 horas), com preço por categoria e por país. Desde 1º de outubro de 2026, a resposta sem template dentro da janela também é cobrada depois de 1.000 mensagens gratuitas por mês por número, e o template de utilidade dentro da janela, desde a primeira. Mensagem recebida nunca custa nada. A conta com os seus números está na calculadora de custo, e o histórico da mudança de outubro, em o que mudou na cobrança. A tabela que vale para o valor do dia é sempre a da Meta.

Coexistência: o número não precisa mudar

Durante anos, adotar a API oficial custava o número: ele tinha que ser dedicado à API e sair do aplicativo. A coexistência mudou isso. O número continua no aplicativo WhatsApp Business, no aparelho de sempre, e responde pela Cloud API ao mesmo tempo — o histórico fica, e o que a pessoa digita no celular chega ao seu sistema como um evento de eco.

Há contrapartidas: o número fica limitado a uma velocidade menor de envio, algumas funções do aplicativo deixam de existir nas conversas individuais, e o aplicativo precisa ser aberto no celular com regularidade para a conexão não cair. Os detalhes estão em coexistência no WhatsApp.

Perguntas frequentes