WhatsApp: API Oficial ou Z-API?
Abrir essa tela no CRM/settings/whatsappGeral
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
| API Oficial da Meta | Z-API (não oficial) | |
|---|---|---|
| Indicação | Sim | Alternativa rápida, risco maior |
| Como conecta | Credenciais do Business Manager | QR code, igual WhatsApp Web |
| Tempo pra ligar | ~25 minutos | ~1 minuto |
| Usa o número que você já tem | Não · precisa de número dedicado | Sim |
| O número continua no app do celular | Não · sai do app comum | Sim |
| Custo no CRM | Sem custo extra | R$ 100/mês por número |
| Custo fora do CRM | A Meta cobra por mensagem, em dólar, direto de você | Nenhum |
| Risco de perder o número | Menor · só por violar a política da Meta | Maior · violação de política e o próprio uso de API não oficial |
| Regras do jogo | Publicadas pela Meta, com aviso e nota de qualidade | Não publicadas · a queda vem sem aviso |
| Quantos números | 1 número por assento | Quantos você pagar |
| Iniciar conversa com quem nunca falou com você | Só com template aprovado pela Meta | Livre |
| Quem configura | Você no painel da Meta (o suporte ajuda) | Você, sozinho, na tela |
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:
- 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.
- 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 por número por mês. A Z-API tem renovação mensal própria, separada da assinatura do CRM. O primeiro pagamento cobre um mês. Números extras entram pelo valor proporcional ao tempo que falta no mês da Z-API.
- Se você escolheu o cartão salvo da Cielo, a renovação é automática nesse cartão. Com Pix ou cartão avulso, acesse Configurações → Plano e Cobrança → Números de WhatsApp → Renovar números. Períodos já pagos seguem até a data original. Veja o que acontece com a mensalidade vencida.
- Se você excluir ou arquivar um número, a conexão é encerrada. A vaga paga pode ser usada para conectar outro número até o fim do período da Z-API.
- 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.