WACrew

Comparativo

API oficial vs não oficial do WhatsApp: a diferença que importa

API oficial é a Cloud API da Meta, paga e com regras de template; não oficial conecta pelo protocolo do WhatsApp Web, sem custo por mensagem e com risco de banimento. Quando usar cada uma.

Atualizado em 1 min de leitura
Nesta página
  1. Diferenças na prática
  2. Como escolher
  3. Erro comum
  4. Perguntas frequentes

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 oficialAPI não oficial
númeronúmero cadastrado na plataforma da Metao número que você já usa no celular
custocobrança por mensagem de template, por categoria e paíssem custo por mensagem; só o servidor
iniciar conversasó com template aprovado fora da janela de 24 horaslivre (e é aí que mora o risco)
grupos que você já temnão é o foco da plataformalê e responde normalmente
riscobaixo, dentro das regrasbanimento 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.