O que é a API oficial do WhatsApp
É a WhatsApp Business Platform, também chamada de Cloud API: a interface que a própria Meta publica e mantém para empresas enviarem e receberem mensagens por software. Oficial quer dizer operada pela Meta — sem sessão de navegador, sem QR code recorrente e sem aparelho intermediário.
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, não existe sessão para manter viva e não existe celular que precise ficar ligado.
- Quem opera — a Meta. A infraestrutura é dela, a documentação é dela e a autorização de acesso passa por ela.
- Como se conecta — pelo Embedded Signup, dentro da conta Meta da própria empresa dona do número.
- Como se paga — por mensagem de template entregue, na conta da empresa dona do número. Veja quanto custa.
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.
| API oficial (Cloud API) | Integração não oficial | |
|---|---|---|
| Quem mantém | Meta | Um terceiro, por engenharia reversa |
| Como conecta | Autorização única, na conta Meta do cliente | Leitura de QR code, repetida |
| Se a sessão cair | Não existe sessão para cair | Precisa ler o QR code de novo |
| Risco para o número | Classificação de qualidade | Banimento por violar os termos |
| Contrato | Com a Meta | Nenhum |
A comparação completa, com o que cada modelo custa em manutenção, está em API oficial x não oficial.
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.
Perguntas frequentes
O que é a API oficial do WhatsApp?
É a WhatsApp Business Platform, também chamada de Cloud API: a interface que a própria Meta publica e mantém para empresas enviarem e receberem mensagens de WhatsApp por software. É oficial porque é a Meta quem opera, documenta e autoriza o acesso — não há sessão de navegador nem aparelho intermediário.
Qual a diferença entre a API oficial e o WhatsApp Business comum?
O aplicativo WhatsApp Business é feito para uma pessoa atender pelo celular. A API é feita para software: ela não tem tela, é chamada por HTTP e devolve os eventos por webhook. Com coexistência, os dois funcionam no mesmo número ao mesmo tempo.
Preciso trocar de número para usar a API oficial?
Não, desde que a conexão use coexistência. O número continua no aplicativo WhatsApp Business, no aparelho de sempre, e passa a responder também pela Cloud API. Sem coexistência, o número precisaria ser dedicado à API.
A API oficial do WhatsApp bloqueia o número?
A API oficial não derruba número por usar API — esse é justamente o risco das integrações não oficiais, que operam contra os termos de uso. O que existe na API oficial é uma classificação de qualidade: excesso de bloqueios e denúncias por parte de quem recebe reduz o limite de envio do número.
Quem pode usar a API oficial do WhatsApp?
Qualquer empresa com uma conta WhatsApp Business verificada na Meta. O acesso técnico costuma passar por um provedor, que cuida do cadastro, dos tokens e da entrega dos eventos — que é o papel do CRPRO Hub.
hub_pk_... até a primeira mensagem enviada.