API oficial x API não oficial do WhatsApp: o que muda de verdade

A diferença entre a API oficial do WhatsApp e uma biblioteca não oficial não é de qualidade de código: é de autorização. A oficial é a Cloud API da Meta, em que automatizar é o uso previsto e cada mensagem iniciada é cobrada. A não oficial automatiza o WhatsApp Web, é gratuita e não pede aprovação de nada — e viola os termos, o que expõe o número a um bloqueio sem aviso e sem recurso.

A comparação abaixo é critério a critério, e inclui as duas linhas em que a não oficial ganha. Um comparativo em que um lado leva tudo não é comparativo.

Tempo até o primeiro envio

Empatado, com uma ressalva. A não oficial sobe em minutos: instala, lê o QR code, envia. A oficial contratada direto na Meta leva de semanas a meses; por um provedor que já cumpriu a burocracia, também são minutos.

Custo por mensagem

A não oficial ganha, e ganha com folga. Ela não cobra nada por mensagem. Na oficial, a Meta cobra cada template que você inicia, com preço por categoria e por país. Para volume alto de notificação, a diferença é de ordens de grandeza.

É a linha mais honesta desta comparação, e a que faz projeto de baixo orçamento escolher a não oficial com razão.

Risco de bloqueio

Aqui a distância é a maior de todas. Automatizar o WhatsApp Web viola os termos por si só — independentemente do que você envia. O bloqueio chega sem aviso e o recurso é um pedido de revisão sem prazo e sem garantia.

Na API oficial não existe banimento por automatizar: a Meta sabe que há um sistema do outro lado. O que existe é a métrica de qualidade do número, que cai quando gente demais bloqueia ou denuncia — e isso vale para os dois caminhos.

Estabilidade

A não oficial depende de uma sessão de WhatsApp Web. Ela quebra quando o aplicativo é atualizado, quando o servidor reinicia e quando a Meta muda alguma coisa do lado dela — sem aviso e sem changelog.

Isso não é hipótese: nós operamos um cluster de instâncias não oficiais por anos. Num reboot de dois servidores, 41 instâncias entraram em estado de reconexão e nunca mais voltaram sozinhas — e ninguém percebeu no dia, porque a falha é silenciosa: o serviço continua de pé, respondendo, sem sessão. Foi o que nos levou a migrar os clientes para a Cloud API.

Sessão de WhatsApp Web não sobrevive a um reboot. Você descobre isso no dia em que precisa reiniciar o servidor — ou no dia em que ele reinicia sozinho.

O que dá para enviar

• Não oficial — texto e mídia para qualquer número, sem aprovação, inclusive em grupos.
• Oficial — texto, mídia, interativos, localização, contato e reação; template aprovado para iniciar conversa; e nenhum suporte a grupos.

Grupos são o único recurso em que a não oficial faz algo que a oficial não faz e não fará: não existe endpoint de grupo na Cloud API. Quem depende de grupo precisa saber disso antes de decidir.

Aprovação de conteúdo

Na não oficial não existe. Você escreve e envia. Na oficial, toda mensagem que parte de você é um template analisado pela Meta, com categoria e regras de redação.

É um custo de processo real — e é também o que impede a sua base de receber, no mesmo canal, a mensagem que uma empresa desesperada dispararia.

Quem responde quando quebra

• Não oficial — a comunidade do projeto. Não há SLA, não há canal, não há para quem escalar.
• Oficial — o provedor, e atrás dele a Meta. Existe alguém contratualmente responsável.

O resumo, por perfil

1. Protótipo, uso interno, volume baixo, número descartável: a não oficial é difícil de justificar contra.
2. Loja que avisa cliente no mesmo número do atendimento: oficial, porque o número que cai é o do negócio.
3. Operação que depende de grupo: nenhuma das duas resolve bem; a não oficial resolve com risco.
4. Volume alto de notificação com orçamento apertado: a conta da oficial precisa ser feita antes, e pode não fechar.

Quem decidiu migrar encontra o passo a passo, inclusive mantendo o mesmo número, em migrar para a API oficial sem perder o número.

Perguntas frequentes

API não oficial do WhatsApp é ilegal?

Não é crime; é violação dos termos de uso da plataforma. A consequência não é jurídica, é operacional: bloqueio do número, sem aviso e sem prazo de recurso.

Usar API não oficial só para receber mensagens é seguro?

É o mesmo mecanismo. O que caracteriza a violação é a automação do WhatsApp Web, não o sentido da mensagem.

Dá para usar as duas ao mesmo tempo?

No mesmo número, não: o número fica registrado em um lugar só. Em números diferentes, dá — e é o desenho usado por quem está migrando aos poucos.

A API oficial é mais lenta para enviar?

Não. A diferença de latência é irrelevante para notificação; o que limita o volume é o tier de envio do número, que sobe conforme a qualidade se mantém.