API oficial x não oficial do WhatsApp
As duas enviam mensagem por código. A diferença está em quem opera a conexão, no que acontece quando ela cai e em quem assume o risco quando o número é banido — que é sempre o seu cliente.
Lado a lado
| API oficial (Cloud API) | Integração não oficial | |
|---|---|---|
| Quem mantém | Meta | Um terceiro, por engenharia reversa do WhatsApp Web |
| Autorização | Uma vez, na conta Meta do cliente | Leitura de QR code, repetida |
| Infraestrutura por número | Nenhuma | Uma sessão viva — aparelho ou container |
| Quando a sessão cai | Não existe sessão | Alguém relê o QR code, e o envio para até lá |
| Risco para o número | Classificação de qualidade da Meta | Banimento por violar os termos de uso |
| Custo por mensagem | Cobrado pela Meta, na conta do cliente | Nenhum |
| Custo escondido | Nenhum | Manutenção de sessão e recuperação de número banido |
| Contrato | Com a Meta | Nenhum |
Onde a conta vira
Comparadas por mensalidade, as integrações não oficiais quase sempre ganham: não há custo por mensagem pago à Meta. A conta muda quando você deixa de operar um número e passa a operar dezenas, de clientes diferentes.
- Sessão é trabalho recorrente — cada número tem uma sessão que pode cair a qualquer momento, e recuperá-la exige alguém do lado do cliente com o celular na mão.
- Banimento é perda do cliente, não sua — o número banido é o do cliente. O histórico dele, os contatos dele, a operação dele. É o tipo de incidente que encerra a relação.
- Não existe para quem responder — sem contrato com a Meta, não há suporte, não há previsibilidade de mudança e não há recurso quando algo muda do lado do WhatsApp.
O que mudou o cálculo: coexistência
O argumento mais forte a favor das integrações não oficiais sempre foi prático: adotar a API oficial custava o número. Ele tinha que ser dedicado à API, sair do aplicativo, perder o histórico. Para um cliente que atende pelo celular, isso era inviável.
A coexistência tirou esse argumento da mesa. Hoje o número continua no aplicativo WhatsApp Business, no aparelho de sempre, e responde pela Cloud API ao mesmo tempo. O cliente não troca de número, não perde conversa e continua atendendo pelo celular quando quiser — e o que ele digita lá chega ao seu sistema como evento de eco.
Perguntas frequentes
Qual a diferença entre a API oficial e a não oficial do WhatsApp?
A oficial é a Cloud API, publicada e operada pela Meta: o acesso é autorizado na conta da própria empresa e não existe sessão de navegador envolvida. A não oficial abre uma sessão contra o WhatsApp Web por engenharia reversa, precisa de leitura de QR code e opera contra os termos de uso da Meta.
Usar API não oficial do WhatsApp banir o número?
Pode. Integrações não oficiais violam os termos de uso do WhatsApp, e a Meta bane números que detecta usando-as. O banimento atinge o número, não o software — ou seja, a perda é do seu cliente, e é definitiva na prática.
A API não oficial é mais barata?
Na mensalidade, quase sempre sim, porque não há custo por mensagem pago à Meta. O custo aparece em outro lugar: alguém precisa reler QR code quando a sessão cai, manter um aparelho ou container ligado por número, e reconstruir a operação quando um número é banido. Para quem atende clientes de terceiros, esse custo é recorrente e imprevisível.
Dá para migrar de uma API não oficial para a oficial sem trocar de número?
Sim, usando coexistência. O número sai da integração não oficial e é autorizado na Cloud API pelo Embedded Signup, continuando no aplicativo WhatsApp Business do cliente. Ele não troca de número e não perde o histórico.