API não oficial do WhatsApp ou a API oficial: qual usar?

Em resumo: uma API não oficial do WhatsApp roda uma sessão do WhatsApp Web que você vincula lendo um QR code, e o whatsapp-web.js e o WAHA, dois dos projetos por trás dessas ferramentas, escrevem na própria documentação que o WhatsApp não permite bots nem clientes não oficiais. A API Cloud oficial da Meta é o caminho que a Meta oferece às empresas, e pela Coexistência o seu número continua funcionando no app WhatsApp Business. Em troca, você passa a trabalhar com templates de mensagem, as cobranças da Meta e as políticas da Meta, que continuam valendo.

O ZapClaw conecta o seu número à API oficial do WhatsApp pela Coexistência, sem você precisar de um app próprio na Meta, e o app WhatsApp Business continua no celular.

Comece grátis

Os dois caminhos lado a lado

Em termos gerais, não fornecedor por fornecedor. As seções abaixo trazem a fonte de cada linha.

	Biblioteca ou gateway baseado no WhatsApp Web	API Cloud oficial da Meta
Como conecta	Você lê um QR code com o celular, e uma biblioteca controla de um servidor a sessão do WhatsApp Web que se abre.	O número é registrado na API da Meta, pelo Embedded Signup de um provedor ou pelo seu próprio app na Meta.
Quem está por trás	Projetos de código aberto e empresas. Baileys, whatsapp-web.js e WAHA declaram que não são afiliados ao WhatsApp.	A Meta.
Regras do WhatsApp	Os Termos de Serviço do WhatsApp proíbem o acesso automatizado que o WhatsApp não autorizou e o envio automático de mensagens.	As políticas de mensagens do WhatsApp valem, como para qualquer empresa.
Restrições à conta	whatsapp-web.js e WAHA dizem que o método deles não deve ser considerado totalmente seguro.	A Meta pode restringir ou desativar uma conta que descumpra as políticas dela.
O app WhatsApp Business	Continua funcionando: a sessão é um dos dispositivos conectados do celular.	Continua funcionando com a Coexistência. Sem ela, o número funciona só na API.
App na Meta e App Review	Nenhum: a API da Meta não é usada.	O seu próprio app na Meta, ou o de um provedor. Para a Coexistência, a Meta exige um Solution Partner ou Tech Provider, e virar Tech Provider pede verificação empresarial e App Review.
Iniciar uma conversa	Como no WhatsApp Web.	Respostas livres até 24 horas depois da última mensagem do cliente; fora dessa janela, um template aprovado pela Meta.
Cobranças da Meta	Nenhuma, já que a API da Meta não é usada.	Cada template e, desde 1º de outubro de 2026, as respostas pela API além das 1.000 grátis por número ao mês. Respostas digitadas no app continuam grátis.
Grupos, chamadas, visualização única	Depende da biblioteca ou do gateway.	Não na Coexistência.
Custo do software	Baileys (MIT), whatsapp-web.js e WAHA (Apache-2.0) são de código aberto e rodam no seu servidor; gateways hospedados cobram o próprio preço.	As cobranças da Meta acima, mais o preço de um provedor, se você usar um.

O que é uma API não oficial do WhatsApp

Toda ferramenta deste grupo funciona do mesmo jeito por baixo. Você lê um QR code com o celular, a sessão aparece no app em Dispositivos conectados, e uma biblioteca num servidor envia e recebe como essa sessão. Nada passa pela API Cloud da Meta, então não há app para criar na Meta nem etapa de aprovação. Os nomes que as pessoas pesquisam:

Baileys. Uma biblioteca em TypeScript que conversa com o WhatsApp Web por WebSockets. O README diz que o projeto não é afiliado ao WhatsApp e acrescenta que desencoraja o uso para stalkerware e para envio em massa ou automatizado.
whatsapp-web.js. Roda o WhatsApp Web num navegador controlado pelo Puppeteer. O README diz que o projeto não é afiliado ao WhatsApp e que o WhatsApp não permite bots nem clientes não oficiais na plataforma.
WAHA. Se descreve como uma camada de ligação sobre motores do WhatsApp mantidos pela comunidade e oferece quatro: WEBJS e WPP rodam um navegador de verdade pelo Puppeteer, enquanto NOWEB e GOWS conversam com o WhatsApp Web por WebSocket, em Node.js e em Go (motores). A introdução traz o mesmo aviso e não garante nada contra bloqueios.
Evolution API no modo Baileys. A Evolution API oferece dois tipos de conexão, Baileys e a API Cloud da Meta. No modo Baileys, que a documentação descreve como "API gratuita baseada no WhatsApp Web", você conecta a instância lendo um QR code, e o README avisa que esse método depende da versão web do WhatsApp.
O produto de QR code da Z-API (a Z-API clássica). A documentação da Z-API diz que basta ler o QR code dela para trabalhar sobre "uma sessão do WhatsApp Web", e a documentação do Omni chama isso de conexão não oficial. O outro produto da Z-API, o Z-API Omni, roda na API oficial da Meta (veja abaixo).

O que o WhatsApp diz sobre apps não oficiais e automação

O artigo Sobre apps não oficiais da Central de Ajuda do WhatsApp diz que vincular a sua conta a versões não oficiais do WhatsApp viola os Termos de Serviço, e que a conta também pode ser banida temporária ou permanentemente. Os exemplos que ele cita são apps: GB WhatsApp, FM WhatsApp, TM WhatsApp e TeleMessage. Ele não cita nenhuma biblioteca nem gateway de API.

Um segundo artigo, sobre mensagens automatizadas ou em massa, diz que os produtos do WhatsApp não foram feitos para envio em massa ou automatizado, e que o WhatsApp toma medidas judiciais contra esse uso, o que desde 7 de dezembro de 2019 inclui agir com base em declarações públicas de empresas.

Os Termos de Serviço do WhatsApp proíbem acessar ou usar o serviço por meios automatizados de um jeito que o WhatsApp não autorizou, fazer engenharia reversa ou extrair o código, e o envio de mensagens em massa ou automáticas. Eles permitem que o WhatsApp suspenda ou encerre o acesso.

Como o WhatsApp aplica essas regras a cada ferramenta é decisão do WhatsApp. Esta página reproduz o que o WhatsApp e os próprios projetos publicam; não é uma previsão.

O caminho oficial: a API Cloud da Meta e a Coexistência

A API Cloud é a API que a Meta oferece às empresas para o WhatsApp: o seu sistema recebe as mensagens num webhook e envia por chamadas de API, sem nenhuma sessão do WhatsApp Web no meio. Um número registrado só na API funciona só na API, não no app. A Coexistência muda isso. A documentação da Meta descreve como conectar um número que já roda no app WhatsApp Business, um recurso que às vezes é chamado de Coexistência:

O app continua funcionando. A empresa ainda pode enviar mensagens individuais pelo app WhatsApp Business, e as conversas ficam sincronizadas com a API. As mensagens enviadas pelo app continuam grátis.
Histórico. Até os últimos 6 meses de conversas podem ser sincronizados. Os grupos não são sincronizados.
Requisitos. O app WhatsApp Business na versão 2.24.17 ou mais recente, e uma conexão feita por uma empresa que já seja Solution Partner ou Tech Provider. O ZapClaw é Tech Provider da Meta. Continue abrindo o app no celular principal: a Meta desconecta o número depois de cerca de 14 dias sem uso.
Velocidade de envio. Fixa em 20 mensagens por segundo.
Dispositivos conectados. Quando o número conecta, a Meta desconecta todos os dispositivos vinculados. Os compatíveis podem ser vinculados de novo; o WhatsApp para Windows e o WearOS, não.

O que muda quando você vai para a API oficial

Templates e a janela de 24 horas. Você responde livremente até 24 horas depois da última mensagem do cliente. Para iniciar uma conversa, ou para escrever depois que essa janela fecha, você envia um template de mensagem que a Meta aprovou antes.
As cobranças da Meta. A Meta cobra direto de você por cada template enviado e, desde 1º de outubro de 2026, pelas respostas enviadas pela API além das primeiras 1.000 grátis por número em cada mês, pela tarifa do país do destinatário. Respostas digitadas no app WhatsApp Business continuam grátis. O ZapClaw nunca coloca margem nas cobranças da Meta (preços).
As políticas da Meta. Elas continuam valendo: a Meta pode restringir ou desativar uma conta do WhatsApp Business que as descumpra. O ZapClaw repassa esses eventos ao seu webhook, e a API dele responde 403 com ACCOUNT_RESTRICTED enquanto a restrição durar (erros).
O que fica de fora na Coexistência. A API não envia mensagens em grupos, não faz chamadas de voz ou vídeo nem envia mensagens de visualização única, e um número em Coexistência não recebe o selo azul da Meta. Se a sua automação depende de algo disso, confira antes de migrar.

Caminhos para a API oficial

Cada caminho, com o que ele pede de você:

Direto com a Meta, com o seu próprio app. Você cria um app no Meta for Developers, gera o token e configura o webhook por conta própria. Para manter o número no app WhatsApp Business, a Meta exige que a empresa que faz a conexão já seja Solution Partner ou Tech Provider, e virar Tech Provider pede verificação empresarial e App Review, com um vídeo do seu app enviando mensagens e gerenciando templates.
Um provedor como o ZapClaw. O ZapClaw é Tech Provider da Meta: você conecta o número na janela da Meta sem app próprio e sem App Review, e o número continua no app WhatsApp Business pela Coexistência. As mensagens recebidas chegam ao seu webhook assinadas com HMAC-SHA256, com até 3 tentativas de entrega, e você envia por uma API REST. O preço é por conta, não por número, e os planos pagos aceitam números ilimitados.
Evolution API no modo API Cloud. A mesma Evolution API self-hosted pode se conectar à API Cloud da Meta em vez do Baileys. O guia dela pede um app seu no Facebook Developers e um token permanente, e você configura o webhook nesse app.
Evo Hub. O produto pago e hospedado da Evolution Foundation, que ela descreve como "Um proxy entre você e a API da Meta", para WhatsApp, Instagram e Messenger, cobrado por canal (cada conexão conta como um). O site não dizia se ele aceita a Coexistência quando conferimos.
Z-API Omni. O produto da Z-API sobre a API oficial da Meta. A documentação dele diz que ele conecta pelo Embedded Signup da Meta, aceita a Coexistência e é cobrado por canal, sendo um canal um número do WhatsApp Business.

Dois deles lado a lado com o ZapClaw: ZapClaw vs Evolution API e ZapClaw vs Z-API.

Quando uma ferramenta baseada no WhatsApp Web é a melhor escolha

O seu fluxo depende de grupos, chamadas de voz ou vídeo ou mensagens de visualização única. Na Coexistência, a API da Meta não oferece nada disso.
Você não quer portfólio empresarial na Meta, templates de mensagem nem cobranças da Meta, e aceita o que dizem os termos do WhatsApp e os avisos dos próprios projetos.
Você quer código aberto rodando de ponta a ponta no seu próprio servidor.

Quando o ZapClaw é a melhor escolha

O seu número faz parte do seu negócio, e você quer ele na API oficial da Meta, não numa sessão do WhatsApp Web.
Você quer continuar respondendo no app WhatsApp Business enquanto o seu bot, o seu agente de IA ou o seu sistema usa a API.
Você não quer criar um app na Meta, passar pelo App Review nem virar Tech Provider.
Você opera vários números ou clientes: os planos pagos aceitam números ilimitados, com um preço por conta, e no plano Agency cada cliente fica isolado dos outros.
Você usa o Chatwoot self-hosted: o canal WhatsApp Cloud nativo dele conecta ao ZapClaw.

O ZapClaw não serve para disparo em massa, mais de 20 mensagens por segundo, grupos, chamadas de voz ou vídeo nem o selo azul. Esses limites são da Meta, na Coexistência.

Como migrar de uma ferramenta baseada no WhatsApp Web para o ZapClaw

Confira se o número roda no app WhatsApp Business, na versão 2.24.17 ou mais recente, e não no WhatsApp comum: a Coexistência só conecta números do app WhatsApp Business. Veja todos os requisitos.
Crie a sua conta no ZapClaw e conecte o número na janela da Meta, pelo painel. Quando ele conecta, a Meta desconecta todos os dispositivos vinculados, inclusive a sessão da ferramenta que você usa hoje.
Aponte a sua integração para o ZapClaw. As mensagens chegam no seu webhook no formato do ZapClaw, não no da sua biblioteca, então mapeie os campos uma vez com a referência do webhook. Você envia com uma chamada REST e o header X-API-Key.
Crie os templates de que você precisa para iniciar conversas e envie para aprovação da Meta pela API.

O número já está em outro provedor da API da Meta? Tire ele de lá primeiro. Usa o Chatwoot? Conecte pelo canal WhatsApp Cloud nativo dele.

Guias passo a passo, com os principais campos de envio e de webhook mapeados para os do ZapClaw: da Evolution API, do Z-API e do WAHA.

Perguntas frequentes

Meu número pode ser banido numa API não oficial?

Ninguém consegue dizer de antemão, nem para um lado nem para o outro. A Central de Ajuda do WhatsApp diz que uma conta vinculada a versões não oficiais do WhatsApp também pode ser banida temporária ou permanentemente, e os exemplos que ela dá são apps, não bibliotecas. whatsapp-web.js e WAHA escrevem que o método deles não deve ser considerado totalmente seguro, e a documentação da Z-API responde, sobre o produto de QR code dela, que a possibilidade de bloqueio existe e é real. Na API oficial, as políticas da Meta continuam valendo, e a Meta pode restringir uma conta que as descumpra.

Dá para levar o meu número para a API oficial sem perder o app WhatsApp Business?

Dá, pela Coexistência. A documentação da Meta diz que a empresa conectada assim ainda pode enviar mensagens individuais pelo app WhatsApp Business. Você precisa do app na versão 2.24.17 ou mais recente e de uma conexão por um Solution Partner ou Tech Provider, como o ZapClaw. Os dispositivos vinculados são desconectados quando o número conecta, os grupos não são sincronizados, e a velocidade de envio é fixa em 20 mensagens por segundo. Todos os requisitos.

Preciso de CNPJ ou de verificação empresarial?

Não para conectar. Para a Coexistência, a Meta pede o app WhatsApp Business no número e uma conta do Facebook, e a verificação empresarial não está na lista. A verificação muda alguns limites da Meta, como quantas pessoas diferentes você pode chamar com templates em 24 horas. O cadastro no ZapClaw não pede CPF, CNPJ, endereço nem cartão. A API oficial sem CNPJ.

A Evolution API e a Z-API são não oficiais?

Depende do produto. A Evolution API conecta pelo Baileys (WhatsApp Web) ou pela API Cloud da Meta com o seu próprio app na Meta, e a Evolution Foundation também vende o Evo Hub, um proxy hospedado para a API da Meta. O produto clássico da Z-API roda uma sessão do WhatsApp Web que você vincula por QR code, enquanto o Z-API Omni roda na API oficial da Meta. Detalhes: ZapClaw vs Evolution API e ZapClaw vs Z-API.

Existe API do WhatsApp sem aprovação da Meta?

As ferramentas baseadas no WhatsApp Web não pedem aprovação nenhuma, porque não usam a API da Meta; o que o WhatsApp diz sobre elas está acima. Na API oficial, um Tech Provider poupa você do app na Meta e do App Review: você conecta o número na janela da Meta. A Meta continua revisando cada template de mensagem antes que você possa enviá-lo.

Guias relacionados

Fontes

Conferido em 14 de outubro de 2026.