A API oficial do WhatsApp é a WhatsApp Business Platform da Meta (Cloud API), contratada direto ou por um parceiro (BSP). Uma API não oficial conecta ao WhatsApp pelo protocolo do WhatsApp Web, como mais um aparelho conectado, usando bibliotecas como Baileys ou whatsmeow.
Diferenças na prática
| API oficial | API não oficial | |
|---|---|---|
| número | número cadastrado na plataforma da Meta | o número que você já usa no celular |
| custo | cobrança por mensagem de template, por categoria e país | sem custo por mensagem; só o servidor |
| iniciar conversa | só com template aprovado fora da janela de 24 horas | livre (e é aí que mora o risco) |
| grupos que você já tem | não é o foco da plataforma | lê e responde normalmente |
| risco | baixo, dentro das regras | banimento se houver abuso |
Como escolher
A oficial faz sentido para empresa que dispara notificação em escala (pedido, cobrança, código de acesso) e precisa de selo e estabilidade contratual. A não oficial faz sentido para quem atende pessoas que já falam com ela, no próprio número, incluindo grupos de cliente. O WACrew está nesse segundo grupo e o README avisa que ele não é a API oficial e que disparo em massa pode banir o número.
Erro comum
Usar a não oficial para prospecção fria em volume. É o principal gatilho de banimento. O outro erro, do lado oficial, é esquecer que fora da janela de 24 horas só sai template aprovado.
Perguntas frequentes
A API não oficial é ilegal? Usar viola os termos de uso do WhatsApp, e a conta pode ser restringida. Crime, em si, não é.
Dá para usar as duas? Dá, em números diferentes: um oficial para notificações e o pessoal para atendimento.
Mais detalhe em o risco da API não oficial. Em inglês: official vs unofficial API.


