API oficial do WhatsApp ou API não oficial (Evolution API, Baileys, Z-API): qual a diferença e que número usar?
Por NumioPublicado em
A API oficial é a Cloud API da Meta: o número é registrado na plataforma WhatsApp Business, o sistema conversa com os servidores da Meta por HTTP e a cobrança é por mensagem. As APIs não oficiais (Baileys, whatsapp-web.js, WPPConnect, Z-API e a Evolution API no modo Baileys) fazem outra coisa: se conectam a uma conta comum do WhatsApp como se fossem um WhatsApp Web, lendo o QR Code no aparelho. Não há cobrança por mensagem, mas também não há autorização do WhatsApp, e a conta pode ser banida.
A diferença prática é de risco e de escopo. Na oficial, o que pode acontecer é perder qualidade e ter o limite de envio reduzido, com regras publicadas. Na não oficial, a conta inteira pode cair sem aviso, e os próprios projetos avisam disso. Por isso a regra de quem trabalha com as duas é a mesma: nunca pôr o número principal da empresa numa conexão não oficial.
Nos dois casos o número precisa ser um número de verdade, que receba o código do WhatsApp. O número fixo virtual da Numio (R$ 25,90/mês, R$ 16,90/mês no anual) é verificado por ligação e serve aos dois caminhos: registrado na Cloud API, ou ativado no app do WhatsApp Business e conectado por QR Code.
Qual é a diferença, ponto a ponto?
| API oficial (Cloud API) | API não oficial | |
|---|---|---|
| Como conecta | Número registrado na plataforma WhatsApp Business; chamadas HTTP à Meta | Sessão de WhatsApp Web numa conta comum, por QR Code ou código de pareamento |
| Autorização do WhatsApp | Sim, é o produto da Meta pra isso | Não. Os projetos se declaram sem vínculo com o WhatsApp |
| Onde o número fica | Só na API (sai do app) | No app do celular, com a ferramenta como aparelho conectado |
| Custo por mensagem | Sim, cobrado pela Meta | Não |
| Iniciar conversa | Só com template aprovado | Texto livre, sem aprovação |
| Grupos | Limitado: a API é voltada à conversa da empresa com cada cliente | Sim, os grupos da conta |
| Risco pro número | Queda de qualidade e redução do limite de envio, com regras publicadas | Banimento da conta, sem regra publicada nem aviso |
| Estabilidade | Contrato de API versionado | Quebra quando o WhatsApp Web muda; a sessão cai se o celular fica dias sem conexão |
| Selo de conta verificada e nome de exibição revisado | Disponíveis | Não |
A Evolution API é oficial ou não oficial?
As duas coisas, e é daí que vem a confusão. A Evolution API é um servidor de código aberto que oferece dois tipos de conexão: uma baseada no Baileys (não oficial, por QR Code) e outra que usa a Cloud API da Meta (oficial). A ferramenta é a mesma; o risco depende de qual conexão você criou na instância.
| Projeto | Como conecta |
|---|---|
| Baileys | Biblioteca que fala o protocolo do WhatsApp Web por WebSocket, sem navegador. Entra como segundo aparelho por QR Code ou código de pareamento |
| whatsapp-web.js | Controla um navegador com o WhatsApp Web aberto. O próprio projeto avisa que o uso não garante que você não será bloqueado |
| WPPConnect | Exporta funções do WhatsApp Web pra uso em Node |
| Z-API | Serviço pago que conecta pelo mesmo canal do WhatsApp Web, com leitura de QR Code |
| Evolution API | Conexão Baileys (não oficial) ou conexão pela Cloud API da Meta (oficial), à sua escolha |
O que os Termos do WhatsApp dizem sobre automação não oficial?
Os Termos de Serviço do WhatsApp, na parte de uso aceitável, vedam fazer engenharia reversa dos serviços, criar contas por meios automatizados ou não autorizados e criar software ou APIs que funcionem como os serviços do WhatsApp e oferecê-los a terceiros sem autorização. Também vedam o envio de mensagens em massa e de mensagens automáticas.
Na prática, a conta pode ser banida por comportamento automatizado, e o WhatsApp não publica quantos envios ou qual padrão dispara o bloqueio. Quem diz que tem um limite seguro está contando a própria experiência.
Disparo em massa pra quem não pediu contato é vedado pelos Termos do WhatsApp nos dois caminhos, e também pelos Termos de Uso da Numio. Número novo não resolve isso: é o comportamento que é punido.
Quando faz sentido cada uma?
| Situação | Caminho |
|---|---|
| Atendimento de clientes de uma empresa, com agente de IA ou equipe | Oficial |
| Notificação de pedido, cobrança, lembrete de consulta, código de acesso | Oficial, com template de utilidade ou autenticação |
| Campanha pra base que autorizou contato | Oficial, com template de marketing |
| Produto que você vende pra terceiros e precisa de previsibilidade | Oficial |
| Automação em grupos que já existem na conta | Não oficial, sabendo do risco |
| Protótipo, projeto pessoal ou volume muito baixo, sabendo do risco | Não oficial, num número separado |
Muita operação usa as duas: o número principal na API oficial e um número secundário numa conexão não oficial pra o que a oficial não cobre.
Que número usar em cada caminho?
- Na API oficial: um número livre, que não esteja no app. Peça o código por ligação de voz ao registrar. Veja registrar número por API.
- Na não oficial: o número é ativado primeiro no app do WhatsApp Business, num celular, com o código por ligação. Depois a ferramenta lê o QR Code como aparelho conectado. O passo a passo da ativação no app está em número virtual pro WhatsApp Business.
- Nos dois: um número diferente do principal. Se a conta cair, você perde o número secundário e as conversas dele, não o contato que os seus clientes têm salvo há anos.
O número da Numio é um número fixo comum pra o WhatsApp: ele não muda a chance de banimento, nem pra mais nem pra menos. O que ele muda é o custo de separar: um número a mais sem chip e sem aparelho.
Dá pra migrar da não oficial pra oficial sem trocar de número?
Dá. O número que está no app pode ir pra Cloud API: apague a conta do WhatsApp no app (o histórico do aparelho não vai junto) e registre o número na API, pedindo o código por ligação. Alguns provedores oficiais oferecem o modo de coexistência, que mantém o número no app do WhatsApp Business e na API ao mesmo tempo, com limitações.
Número que foi banido precisa ser liberado pelo processo de contestação do WhatsApp antes de poder ser registrado na API.
Perguntas frequentes
A oficial é a Cloud API da Meta: número registrado na plataforma WhatsApp Business, cobrança por mensagem e regras publicadas. A não oficial se conecta a uma conta comum como um WhatsApp Web, por QR Code, sem autorização do WhatsApp e com risco de banimento da conta.
A Evolution API é um servidor de código aberto com dois tipos de conexão: uma pelo Baileys, que é não oficial, e outra pela Cloud API da Meta, que é a oficial. Depende de qual você configura.
Não. A Z-API conecta pelo mesmo canal do WhatsApp Web, com leitura de QR Code, e não é a plataforma WhatsApp Business da Meta.
Pode dar. Os Termos do WhatsApp vedam software não autorizado e mensagens automáticas, e os próprios projetos avisam que não há garantia contra bloqueio. O WhatsApp não publica o limite que dispara o banimento.
Pode. O número é ativado no app do WhatsApp Business com o código por ligação de voz e depois a ferramenta se conecta por QR Code. Na conexão oficial da Evolution API, o número é registrado na Cloud API.
Não. O que é punido é o comportamento, não o número. Um número separado limita o prejuízo: se a conta cair, o número principal da empresa não é afetado.
A Cloud API é voltada a conversas entre a empresa e cada cliente. Automação em grupos é o caso em que as pessoas costumam recorrer às bibliotecas não oficiais.