Conectar o WhatsApp ao CRM
Abrir essa tela no CRM/settings/whatsappO passo mais importante do começo
Sem WhatsApp conectado, o inbox fica vazio e metade do CRM não faz sentido. É por ali que a conversa acontece.
A tela fica em Configurações → Canais de WhatsApp (/settings/whatsapp). São dois jeitos de conectar, e a escolha vale a pena entender antes de clicar: leia WhatsApp: API Oficial ou Z-API? se quiser o comparativo completo com preços e riscos.
Resumo pra decidir agora:
- WhatsApp Cloud API (Meta, oficial) — é o que a gente indica. Exige Phone Number ID, WABA ID, Access Token e Webhook Verify Token, tudo do Business Manager. Não tem QR: a conexão é feita pela Meta. Não tem custo extra no CRM (a Meta cobra por mensagem, direto de você). Limite: 1 número por assento, e o número sai do app comum do WhatsApp.
- Z-API (o caminho rápido): conecta o WhatsApp que você já usa, lendo um QR code, igual ao WhatsApp Web. O CRM cuida de tudo — você não precisa criar conta na Z-API nem copiar credencial nenhuma. Custa R$ 100/mês por número conectado. É integração não oficial, com risco maior de perder o número.
Os dois têm risco de banimento; nenhum canal é imune. Regra prática: dá pra usar um número dedicado? Vá de Meta. Precisa do número que a empresa já usa, ligado hoje, e aceita o risco maior? Z-API.
Passo a passo Z-API (conectar o número)
Leva 1 minuto. Em /settings/whatsapp, clique em Conectar novo número e escolha Z-API:
- Se você tem número disponível no plano, abre o formulário direto. Se não tem (nunca comprou, ou todos em uso), a mesma tela vira a compra do número: mostra o valor proporcional até a renovação e o botão de pagar. Pagou, volta e conecta. Nunca precisa "falar com o time" pra isso.
- Dê um nome pro número (ex.: "Comercial" ou "João Vendas") e, se quiser, escolha o vendedor responsável.
- Leia o aviso de risco e marque "Li e aceito os riscos de conectar meu número via Z-API". A Z-API é integração não oficial e o WhatsApp pode desconectar ou banir o número — os detalhes estão no artigo Z-API: o que é, como funciona e quais os riscos. Sem o aceite, o botão não libera (e o servidor também exige).
- Clique em Gerar QR code.
- No celular, abra WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o QR. Pronto, conectado.
Preço do número Z-API
- Cada número conectado via Z-API custa R$ 100/mês e renova junto com o plano, no mesmo ciclo (mensal, semestral ou anual). Sem desconto por ciclo.
- Ao adicionar um número no meio do ciclo, cobra só o proporcional até a data da renovação. A partir da renovação entra o valor cheio.
- Onde adicionar: direto no diálogo Conectar WhatsApp (sem número disponível, ele mesmo vira a tela de compra, inclusive do primeiro número) ou em Configurações → Plano e Cobrança, seção Números de WhatsApp.
- Números na API Oficial da Meta não pagam esse valor — são gratuitos no CRM, e por isso não têm limite de quantidade por esse motivo.
- Quem pode comprar: dono ou admin do workspace.
Excluir, arquivar e restaurar um número Z-API
- Excluir ou arquivar um número cancela a conexão na hora. O valor já pago vale até o fim do ciclo: se você excluir e conectar outro número dentro do mesmo ciclo, usa o mesmo slot pago, sem cobrar de novo.
- Na renovação, a cobrança é pela quantidade de números que existem naquele momento. Excluiu e não repôs, a renovação já vem menor.
- Restaurar um número arquivado ocupa um slot de novo: só funciona se ainda houver número disponível no plano (senão a tela pede pra adicionar um em Plano e Cobrança).
Erros comuns e como resolver
Antes de suspeitar de bug, confira duas coisas: se o número está desconectado e se o limite de números do plano foi atingido.
O QR code não aparece (ou vem quebrado)
Clique em Tentar de novo. Se não resolver, clique em Desconectar e gere um QR novo.
"Todos os seus números Z-API estão em uso" (ou "seu plano ainda não inclui números Z-API")
É só adicionar um número — a própria tela de conexão oferece a compra (R$ 100/mês, proporcional até a renovação). Alternativa sem custo: API Oficial da Meta.
A mensagem sai com um tique só e não entrega
Quase sempre é um destes dois casos: o número de destino não tem WhatsApp, ou a instância caiu. Confira o status do canal em /settings/whatsapp. Se estiver desconectado, reconecte: gere o QR e escaneie de novo.
O número desconectou sozinho
O WhatsApp Web cai quando o celular fica muito tempo sem internet, ou quando o WhatsApp é aberto em outro pareamento. Reabra /settings/whatsapp, gere o QR e escaneie de novo.
"Seu workspace permite N números"
Esse limite (1 número por assento) vale SÓ pra canais da API Oficial da Meta. Z-API não tem limite por assento — o teto é a quantidade de números pagos. Pra mais números Meta que assentos, fale com o time.
Como reconectar ou desconectar um número
Na lista de números em /settings/whatsapp, cada canal tem as ações de conectar, desconectar e reconectar.
Como o time atende: número compartilhado ou individual?
Na mesma tela, você escolhe o modo de atendimento do time:
- Número(s) compartilhado(s): vários vendedores atendem pelos mesmos números — quem responder primeiro assume a conversa.
- Um número por vendedor: cada vendedor tem o próprio número, e a conversa que chega já entra atribuída ao dono.
Boas práticas pra não bloquear o número
Não dispare em massa pra quem não conhece o seu número. Peça pros contatos salvarem o seu contato. Aqueça número novo começando com poucas conversas por dia.
Nada disso é frescura: é exatamente o jeito de vender que eu ensino. Quem conversa um a um, com contexto, quase nunca toma bloqueio.
Ainda precisa de ajuda?
Se você travar em algum passo, use o botão de suporte no canto da tela. Se depois de seguir o passo a passo o problema continuar — o QR não gera nunca, a conexão cai toda hora, mensagens não entregam mesmo com o número certo —, pode ser bug real ou instabilidade da Z-API: fale com o suporte técnico.