Alternativa à Z-API: o que muda na API oficial
As duas enviam mensagem de WhatsApp por código. A diferença é o que sustenta a conexão: a Z-API mantém uma sessão do WhatsApp Web por número; o CRPRO Hub autoriza o número na Cloud API da Meta, e não há sessão para cair.
A diferença que importa
A documentação pública da Z-API é direta sobre como a conexão funciona: o número entra por leitura de QR code e o que existe do outro lado é, nas palavras dela, uma “sessão do WhatsApp Web”. Isso não é um detalhe de implementação — é o que define tudo o que vem depois: quem precisa reler o QR code, o que acontece quando a sessão cai e por que o número pode ser banido.
O CRPRO Hub trabalha sobre a Cloud API da Meta. O número é autorizado uma vez, na conta comercial do próprio cliente, pelo Embedded Signup. Não há navegador, não há sessão e não há QR code para reler.
Lado a lado
| Z-API | CRPRO Hub | |
|---|---|---|
| Base da conexão | Sessão do WhatsApp Web | Cloud API oficial da Meta |
| Como o número entra | Leitura de QR code | Autorização na conta Meta do cliente |
| Sessão para manter | Uma por número | Nenhuma |
| Termos de uso da Meta | Operação não prevista | Prevista e contratada |
| Risco para o número | Banimento | Classificação de qualidade da Meta |
| Custo por mensagem | Não repassado | Cobrado pela Meta, na conta do cliente |
| Número continua no celular | Não | Sim, por coexistência |
| Suporte da Meta | Não se aplica | Aplica-se ao número conectado |
Quando não vale trocar
Sendo honesto sobre o outro lado: existe caso em que a integração não oficial continua fazendo mais sentido, e vender o contrário seria desonesto.
- Número próprio, volume baixo, uso interno — se o número é seu, se o risco é seu e se ninguém depende dele para faturar, o custo por mensagem pesa mais que o risco.
- Automação que a API oficial não cobre — leitura de grupos, por exemplo, não existe na Cloud API. Se o seu produto depende disso, a troca não é uma migração, é uma reescrita de escopo.
- Protótipo descartável — para validar uma ideia em uma semana, montar conta comercial e verificação de negócio é atrito sem retorno.
O cálculo vira quando os números deixam de ser seus. Aí o banimento não é um contratempo técnico: é o número que o cliente divulga há anos, com o histórico dele dentro, perdido de um lado para o outro sem ninguém a quem recorrer.
Como migrar sem trocar de número
O argumento mais forte contra sair de uma integração não oficial sempre foi o número: a API oficial exigia dedicá-lo, tirá-lo do aplicativo e perder o histórico. A coexistência eliminou esse custo.
Hoje o mesmo número continua no aplicativo WhatsApp Business, no aparelho de sempre, e responde pela Cloud API ao mesmo tempo. O que o cliente digita no celular chega ao seu sistema como evento de eco. Na prática, a migração é uma autorização de alguns minutos — o passo a passo está aqui.
Perguntas frequentes
A Z-API é oficial?
Não. A documentação da própria Z-API descreve a conexão como uma sessão do WhatsApp Web, iniciada por leitura de QR code. A API oficial é a Cloud API, publicada e operada pela Meta, em que o número é autorizado pela conta comercial da empresa e não existe sessão de navegador envolvida.
Vale a pena trocar a Z-API pela API oficial?
Depende de quem assume o risco. Para um número próprio, de baixo volume, a diferença de custo pesa mais. Para quem opera números de clientes, o cálculo muda: um banimento é a perda do número do cliente, não do seu software, e não existe suporte nem contrato a que recorrer.
Dá para migrar da Z-API para a API oficial sem trocar de número?
Sim, por coexistência. O número sai da integração não oficial e é autorizado na Cloud API pelo Embedded Signup, continuando no aplicativo WhatsApp Business do cliente. Ele não troca de número, não perde o histórico e continua atendendo pelo celular.
A API oficial é mais cara que a Z-API?
Na mensalidade, normalmente sim, porque a Meta cobra por mensagem de template entregue e a integração não oficial não repassa esse custo. O que a comparação de mensalidade esconde é o custo de manter sessão viva por número e de recuperar a operação quando um número é banido.