Central de Ajuda

LeadWhats — WhatsApp Integrado ao CRM B2B · Ajuda LeadCNPJ

Chat de WhatsApp na plataforma: conecte pela API oficial da Meta ou por QR Code, use templates, fila anti-ban e atendimento em equipe no CRM.

Manual do Usuário

CRM e Vendas

O que é o LeadWhats?

O LeadWhats é o módulo de WhatsApp integrado ao CRM da LeadCNPJ. Ele permite enviar e receber mensagens diretamente pela plataforma, sem alternar entre ferramentas. Cada conversa fica vinculada ao lead no CRM, dando contexto completo para toda a equipe.

Exemplo prático: Você encontra uma empresa na busca, importa como lead no CRM e, sem sair da plataforma, envia uma mensagem personalizada pelo WhatsApp usando um template. O histórico da conversa fica registrado no card do lead para que qualquer membro da equipe possa dar continuidade.

O LeadWhats está disponível a partir do plano Growth. Números por plano: Growth (1), Scale (2), Scale AI (3), Enterprise (ilimitado). O limite é por número e não distingue canal — um número conectado pela API oficial da Meta ocupa uma vaga igual à de um conectado por QR Code. A conexão pela API oficial da Meta exige plano Scale ou superior; no Growth, o canal é o QR Code.

Conectando sua Conta de WhatsApp

Existem dois canais de conexão, e a escolha muda o que você pode fazer com o número:

Canal	Plano	Risco	Custo	Prospecção fria
API WhatsApp Cloud (oficial da Meta) — recomendada	A partir do Scale	Sem risco de banimento	A Meta cobra por conversa iniciada; respostas dentro da janela de 24h são gratuitas	Não permite (a política da Meta exige opt-in e template aprovado)
QR Code (não oficial)	A partir do Growth	Viola os termos do WhatsApp: há risco de banimento e perda definitiva do número	Gratuito	Permite, com limites de cadência automáticos

Opção 1 — API oficial da Meta (recomendada, a partir do plano Scale)

Antes de começar, você precisa de um aplicativo no Meta for Developers com o produto WhatsApp adicionado e um número de telefone cadastrado nele. Depois:

No painel da Meta, abra WhatsApp › Configuração da API e copie o Phone Number ID (só dígitos) e, se quiser registrá-lo, o WABA ID (ID da conta do WhatsApp Business).
Gere um token permanente de Usuário do Sistema em Configurações do Negócio › Usuários › Usuários do sistema, com a permissão whatsapp_business_messaging sobre esse número. Não use o token do Explorer: ele expira em 60 dias e derruba os envios.
Na LeadCNPJ, vá em LeadWhats › Configurações › Nova Conta, escolha API WhatsApp Cloud e cole o Phone Number ID, o token permanente e (opcionalmente) o WABA ID. Validamos a credencial na Meta na hora — se estiver errada, nada é salvo.
Com a conta criada, a tela passa a exibir o bloco Webhook da API WhatsApp Cloud com dois valores: a URL de callback e o token de verificação.
Volte ao painel da Meta em WhatsApp › Configuração › Webhook, cole a URL de callback e o token de verificação nos campos correspondentes e salve.
Ainda no webhook, assine o campo messages. Sem essa assinatura a Meta não entrega as mensagens recebidas e o número fica mudo na plataforma.

O token de verificação é gerado pela LeadCNPJ, não pela Meta. Ele é único por conta: você copia da nossa tela e cola no painel da Meta, que o usa para provar que o webhook é mesmo seu.

Ao migrar um número para a API oficial, ele deixa de funcionar no aplicativo do celular — passa a ser operado apenas pela API. Use um número dedicado ao atendimento.

Token expirado ou revogado

Se os envios começarem a falhar com erro de autenticação, o token da Meta expirou ou foi revogado. Gere um novo token permanente de Usuário do Sistema e, em LeadWhats › Configurações, abra "Token expirado ou revogado? Atualizar credencial" no bloco do webhook, cole o token e salve. Validamos na Meta antes de gravar, e o token de verificação é preservado — você não precisa reconfigurar o webhook. Por segurança, o token atual nunca é exibido de volta: ele fica cifrado e só pode ser substituído.

Opção 2 — QR Code (canal não oficial)

Conecta em segundos e não tem custo por mensagem, mas viola os termos de uso do WhatsApp: o número pode ser banido e perdido definitivamente. É o único canal que permite prospecção fria. Ao escolhê-lo, você confirma ciência desse risco.

Acesse o menu lateral → LeadWhats → ícone de configuração (⚙)
Clique em "Nova Conta" e escolha QR Code
Um QR Code será exibido na tela
No celular, abra o WhatsApp → Aparelhos Conectados → Conectar Aparelho
Escaneie o QR Code exibido na plataforma
Aguarde a verificação automática (geralmente leva 5-15 segundos)

Use um número dedicado para prospecção. Evite usar seu WhatsApp pessoal para envios em massa, pois o WhatsApp pode restringir contas com comportamento suspeito.

Interface de Chat

A tela do LeadWhats é dividida em 3 painéis:

Lista de conversas (esquerda) — Todas as conversas ativas, com busca e filtros: Meus, Lead, Clientes, Equipe, Arquivados e Bloqueados. Badge de mensagens não lidas
Conversa (centro) — Chat em tempo real com histórico completo. Campo de texto, anexos e botões de ação
Detalhes do CRM (direita) — Informações do lead vinculado: dados da empresa, status, temperatura, atividades e oportunidades. Permite editar o lead sem sair do chat

Tipos de Mensagem Suportados

Tipo	Formatos	Observação
Texto	Com formatação: negrito, _itálico_, ~riscado~, ```monospace```	Formatação do WhatsApp padrão
Imagem	JPG, PNG, GIF, WebP	Com legenda opcional
Vídeo	MP4, WebM, 3GP	Tamanho máximo do WhatsApp
Documento	PDF, DOC, DOCX, XLS, XLSX	Ideal para propostas e contratos
Áudio	Mensagem de voz	Gravação direta pela plataforma

Templates de Mensagem

Crie mensagens-modelo com variáveis dinâmicas que são substituídas automaticamente pelos dados do lead no momento do envio. Isso acelera a prospecção e mantém a personalização.

Variáveis disponíveis:

{{nome}} — Nome do contato
{{empresa}} — Nome da empresa
{{cidade}} — Cidade da empresa
{{estado}} — Estado (UF)
{{cargo}} — Cargo do contato
{{cnpj}} — CNPJ formatado

Exemplo de template: "Olá {{nome}}, tudo bem? Vi que a {{empresa}} atua em {{cidade}}/{{estado}} e acredito que podemos ajudar a expandir suas operações. Podemos conversar?"

Fila Inteligente Anti-Ban

Aplica-se ao canal não oficial (conexão por QR Code). Números conectados pela API oficial da Meta (API WhatsApp Cloud) não têm risco de banimento — a fila anti-ban existe justamente para proteger o canal não oficial. Para envios em massa nele, o LeadWhats utiliza uma fila inteligente que protege seu número contra bloqueios do WhatsApp. O sistema simula comportamento humano:

Delays aleatórios — Entre 10 e 120 segundos entre cada envio, variando para parecer natural
Simulação de digitação — O indicador "digitando..." aparece para o destinatário antes da mensagem ser enviada
Limites por maturidade do chip — O sistema ajusta a velocidade conforme a idade do número:

Idade do chip	Envios recomendados/hora
0-7 dias (chip novo)	2 a 4 mensagens/hora
7-14 dias	5 a 8 mensagens/hora
14+ dias (chip aquecido)	20+ mensagens/hora

Agendamento e Follow-up

Agendamento: Programe mensagens para serem enviadas em uma data e hora futuras. Ideal para enviar em horário comercial mesmo que você esteja trabalhando fora desse horário.

Follow-up automático: Após enviar uma mensagem, agende um lembrete de acompanhamento com título e data. O sistema notifica quando chegar a hora do follow-up. Status do follow-up: Pendente, Concluído, Vencido ou Cancelado.

Atendimento em Equipe

Em equipes, o sistema de atendimento funciona assim:

O primeiro membro que responder é automaticamente atribuído como atendente daquela conversa
A conversa pode ser transferida para outro membro da equipe a qualquer momento
Todos os membros com acesso podem visualizar o histórico completo da conversa
O filtro "Meus" mostra apenas as conversas que você está atendendo

Não encontrou o que procurava?

WhatsApp E-mail