Z-API: o que é, como funciona e quais os riscos
Abrir essa tela no CRM/settings/whatsappLeia isto antes de conectar seu número
Vou ser direto, porque aqui não cabe enrolação: a Z-API é o jeito rápido de conectar o WhatsApp que você já usa, e ela tem risco.
A nossa indicação é a API Oficial da Meta, que tem risco menor. A Z-API existe pra quem precisa do número que já usa, ligado hoje, e aceita conscientemente o risco maior.
Pra quem vende do jeito certo, o risco cai bastante. Mas não é zero — e você tem que saber disso antes de plugar o número que a sua empresa inteira usa.
O que é a Z-API
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. É o jeito mais rápido de conectar o número que a empresa já usa — sem aprovação da Meta, sem conta business verificada.
Importante: a Z-API não é a API oficial da Meta. É uma tecnologia de integração não oficial. É exatamente isso que a torna simples — e é daí que vem o risco.
Como funciona no CRM
- O CRM cria e gerencia a conexão sozinho. 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 do CRM 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 (detalhes no artigo de planos).
Os riscos, sem rodeio
- O WhatsApp (Meta) pode desconectar ou até BANIR o número conectado por método não oficial. O gatilho mais comum é comportamento de spam: disparo em massa pra gente que não conhece o número, muitas mensagens iguais, alto índice de denúncia e bloqueio pelos destinatários.
- O banimento é decisão da Meta, não da Z-API nem do CRM. Nenhum dos dois consegue impedir nem reverter com garantia. Existe recurso dentro do próprio WhatsApp, mas sem prazo e sem certeza.
- Número banido significa que a empresa perde aquele número no WhatsApp. Por isso não recomendamos conectar 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 na prática. Mas ele nunca é zero.
- E existe 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 (boas práticas)
- Aqueça número novo: comece com poucas conversas por dia e vá subindo aos poucos.
- Fale com quem espera o seu contato — nada de lista fria comprada.
- Peça pros clientes salvarem o seu número nos contatos.
- 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.
Repare que essa lista é a mesma coisa que eu ensino sobre vendas há 30 anos. Vender um a um, com contexto, falando com quem quer falar com você. Quem vende assim quase nunca é banido — porque não está fazendo o que o WhatsApp pune.
Quem toma bloqueio é quem tenta usar o CRM como ferramenta de disparo em massa. E, aviso: este CRM não foi feito pra isso e não faz isso.
O aceite de risco ("li e aceito")
Ao conectar qualquer número via Z-API, o CRM mostra o aviso de risco 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, não dá pra pular.
O aceite fica registrado na conta: quem aceitou e quando.
A alternativa de risco menor: API Oficial da Meta
A nossa indicação é a API Oficial da Meta (WhatsApp Cloud API): é o canal autorizado pela própria Meta.
Atenção: ela também tem risco. A Meta restringe e bane número por violação da política do WhatsApp Business — spam, denúncia, bloqueio em massa —, a nota de qualidade cai e derruba o seu limite de envio, e template pode ser reprovado. O que muda é que lá as regras são publicadas e o aviso vem antes. Aqui na Z-API, além da política, existe o risco do próprio método: a conexão cai mesmo com você fazendo tudo certo.
Não tem custo extra no CRM (a Meta cobra por mensagem, direto de você), mas exige conta WhatsApp Business com verificação 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 (a nossa indicação).
- Operação crítica, alto volume, número que não pode cair? → API Oficial da Meta, sem pensar duas vezes.
- Precisa do número que a empresa já usa, ligado hoje, e entendeu o risco maior? → Z-API com as boas práticas acima.
O comparativo completo, com preços lado a lado, está no artigo 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. A gente 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. Banir é decisão da Meta e ninguém aqui consegue impedir nem reverter. Disparo em massa, lista comprada e mensagem pra quem não autorizou são uso indevido — e a conta disso é sua.
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 próprio 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.