WhatsApp: API Oficial ou Z-API?

Geral

Existem dois caminhos pra conectar o WhatsApp ao CRM. Os dois têm risco de perder o número. O que muda é o tamanho do risco e a previsibilidade das regras.

• API Oficial da Meta (WhatsApp Cloud API) — é a indicação. Canal autorizado pela Meta, com regras publicadas e risco menor. Sem custo extra no CRM, mas exige número dedicado, uns 25 minutos de configuração e cartão internacional.
• Z-API (não oficial) — conecta o número que você já usa, por QR code, em um minuto. Custa R$ 100/mês por número. É o caminho mais rápido e o de maior risco de banimento.

Comparativo direto

Como funciona a Z-API

A Z-API é um serviço brasileiro que pareia o seu número pelo mesmo mecanismo do WhatsApp Web: você lê um QR code e o número fica conectado ao CRM.

O CRM cria e gerencia essa conexão. Você não precisa criar conta na Z-API nem copiar credencial — é dar um nome pro número, aceitar o termo de risco e escanear o QR.

Tudo que entra e sai pelo número aparece no inbox em tempo real, e a IA lê as conversas pra sugerir o próximo passo.

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; o histórico não se perde.

Como funciona a API Oficial

É o canal autorizado pela Meta. Você cria um aplicativo no painel de desenvolvedores, pega quatro credenciais (Token de acesso, Phone Number ID, WABA ID e Chave secreta do app), configura pagamento e webhook, e cola tudo no CRM. Passo a passo em Conectar pela API Oficial da Meta.

Duas coisas mudam no dia a dia:

1. O número sai do aplicativo comum do WhatsApp. Depois de entrar na API oficial, ninguém abre aquele número no celular pra responder. Use um chip novo ou um número dedicado ao atendimento; nunca migre o número pessoal do dono.
2. Você não inicia conversa livremente. A Meta só deixa a empresa puxar assunto com um template aprovado. Depois que o cliente responde, abre uma janela de 24 horas de conversa livre. Passou das 24h sem resposta, volta a valer o template.

O risco da API Oficial

Ser oficial não é passe livre:

• A conta e o número podem ser restringidos ou banidos por violação da política do WhatsApp Business — spam, denúncia, bloqueio em massa, conteúdo proibido.
• A nota de qualidade cai (Verde, Amarelo, Vermelho) quando as pessoas bloqueiam ou denunciam. Nota baixa significa menos mensagens liberadas por dia e pode chegar a derrubar o número.
• Template pode ser reprovado ou pausado, e aí você não consegue mais iniciar conversa.
• Falta de pagamento para tudo. Cartão recusado, mensagem não sai.

O que a API Oficial dá não é imunidade, é previsibilidade: as regras são publicadas, existe nota de qualidade pra acompanhar e o aviso vem antes da queda. Na não oficial, você descobre que perdeu o número quando ele já caiu.

O preço

• Z-API: R$ 100/mês por número conectado, renovando junto com o plano, no mesmo ciclo (mensal, semestral ou anual). Sem desconto por ciclo.
• Comprou no meio do ciclo? Paga só o proporcional até a renovação; depois entra o valor cheio.
• Excluiu ou arquivou um número? A conexão cai na hora, mas o valor já pago vale até o fim do ciclo. Conectando outro número dentro do mesmo ciclo, usa o mesmo slot pago, sem cobrar de novo. Na renovação, cobra pela quantidade de números existentes naquele momento.
• Meta: sem custo extra no CRM. A Meta cobra por mensagem, em dólar, no seu cartão internacional. Sem cartão vinculado, as mensagens param depois do teste.
• Quem compra número: dono ou admin do workspace, pela própria tela de conexão.

O risco da Z-API

A Z-API é integração não oficial. É isso que a torna simples de ligar, e é daí que vem o risco.

• O WhatsApp pode desconectar ou banir o número. O gatilho mais comum é comportamento de spam: disparo em massa pra quem não te conhece, muitas mensagens iguais, gente bloqueando e denunciando.
• A decisão é da Meta. Nem a Z-API nem o CRM conseguem impedir ou reverter com garantia. Existe recurso dentro do próprio WhatsApp, mas sem prazo e sem certeza.
• Número banido é número perdido. Não conecte o número pessoal do dono; use um número da operação.
• Por ser não oficial, a conexão pode ser derrubada mesmo com você fazendo tudo certo.
• Uso normal de vendas — conversa um a um com gente real que espera o seu contato — tem risco menor, mas nunca zero.

Ao conectar qualquer número via Z-API, o CRM exige marcar "Li e aceito os riscos de conectar meu número via Z-API". Sem o aceite, a conexão não é criada. O aceite fica registrado na conta: quem aceitou e quando.

Como reduzir o risco (vale pros dois caminhos)

• 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 mandar a mesma mensagem pra muita gente.
• Evite link encurtado e mensagem repetida em massa em pouco tempo.
• Use um número da operação, nunca o pessoal do dono.

Qual escolher

A indicação é a API Oficial da Meta. Se você pode montar um número dedicado e configurar o cartão, vá por ela.

A Z-API existe pra quem precisa do número que já usa, hoje, e aceita o risco maior.

• Dá pra usar um número dedicado? → API Oficial.
• Operação crítica, alto volume, número que não pode cair? → API Oficial.
• Precisa do número que a empresa já usa, ligado hoje, e entendeu o risco? → Z-API, com as boas práticas acima.

Dá pra migrar depois: conecte o número novo na Meta e exclua o canal antigo.

De quem é a responsabilidade pelo número

O número é seu. A decisão do canal é sua. 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. Banir é decisão da Meta. Disparo em massa, lista comprada e mensagem para quem não autorizou são uso indevido.

Dúvidas comuns

• "Posso usar os dois ao mesmo tempo?" Pode. Um workspace aceita canais Z-API e canais Meta convivendo.
• "Quantos números posso ter?" Na Z-API, quantos você pagar (sem limite por assento). Na Meta, 1 número por assento, sem custo extra. Pra mais números Meta que assentos, fale com o suporte.
• "Desconectar o número para a cobrança?" Não. Desconectar só derruba a sessão; o que encerra a cobrança é excluir ou arquivar o canal.
• "O CRM manda mensagem sozinho pelos dois?" Não manda sozinho por nenhum. O sistema escreve e você aperta enviar.