Z-API: o que é, como funciona e quais os riscos
Abrir essa tela no CRM/settings/whatsappResumo
A Z-API é o jeito rápido de conectar o WhatsApp que você já usa, e ela tem risco de perder o número.
A indicação é a API Oficial da Meta, de risco menor. A Z-API existe pra quem precisa do número que já usa, ligado hoje, e aceita o risco maior.
O que é a Z-API
Um serviço brasileiro que conecta um número de WhatsApp comum ao CRM usando o mesmo mecanismo do WhatsApp Web: você escaneia um QR code e o número fica pareado. Não exige aprovação da Meta nem conta business verificada.
A Z-API não é a API oficial da Meta: é integração não oficial. É isso que a torna simples, e é daí que vem o risco.
Como funciona no CRM
- O CRM cria e gerencia a conexão. Você não cria conta na Z-API: dá um nome pro número, escaneia o QR e pronto.
- Tudo que chega e sai pelo número aparece no inbox em tempo real, e a IA lê as conversas pra sugerir os próximos passos.
- Se o celular ficar muito tempo sem internet, ou o WhatsApp for aberto em outro pareamento, a sessão pode cair. É só escanear o QR de novo.
- Preço: R$ 100/mês por número conectado, renovando junto com o plano.
Os riscos
- O WhatsApp (Meta) pode desconectar ou banir o número conectado por método não oficial. O gatilho mais comum é comportamento de spam: disparo em massa pra quem não conhece o número, muitas mensagens iguais, muitas denúncias e bloqueios.
- O banimento é decisão da Meta, não da Z-API nem do CRM. Nenhum dos dois consegue impedir ou reverter com garantia. Existe recurso dentro do WhatsApp, mas sem prazo e sem certeza.
- Número banido é número perdido. Por isso, não conecte o número pessoal do dono — use um número da operação.
- Uso normal de vendas (conversa um a um com leads reais que esperam o seu contato) tem risco bem menor, mas nunca zero.
- Existe também o risco do método, que independe do seu comportamento: por ser não oficial, a conexão pode ser derrubada mesmo com você fazendo tudo certo.
Como reduzir o risco
- Aqueça número novo: comece com poucas conversas por dia e vá subindo.
- Fale com quem espera o seu contato — nada de lista fria comprada.
- Peça pros clientes salvarem o seu número.
- Converse de verdade: pergunta, resposta, áudio, em vez de mensagem idêntica em massa.
- Evite link encurtado e mensagem repetida pra muita gente em pouco tempo.
Quem toma bloqueio costuma ser quem usa o canal como ferramenta de disparo em massa. Este CRM não faz isso.
O aceite de risco
Ao conectar qualquer número via Z-API, o CRM mostra o aviso e exige marcar "Li e aceito os riscos de conectar meu número via Z-API". Sem o aceite, a conexão não é criada — a exigência é do servidor.
O aceite fica registrado na conta: quem aceitou e quando.
A alternativa de risco menor: API Oficial da Meta
A API Oficial da Meta (WhatsApp Cloud API) é o canal autorizado pela própria Meta.
Ela também tem risco: a Meta restringe e bane número por violação da política do WhatsApp Business, a nota de qualidade cai e derruba o limite de envio, e template pode ser reprovado. A diferença é que lá as regras são publicadas e o aviso vem antes. Na Z-API, além da política, existe o risco do próprio método.
Não tem custo extra no CRM (a Meta cobra por mensagem, direto de você), mas exige conta WhatsApp Business verificada no Business Manager e não conecta o número comum que a empresa já usa no celular — o número sai do aplicativo.
Regra prática:
- Dá pra usar um número dedicado? → API Oficial da Meta.
- Operação crítica, alto volume, número que não pode cair? → API Oficial da Meta.
- Precisa do número que a empresa já usa, ligado hoje, e entendeu o risco? → Z-API, com as boas práticas acima.
O comparativo completo, com preços lado a lado, está em WhatsApp: API Oficial ou Z-API?.
De quem é a responsabilidade pelo número
O número é seu, a escolha do canal é sua e o uso é seu. O CRM indica a API Oficial, explica os riscos dos dois caminhos e exige o aceite antes de conectar pela Z-API.
Nem o CRM do Jordão nem a Z-API se responsabilizam por banimento, bloqueio, restrição, perda de número ou uso indevido do WhatsApp. Disparo em massa, lista comprada e mensagem pra quem não autorizou são uso indevido.
Se o número for banido ou desconectar
- Desconectou (caiu a sessão): reabra Configurações → Canais de WhatsApp, gere o QR e escaneie de novo. O histórico não se perde.
- Banido: entre com recurso dentro do app do WhatsApp (Suporte → pedir revisão). O CRM não tem como reverter. Pra voltar a operar, conecte outro número e exclua o canal antigo — o slot pago vale até o fim do ciclo, então conectar o número novo no mesmo ciclo não cobra de novo.