WhatsApp: API Oficial ou Z-API?

A escolha que você faz uma vez e carrega o ano inteiro

Pra conectar o WhatsApp ao CRM existem dois caminhos. Eles não são "um seguro e um perigoso" — são dois negócios diferentes, com preço diferente e grau de risco diferente.

Vou ser honesto logo de cara, porque isso aqui não é lugar de vender ilusão: os dois têm risco. Não existe canal sem risco de perder o número. Quem promete isso está te enganando. O que muda é o tamanho do risco e a previsibilidade das regras.

Escolher errado aqui custa caro depois: ou você paga mais do que precisava, ou você coloca em risco o número que a sua empresa inteira usa. Então lê esta página com calma antes de clicar em qualquer coisa.

• API Oficial da Meta (WhatsApp Cloud API) — é o que a gente indica. Canal autorizado pela própria Meta, com regras publicadas e risco menor. Não tem custo extra no CRM, mas exige um 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 (o caminho rápido)

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

O CRM cria e gerencia essa conexão sozinho. Você não precisa criar conta na Z-API nem copiar credencial nenhuma — é 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 do CRM 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 caminho que a gente indica)

É o canal autorizado pela Meta. Você cria um aplicativo no painel de desenvolvedores, gera três credenciais (Token de acesso, Phone Number ID, WABA ID), configura pagamento e webhook, e cola tudo no CRM. O passo a passo completo está no artigo Conectar pela API Oficial da Meta.

Duas coisas mudam de verdade no seu 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. Por isso: 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 (sim, ela tem)

Ser oficial não é passe livre. Você continua jogando dentro da casa da Meta, e a Meta pune quem incomoda o usuário dela:

• 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 — vale tudo isso aqui também.
• A nota de qualidade cai (Verde, Amarelo, Vermelho) quando o pessoal bloqueia ou denuncia. 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ê simplesmente não consegue mais iniciar conversa.
• Falta de pagamento para tudo. Cartão recusado, mensagem não sai.

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

Traduzindo: os dois caminhos podem custar o seu número. O oficial avisa; o não oficial, não.

O preço, sem letra miúda

• 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 — é 100 vezes a quantidade de meses.
• 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. Se você conectar 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 que existirem 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. Nunca precisa "falar com o time" pra isso — a própria tela de conexão vira a tela de compra.

O risco da Z-API, sem rodeio

A Z-API não é a API oficial da Meta. É integração não oficial. É exatamente 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. Por isso: não conecte o número pessoal do dono. Use um número da operação.
• Além da política, tem o risco do próprio método: por ser não oficial, a conexão pode ser derrubada mesmo com você fazendo tudo certo.
• Na prática, 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 — a exigência é do servidor, não dá pra pular. 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.

Essas boas práticas não são frescura de compliance. Elas são exatamente o que eu ensino sobre vendas: um a um, com contexto. Quem vende do jeito certo raramente é banido — nos dois canais.

Então, qual eu escolho?

A nossa indicação é a API Oficial da Meta. Ela tem risco, como toda conexão de WhatsApp, mas é menor e com regra publicada. 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 conscientemente o risco maior. É uma escolha legítima — desde que seja escolha, e não desconhecimento.

• Dá pra usar um número dedicado? → API Oficial.
• Operação crítica, alto volume, número que não pode cair de jeito nenhum? → API Oficial, sem pensar duas vezes.
• 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: você conecta o número novo na Meta e exclui o canal antigo.

De quem é a responsabilidade pelo número

Isto aqui precisa estar escrito, sem meia palavra:

O número é seu. A decisão do canal é sua. 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 por uso indevido do WhatsApp. Banir é decisão da Meta, e ninguém aqui tem como impedir ou reverter. Disparo em massa, lista comprada e mensagem para quem não autorizou são uso indevido — e a conta disso vem pra você, não pra plataforma.

Escolha o canal com essa informação na mão e trate seu número como o ativo que ele é.

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 (não tem limite por assento). Na Meta, 1 número por assento, sem custo extra. Precisa de mais números Meta que assentos, fale com o time.
• "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. Aqui o sistema escreve e você aperta enviar. É decisão de método, não limitação técnica.