Conectar o WhatsApp ao CRM

As três formas de conectar

Dá pra ligar o WhatsApp ao CRM por três caminhos, com preços e tempos de instalação diferentes.

1. Extensão do Chrome — inclusa no plano, sem custo extra. Abre um painel do CRM ao lado do WhatsApp Web que a pessoa já usa; não precisa de número novo nem credencial. Caminho: Configurações → Conta e equipe → Dispositivos conectados (/settings/dispositivos). Detalhes em *Extensão do WhatsApp Web*.
2. API Oficial da Meta (Cloud API) — sem custo no CRM. O cliente paga as mensagens direto para a Meta, no cartão do Business Manager dele. Exige número dedicado e leva ~25 minutos pra ligar.
3. Z-API — R$ 100/mês por número, contratado dentro do CRM. Conecta por QR code em ~1 minuto, usando o número que a empresa já tem.

Caminho exato de cliques

• Conectar/ver números: Configurações → seção Canais e integrações → WhatsApp (/settings/whatsapp) → Conectar novo número.
• Extensão do Chrome: Configurações → Conta e equipe → Dispositivos conectados (/settings/dispositivos).
• Convidar o time: Configurações → Conta e equipe → Equipe e permissões (/settings/team).
• Plano, cobrança e nota: Configurações → Conta e equipe → Plano e cobrança (/settings/plano).

Por que conectar logo no começo

Sem WhatsApp conectado, boa parte do CRM não funciona: é por ali que a conversa acontece. O item WhatsApp do menu fica com um ponto amarelo e, ao clicar, a tela mostra o botão Conectar WhatsApp.

É a última peça da Missão (o onboarding do primeiro acesso): ao concluir a Missão, o dono cai nesta tela com o aviso "Liga teu WhatsApp". O botão Conectar meu WhatsApp desse aviso rola até o card da extensão do WhatsApp Web, que é o caminho mais rápido (instala no Chrome em dois cliques, sem comprar número); os canais por API (Meta e Z-API) ficam logo abaixo, pra quem precisar deles. Pulou? A pendência fica no checklist da Missão (/onboarding) e no aviso do painel de KPIs.

Escolher entre Meta e Z-API

O comparativo completo, com preços e riscos, está em WhatsApp: API Oficial ou Z-API? — o link também aparece na própria tela de escolha.

1. WhatsApp Cloud API (Meta, oficial) — a indicação. Não tem QR: a conexão é feita pela Meta. Sem custo extra no CRM (a Meta cobra por mensagem). Limite de 1 número por assento, e o número sai do app comum do WhatsApp. Duas formas de ligar, dependendo do ambiente:

• Conectar automaticamente (Conexão automática/Tech Provider, quando habilitada): abre o login da Meta em um popup — você escolhe a conta e o número, e o CRM guarda token e assina o webhook sozinho. Só pede um nome pro número (e, opcionalmente, o vendedor responsável). O link "Prefiro colar as credenciais na mão" leva pro formulário manual.
• Formulário manual (sempre disponível, é o único caminho onde a conexão automática não está habilitada): exige Phone Number ID, WABA ID, Access Token, Chave secreta do app e Webhook Verify Token, todos do painel da Meta — passo a passo em Conectar pela API Oficial da Meta.

1. Z-API — conecta o WhatsApp que você já usa por QR code, igual ao WhatsApp Web. O CRM cuida de tudo: você não precisa criar conta na Z-API nem copiar credencial. Custa R$ 100/mês por número. É integração não oficial, com risco maior de perder o número.

Os dois têm risco de banimento. 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

Em /settings/whatsapp, clique em Conectar novo número e escolha Z-API:

1. Com número disponível no plano, o formulário abre direto. Sem número disponível, a mesma tela vira a compra: mostra o valor proporcional até a renovação e o botão de pagar.
2. Dê um nome pro número ("Comercial", "João Vendas") e, se quiser, escolha o vendedor responsável.
3. Leia o aviso e marque "Li e aceito os riscos de conectar meu número via Z-API". Sem o aceite, o botão não libera.
4. Clique em Gerar QR code.
5. No celular, abra WhatsApp → Aparelhos conectados → Conectar um aparelho e escaneie o QR.
6. Ao dar certo, o QR sai da tela e entra a confirmação "WhatsApp conectado", com o número pareado. Clique em Concluir. Se a janela ficar no QR, o pareamento ainda não foi reconhecido: espere alguns segundos ou gere um QR novo.

Preço do número Z-API

• R$ 100/mês por número, renovando junto com o plano, no mesmo ciclo (mensal, semestral ou anual). Sem desconto por ciclo.
• Adicionar no meio do ciclo cobra só o proporcional até a renovação; depois, valor cheio.
• Onde adicionar: no diálogo Conectar WhatsApp (que vira tela de compra quando não há número disponível) 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.
• Quem pode comprar: dono ou admin do workspace.

Excluir, arquivar e restaurar um número Z-API

• Excluir ou arquivar cancela a conexão na hora. O valor pago vale até o fim do ciclo: excluir e conectar outro número dentro do mesmo ciclo usa o mesmo slot pago.
• Na renovação, a cobrança é pela quantidade de números existentes naquele momento.
• Restaurar um número arquivado ocupa um slot de novo: só funciona se ainda houver número disponível no plano.

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"

Adicione 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 e, se estiver desconectado, 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 paga. Pra mais números Meta que assentos, fale com o suporte.

Como reconectar ou desconectar um número

Na lista 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:

• 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 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.

Ainda precisa de ajuda

Use o botão de suporte no canto da tela. Se depois do 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 ou instabilidade da Z-API: fale com o suporte técnico.