API oficial vs não oficial do WhatsApp

O número que some da noite para o dia

A diferença entre a API oficial e a não oficial não é detalhe técnico: é ter um canal que a Meta reconhece ou um número que pode ser encerrado sem aviso, com a base junto. Segue a comparação.

Neste artigo

• O que é cada uma das duas rotas
• Diferenças: aprovação, número, estabilidade, limites, banimento e LGPD
• Quando cada modelo faz sentido e o que considerar na migração

O que é cada uma

API oficial é a Plataforma do WhatsApp Business (Cloud API). O número é registrado em um portfólio empresarial da Meta e passa a operar por software: vários atendentes, chatbot, templates aprovados e webhooks. Não é aplicativo e não se escaneia QR code.

API não oficial conecta o número por engenharia reversa: o sistema simula um WhatsApp Web, escrevendo como se fosse uma pessoa. Funciona — e é por isso que é arriscado, já que os termos vedam aplicações que interajam com os serviços comerciais sem consentimento prévio.

Diferenças concretas

• Aprovação: oficial nasce de portfólio empresarial da Meta, com verificação da empresa; não oficial, da leitura de um QR code.
• Número: oficial aceita vários atendentes no mesmo número, com filas; não oficial depende de sessões compartilhadas, vedadas pelos termos.
• Estabilidade: oficial tem webhooks, status de entrega e nota de qualidade; não oficial quebra a cada atualização do aplicativo.
• Limites: oficial começa em 250 contatos únicos por 24 horas, vai a 2.000 com a verificação e depois 10.000, 100.000 e ilimitado — limite de portfólio. Não oficial não tem limite publicado: tem risco de bloqueio.
• Banimento: oficial tem regras, processo de recurso publicado e exige opt-in e template aprovado para disparar; no não oficial, o banimento é frequente e o número fica inutilizável.
• LGPD: na oficial, os dados ficam sob o seu controle; na não oficial, passam por servidores de terceiros que você não audita — e você responde por isso.

Quando cada modelo faz sentido

Sem API, só o aplicativo WhatsApp Business. Se você atende sozinho, no celular, com volume baixo, ele resolve — é a opção gratuita e legítima da Meta.

API oficial. Faz sentido quando mais de uma pessoa atende no mesmo número, quando você já perdeu um número, quando precisa de chatbot, CRM e relatórios, ou quando envia em volume.

API não oficial. Não a recomendamos em nenhuma operação com base de clientes construída: os termos ainda dizem que, encerrada a conta, a empresa não cria outra sem permissão expressa por escrito.

A oficial não é imunidade: sem opt-in ou com denúncias, a conta também é restringida — mas com regras publicadas e caminho de recurso.

Saindo do não oficial: o que considerar na migração

• Número banido. Primeiro, o pedido de análise ao WhatsApp: só depois de desbanido ele vai para a API; se negado, é número novo.
• Duas rotas. Coexistência: o número segue no WhatsApp Business App e vai para a Cloud API, mantendo contatos e conversas de até seis meses (sem grupos); exige app atualizado e nenhuma sessão não oficial ativa. Número dedicado: você exclui a conta do aplicativo e registra o número limpo — sem histórico, então faça backup.
• O que não migra. Fluxos de chatbot, respostas automáticas e disparos viram templates aprovados, e a base precisa de opt-in registrado — contato antigo consentindo de novo.
• Dia D. Pausa a ferramenta antiga, encerra a sessão, conecta pelo cadastro incorporado e testa nos dois sentidos antes de ligar as automações.

Erros comuns

• Migrar esperando o banimento. Com o número funcionando a troca é rotina; banido, depende de recurso.
• Registrar na API um número ainda no aplicativo. A Meta exige excluí-lo antes, ou usar a coexistência.
• Achar que o limite é por número. É do portfólio: a nota de um número afeta os demais — e seguir disparando sem opt-in é o caminho mais rápido para restringir a conta nova.

Perguntas frequentes

Posso usar as duas ao mesmo tempo?

Sim, em números diferentes. O que não pode é a ferramenta não oficial seguir rodando sobre o mesmo número da API.

Migro e perco o histórico?

Na coexistência, contatos e conversas de até seis meses sincronizam, sem grupos. No número dedicado, o histórico não migra.

Preciso de CNPJ para migrar?

Sim. A verificação da empresa exige CNPJ ou documento equivalente, dentro de um portfólio empresarial da Meta.

Quanto tempo leva a migração?

A conexão leva minutos; a sincronização exige o app aberto e a revisão de templates, até 24 horas. Plano realista: alguns dias.

Como o ZafChat entra nisso

No ZafChat você roda na API oficial: número no portfólio da Meta, templates aprovados, vários atendentes no mesmo número e histórico centralizado, sem arriscar a base.

Fale com a gente no WhatsApp