O que é o ShadowProspect
Plataforma de prospecção B2B via WhatsApp. Em 3 passos você sai de "tenho um produto" para "tenho uma lista qualificada conversando com leads".
- Conectar seu número de WhatsApp (1x).
- Buscar leads por nicho + cidade (Google Maps ou base CNPJ da Receita Federal).
- Disparar campanha com texto personalizado + imagem opcional.
Funcionalidades principais
- Captação de leads por nicho/cidade/estado via Apify (Google Maps).
- Base CNPJ (Receita Federal) com 68 milhões de empresas brasileiras.
- Disparos em massa com texto + imagem, personalização por lead e spintax anti-bloqueio.
- Relatórios com filtros (período, status, campanha) e export CSV.
- Multi-usuário: cada usuário gerencia suas próprias contas e leads.
- Anti-bloqueio: limite diário, janela silenciosa, variação de mensagem.
Primeiro acesso?
Comece pela aba 1. Conectar WhatsApp. Sem uma conta WA ativa, nenhum disparo funciona.
1. Conectar WhatsApp
Você precisa de pelo menos 1 número conectado antes de disparar. Vá no menu lateral WhatsApp.
Passo a passo
- Clique em "Adicionar Telefone".
- Digite o número com DDI + DDD (ex:
5511999998888). Use o número principal do seu WhatsApp (o que vai disparar).
- Clique em "Iniciar Sessão". O QR Code aparece em alguns segundos.
- No celular, abra WhatsApp → Configurações → Aparelhos conectados → Conectar um aparelho → escaneie o QR.
- Status muda para ● Ativa em ~5 segundos.
Atenção:
- Não use o número pessoal que já conversa com clientes — risco alto de bloqueio.
- Recomendado: número novo, dedicado só a prospecção.
- Cada conta tem limite diário (configurado em "Gestão & Acessos").
Desconectar / Remover
Use os botões ao lado de cada conta. Desconectar só desativa; Remover apaga a sessão do servidor (vai precisar escanear QR de novo).
2. Buscar Leads
Você tem duas fontes de leads:
📍 Google Maps (Apify)
- Vá em Buscar no menu.
- Escolha o nicho (ex: restaurante, academia, oficina mecânica).
- Filtre por cidade e/ou estado.
- Defina o máximo de resultados (até 500).
- Clique em Buscar. Demora ~1-3 min (chama a Apify).
- O resultado vai pra Base Consolidada (menu "Base Consolidada").
🇧🇷 Receita Federal (CNPJ)
A base completa já está carregada no sistema. Vá direto em Base Consolidada e use os filtros de nicho (seção CNAE) + cidade + UF. Sem custo de API.
Plano diário: O número de buscas no Google Maps é limitado por plano (Basico 3/dia, Plus 6/dia, Premium 10/dia). A base RF é ilimitada.
Selecionar leads para disparar
Em Base Consolidada, clique numa busca para abrir o drilldown com os leads. Marque os que quer contatar (checkbox) e clique em "Disparar WhatsApp". O modal de campanha abre com os leads pré-selecionados.
Enriquecimento (opcional)
Para cada lead, você pode clicar em "Enriquecer" — o sistema busca no site do lead e tenta extrair e-mail, CNPJ e sócios (via BrasilAPI).
3. Disparar Campanha
Você tem dois caminhos:
🎯 Caminho A — Campanha normal (com leads da base)
- Em Base Consolidada, selecione os leads (checkbox).
- Clique em "Disparar WhatsApp".
- Modal abre. Preencha:
- Nome da campanha (opcional — fica no histórico)
- Mensagem — use as variáveis
{nome}, {segmento}, {cidade}, {bairro}
- Imagem (opcional) — 3 modos: nenhuma, URL pública, ou upload
- Clique em Enfileirar Disparo.
- A campanha vai pra fila e o worker começa a enviar respeitando o limite diário.
🧪 Caminho B — Campanha de Teste (sem leads)
Use o botão 🧪 Campanha de Teste no topo da página "Disparos WhatsApp".
- Cole uma lista de telefones (1 por linha, até 20). Pode ser seu próprio número pra testar.
- Escreva a mensagem (com ou sem spintax).
- Anexe imagem se quiser.
- Clique em Enviar Teste.
Útil pra validar o pipeline antes de gastar saldo/quotas em produção. A campanha aparece com badge 🧪 Teste na listagem.
✍️ Variáveis e Spintax
| Sintaxe |
Efeito |
{nome} | Substitui pelo nome do lead (ou "sua empresa" se vazio) |
{segmento} | Categoria do lead |
{cidade} | Cidade |
{bairro} | Bairro |
{Opção 1|Opção 2|Opção 3} | Spintax — escolhe 1 aleatoriamente (anti-bloqueio) |
Exemplo de mensagem:
Oi {nome}! Tudo bem?
Vi que sua {segmento} em {cidade} pode estar precisando de uma mão com a prospecção no WhatsApp.
{Posso te mostrar como funciona?|Topa um bate-papo rápido?|Tem 5 min pra eu explicar?}
Abraço!
📊 Acompanhar
Na página Disparos WhatsApp você vê todas as campanhas com KPIs (enviadas, falhas, pendentes). Clique em Analisar pra ver cada mensagem individual com a miniatura da imagem e o erro (se houver).
🔁 Reenviar falhas
Se uma campanha teve mensagens com erro (ex: WhatsApp recusou), abra o detalhe e clique em "Reenviar Falhas". Mensagens que esgotaram 3 tentativas não voltam.
4. Relatórios
Menu Relatórios de Envio. Mostra todas as mensagens enviadas (independente da campanha).
Filtros
- Busca textual: nome, telefone ou trecho da mensagem
- Status: Enviado, Falha, Pendente
- Período: por data de criação ou data de envio
- Campanha: filtra por campanha específica
Exportar
- CSV: server-side, abre no Excel/Google Sheets. Tem tudo: nome, telefone, mensagem, status, data, erro.
- PDF: usa o botão de impressão do navegador (Ctrl+P). O CSS já está otimizado pra A4 paisagem.
Deleção em lote
Para limpar relatórios antigos, marque os itens e clique em "Apagar Selecionados". Soft-delete (não apaga do banco, só esconde).
Sobre a miniatura de imagem: Aparece só em envios manuais (feitos pelo admin em "WhatsApp → Enviar"). Disparos em massa pelo worker ainda não geram miniatura no relatório — só o registro textual.
Dicas & Boas Práticas
🛡️ Para evitar bloqueio do WhatsApp
- Número dedicado à prospecção. Misturar com WhatsApp pessoal = bloqueio quase certo.
- Aqueça o número: comece com 20-30 mensagens/dia, vá aumentando aos poucos.
- Use spintax sempre. Variação de mensagem é a defesa #1 contra ban.
- Respeite a janela silenciosa: configurada em "Gestão & Acessos" (padrão 22h-7h).
- Imagens leves (< 500KB) — WhatsApp pode recusar arquivos muito grandes.
📈 Para melhorar a taxa de resposta
- Personalize com
{nome} e {cidade} — mensagens genéricas têm 5x mais chances de ir pro lixo.
- Primeira frase curta e direta. "Oi {nome}!" funciona melhor que parágrafos longos.
- Pergunta no final: gera resposta. Ex: "Topa um bate-papo?"
- Teste A/B: faça 2 campanhas com abordagens diferentes e compare taxa de resposta no relatório.
⚙️ Atalhos úteis
- F5 na página principal: volta pro Cockpit (Dashboard).
- Auto-refresh a cada 15s na listagem de campanhas — não precisa recarregar manualmente.
- Toggle Dark/Light: no menu do usuário (canto inferior esquerdo).
❓ Problemas comuns
"QR não aparece"
Aguarde 5-10s. Se persistir, remova a conta e adicione de novo. Se ainda falhar, contate o admin.
"Enviado não vira 'Enviado'"
Pode estar na fila esperando janela silenciosa. Verifique o horário. Ou o worker está pausado — contate o admin.
"Mensagem deu 'Número não está nos contatos'"
Esse número não tem WhatsApp, ou nunca conversou com sua conta. Peça pro lead te adicionar antes, ou use outra conta.