Resposta rápida
A Z-API pluga o número que a PME já usa no WhatsApp numa instância: sessão de WhatsApp Web, API REST por cima. Resolve um número. Quando esse número vira ativo de carteira, a sessão pode cair, o WhatsApp pode restringir, e o celular do cliente vira peça da sua operação. Na Cloud API oficial o número é homologado pela Meta. Dá pra manter o WhatsApp Business App aberto (coexistência) ou migrar de vez. Regra curta: Z-API pra um número que precisa continuar no app sem burocracia; Cloud API pra carteira em que o número não pode cair.
A Z-API resolve. Se o trabalho é ligar o número que a PME já usa no app ao seu sistema, ela entrega, e a gente não vai fingir o contrário. Este comparativo é sobre o dia em que esse número vira o WhatsApp de um cliente pagante. Quem lê é quem revende. A PME é o cliente dele.
O número já está na Z-API. E agora?
Essa é a objeção que trava a conversa. O cliente da PME já atende por aquele número. A instância já dispara. Trocar de API parece pedir pra empresa largar o contato que o Brasil inteiro já tem salvo. Não é isso. O número pode continuar o mesmo. O que muda é o que aquele número é: sessão de WhatsApp Web, ou número homologado na Cloud API.
O que a Z-API faz com o número da empresa?
Na documentação da Z-API, uma instância é a conexão de um número, rodando num container. O serviço, nas palavras deles, “roda com base em um WhatsApp Web” e abstrai isso numa API REST. Você lê um QR code, igual no WhatsApp Web.
Não é a Cloud API da Meta. A própria Z-API descreve o produto como API Web. Pra um número, isso é o que o dono da PME quer ouvir: não precisa de número novo. Sem App Review, sem WABA, sem template. É por isso que a primeira instância sobe rápido.
O número continua no aplicativo?
Depende da instância.
Na instância web, a Z-API entra como dispositivo secundário, no modelo multi-device. O celular da empresa continua com o app. O FAQ deles diz que a integração “requer apenas um telefone com WhatsApp ativo”.
Na instância mobile, a que eles chamam de Phoneless, a instância vira o dispositivo primário. O número sai do celular físico. É o contrário do “número que a PME já usa no app”.
Se o argumento de venda foi “o cliente continua no WhatsApp dele”, você está na instância web. Aí o celular da PME vira peça da sua operação.
O que muda quando esse número entra na Cloud API?
O dígito pode ser o mesmo. O contrato não. Três caminhos, os mesmos de quem sai da Evolution:
- Mesmo número, dedicado à API. Sai do app e vive só na Cloud API. Os contatos não percebem.
- Mesmo número, em coexistência. O WhatsApp Business App continua no celular e a API roda junto. Não é continuação da sessão da Z-API: a Meta pede o app Business e o app aberto pelo menos a cada 13 dias.
- Número novo. Só se o atual tem histórico ruim. Último recurso.
Fora da janela de 24 horas, só template aprovado. O disparo livre da sessão Web não existe no oficial. A tarifa é da Meta, por mensagem entregue, cobrada do dono da WABA: quanto custa o WhatsApp API.
Registrou na Cloud API, a sessão de WhatsApp Web cai na hora. Não existe Z-API e Cloud API no mesmo número. Templates e webhook prontos antes de registrar.
Onde a Z-API para de servir numa carteira?
Não é VPS. A Z-API é gerenciada: eles hospedam a instância, têm fila, webhook, várias instâncias e programa de partner. O que escala mal é o número. A própria Z-API documenta bloqueio e shadowban da sessão Web. Dizem que não têm limite de mensagens, e no mesmo parágrafo: você está numa sessão de WhatsApp Web, o padrão de uso precisa ser compatível. Na documentação de 2026 eles descrevem casos em que só conectar um número novo já gera banimento.
Pra um número de teste, risco tolerável. Pra PME pagante, cada ban é operação parada e a culpa é sua.
O oficial troca isso por burocracia: WABA, template, Tech Provider, Embedded Signup. Quem revende sozinho paga com App Review. Quem roda sob o Tech Provider de uma plataforma manda um link de setup. O passo a passo está em como revender WhatsApp oficial no Brasil.
Resumo da comparação
| O que importa | Z-API | Cloud API (oficial) |
|---|---|---|
| O que o número é | Sessão de WhatsApp Web (instância) | Número homologado pela Meta |
| Continua no app? | Instância web: sim, dispositivo secundário. Instância mobile: sai do celular. | Dedicado: sai do app. Coexistência: fica no WhatsApp Business App. |
| Homologação da Meta | Não. Eles descrevem como API Web. | Sim |
| Risco de bloqueio por usar a API | Existe. A Z-API documenta ban e shadowban. | Não toma ban por ser sessão Web. Qualidade de template é outro assunto. |
| Disparo fora da janela de 24h | Como no app | Só template aprovado |
| Grupo, status, recurso de app | Como no WhatsApp Web | Cloud API não tem. Em coexistência, grupo fica só no app. |
| Cobrança da mensagem | Mensalidade por instância (ver no site da Z-API) | Tarifa da Meta por mensagem entregue, cobrada do dono da WABA |
| Quem conecta o número do cliente | Você, na instância | O cliente, na WABA dele |
Quando ficar na Z-API
Se você atende um cliente só, o número precisa continuar no app (e não só no Business), o fluxo usa grupo ou status e a PME aceita o risco da sessão, fica na Z-API. A Cloud API não cobre isso.
A BotoZap é a camada multi-tenant sobre a Cloud API: o cliente da PME conecta a WABA dele por um link de setup, sob a nossa aprovação de Tech Provider. Token no Vault, isolamento por conta, plano grátis pra testar. A tarifa da mensagem é da Meta e ela cobra o seu cliente direto. A gente não mete markup nisso.
Quando não usar a BotoZap: um cliente só, que precisa de grupo ou de continuar no WhatsApp comum, e aceita o risco. Aí a Z-API continua sendo a ferramenta certa. A gente fala isso na cara.
Antes de tirar o número da Z-API
- O número precisa continuar no aplicativo? Se sim, o caminho é coexistência no WhatsApp Business App, não a sessão da Z-API.
- Algum fluxo crítico usa grupo, status ou outro recurso de app? Isso não existe na Cloud API. Resolva antes.
- Quais mensagens saem sem o cliente ter falado? Cada uma vira template pra aprovar antes de registrar.
- O webhook novo está no ar e testado? Registrar derruba a instância.
- A WABA de destino é a definitiva? Número em coexistência não migra entre WABAs.
- Na coexistência, o cliente entendeu que o celular continua na operação (app aberto a cada 13 dias)?
Perguntas frequentes
A Z-API é a API oficial do WhatsApp?
Não. Eles descrevem o produto como API Web, baseada em sessão de WhatsApp Web. A API oficial é a WhatsApp Cloud API da Meta.
O número da empresa continua no aplicativo?
Na instância web, sim. Na instância mobile (Phoneless) e na Cloud API dedicada, não. Na coexistência, fica no WhatsApp Business App.
Posso ser banido usando Z-API?
Sim. A própria Z-API documenta ban e shadowban. Pra teste, tolerável. Pra PME pagante, cada ban é um cliente parado.
Dá pra migrar da Z-API pra Cloud API mantendo o número?
Sim, inclusive em coexistência. O histórico da sessão da Z-API não migra.
Posso rodar Z-API e Cloud API no mesmo número?
Não. O registro na Cloud API derruba a sessão de WhatsApp Web.
A Z-API serve pra revender WhatsApp pra vários clientes?
Serve pra plugar vários números, e eles têm programa de partner. O risco de cada sessão não some na carteira. Pra número que não pode cair, o caminho é a Cloud API oficial.