================================================================================
                    LovaPRO WA Extractor — TUTORIAL COMPLETO
                              Versão 1.9.29
================================================================================

Obrigado por adquirir o LovaPRO WA Extractor!
Esta é a ferramenta mais completa do mercado para extração de contatos de
grupos do WhatsApp Web, com processamento 100% local, sem servidores externos
e em conformidade com a LGPD.

Este tutorial cobre TUDO que você precisa saber:
  1. O que é a extensão
  2. Requisitos do sistema
  3. Instalação passo a passo
  4. Primeira utilização
  5. Todas as funcionalidades explicadas
  6. Modo LOTE (extração em massa de vários grupos)
  7. Modo ACUMULAR (somar contatos de vários grupos sem repetição)
  8. Exportação (CSV, Excel, vCard, wa.me, HubSpot, RD Station)
  9. Filtros e busca em tempo real
 10. Auto-sync (troca de grupo automática)
 11. Histórico de snapshots
 12. Painel Embutido (fixar no WhatsApp Web)
 13. Boas práticas e uso responsável
 14. Solução de problemas
 15. Perguntas frequentes
 16. Aviso legal / LGPD


================================================================================
1) O QUE É A EXTENSÃO
================================================================================

O LovaPRO WA Extractor é uma extensão para navegadores Chromium (Chrome, Edge,
Brave, Opera, Arc) que lê os participantes de um grupo aberto no WhatsApp Web
e permite exportar essa lista em vários formatos.

A extração é feita de DUAS formas complementares:

  A) Método STORE (recomendado, ilimitado)
     Lê diretamente o banco interno do WhatsApp Web (Store).
     Captura TODOS os participantes de qualquer grupo — mesmo com 2000+ pessoas.
     Não depende de rolar a lista manualmente.

  B) Método DOM (fallback)
     Se o Store não estiver acessível (WhatsApp atualiza a interface de tempos
     em tempos), a extensão rola a lista de participantes automaticamente e
     extrai os números visíveis.

Toda a operação acontece dentro do SEU navegador. Nenhum dado é enviado para
servidores externos.


================================================================================
2) REQUISITOS DO SISTEMA
================================================================================

  • Navegador Chromium: Chrome 108+, Edge 108+, Brave, Opera, Arc.
  • Conta ativa no WhatsApp com WhatsApp Web funcionando.
  • Sistema operacional: Windows, macOS ou Linux.
  • Conexão estável (só para o próprio WhatsApp Web, não para a extensão).


================================================================================
3) INSTALAÇÃO PASSO A PASSO
================================================================================

  1. Descompacte o arquivo lovapro-wa-extractor-v1.9.29.zip em uma pasta
     de sua preferência (ex.: Documentos/LovaPRO/).
     IMPORTANTE: não apague essa pasta depois — o navegador carrega a
     extensão diretamente dela.

  2. Abra o navegador e digite na barra de endereço:
        chrome://extensions
     (No Edge use edge://extensions, no Brave use brave://extensions, etc.)

  3. No canto superior direito, ative o toggle "Modo do desenvolvedor".

  4. Clique no botão "Carregar sem compactação" (Load unpacked).

  5. Selecione a PASTA descompactada (a que contém o arquivo manifest.json).

  6. A extensão aparecerá na lista com o ícone verde do LovaPRO.
     Clique no ícone de quebra-cabeça 🧩 no canto superior direito do navegador
     e fixe (📌) o LovaPRO WA Extractor para acesso rápido.


================================================================================
4) PRIMEIRA UTILIZAÇÃO
================================================================================

  1. Abra https://web.whatsapp.com e faça login com o QR code.

  2. Entre em um grupo do qual você é participante.

  3. Você tem 3 formas de iniciar a extração:

     a) Clicar no ícone da extensão no navegador → abrir o popup →
        clicar em "Extrair contatos do grupo aberto".

     b) Clicar no botão flutuante verde "Extrair contatos" que aparece
        no canto inferior direito do WhatsApp Web.

     c) Ativar o "Painel Embutido" (recomendado — ver seção 12) e usar
        a interface fixa dentro do próprio WhatsApp Web.

  4. Aguarde alguns segundos. A extensão vai:
       • Localizar o Store interno.
       • Ler todos os participantes.
       • Filtrar apenas números válidos de WhatsApp (@c.us).
       • Descartar IDs anônimos (@lid).
       • Mostrar a lista com estatísticas.


================================================================================
5) TODAS AS FUNCIONALIDADES
================================================================================

O popup / painel apresenta as seguintes seções:

  ── ESTATÍSTICAS ──
     Total de contatos | Admins | Participantes comuns | Você

  ── LISTA DE CONTATOS ──
     Cada linha mostra:
       - Foto de perfil (quando disponível)
       - Nome/apelido salvo no WhatsApp
       - Número no formato internacional (+55 11 9xxxx-xxxx)
       - Papel: 👑 Admin | 👤 Membro
     Passe o mouse sobre qualquer linha para copiar apenas aquele número.

  ── BARRA DE BUSCA ──
     Filtra em tempo real por nome ou número.

  ── FILTROS POR PAPEL ──
     Botões: Todos | Só admins | Só membros comuns

  ── AÇÕES DE EXPORTAÇÃO ──
     • Copiar telefones (área de transferência)
     • Baixar CSV — planilha padrão (Excel/Google Sheets abrem direto)
     • Baixar XLSX — Excel formatado com colunas separadas
     • Baixar vCard — importe direto na agenda do celular
     • Baixar wa.me — links prontos de clique-para-conversar
     • Exportar HubSpot — CSV pronto pra importação no CRM
     • Exportar RD Station — CSV pronto pra importação no CRM

  ── CONFIGURAÇÕES ──
     • Auto-sync: atualiza a lista quando você troca de grupo (padrão: ON)
     • Modo Acumular: soma contatos sem repetir (ver seção 7)
     • Limpar dados: apaga tudo do armazenamento local

Todos os arquivos exportados vêm com o nome do grupo e a data,
ex.: "Grupo-Vendas_2026-07-20.csv"


================================================================================
6) MODO LOTE — EXTRAÇÃO DE VÁRIOS GRUPOS DE UMA VEZ
================================================================================

O modo LOTE automatiza a extração de vários grupos sem você precisar clicar
em cada um.

  Como usar:
    1. No popup, clique em "Modo LOTE".
    2. Marque os grupos que deseja processar (a lista mostra todos os
       grupos dos quais você participa).
    3. Clique em "Iniciar extração em lote".
    4. A extensão abrirá cada grupo sequencialmente, extrairá os
       participantes e salvará no armazenamento local.
    5. Ao final, você recebe um resumo com o total agregado.

  Tempo estimado: cerca de 3 a 8 segundos por grupo.
  Grupos com muitos membros (1000+) podem levar até 60 segundos cada.

  IMPORTANTE:
    • Não feche a aba do WhatsApp Web durante o processo.
    • Não interaja manualmente com a lista de grupos enquanto o LOTE roda.
    • Se der erro em um grupo, a extensão pula para o próximo e reporta
      no final.


================================================================================
7) MODO ACUMULAR — SOMAR VÁRIOS GRUPOS SEM REPETIÇÃO
================================================================================

Quando ativado, a extensão NÃO sobrescreve a extração anterior — ela SOMA.

  Exemplo prático:
    - Grupo A: 300 contatos → extrai
    - Grupo B: 500 contatos (100 já estavam no Grupo A) → extrai
    - Resultado: 700 contatos únicos (deduplicados por número)

  Como ativar:
    1. Abra o popup.
    2. Vá em Configurações → ative "Modo Acumular".
    3. A partir daí, cada extração é somada à lista existente.
    4. Para zerar, clique em "Limpar dados".

  Combinação recomendada:
    LOTE + ACUMULAR = extrai dezenas de grupos e entrega uma única
    planilha final com todos os contatos únicos.


================================================================================
8) FORMATOS DE EXPORTAÇÃO — QUAL ESCOLHER?
================================================================================

  CSV       → Uso geral. Abre no Excel, Google Sheets, Numbers.
              Formato: nome,telefone,papel,grupo

  XLSX      → Excel nativo. Colunas separadas, formatação pronta,
              filtros automáticos. Melhor para relatórios.

  vCard     → Importe diretamente na agenda do celular (iOS/Android).
              Todos os contatos aparecem com nome + número.

  wa.me     → Lista de links https://wa.me/55... prontos para enviar
              mensagem individualizada. Ótimo para prospecção.

  HubSpot   → CSV com as colunas exatas que o HubSpot espera:
              First Name, Last Name, Phone Number, Lifecycle Stage.

  RD Station→ CSV com as colunas exigidas pelo RD Station Marketing:
              Nome, Telefone, Tags, Origem.


================================================================================
9) FILTROS E BUSCA EM TEMPO REAL
================================================================================

  • Barra de busca: digite qualquer parte do nome ou número.
    A lista filtra à medida que você digita.

  • Filtro por papel: Todos | Admins | Membros.

  • Antes de exportar, o filtro ativo é respeitado.
    Ex.: filtre por "Admins" e clique em CSV → o CSV terá SÓ admins.


================================================================================
10) AUTO-SYNC
================================================================================

Com o auto-sync LIGADO (padrão), sempre que você trocar de grupo no
WhatsApp Web, a lista da extensão é atualizada automaticamente.

  Para desligar (útil quando você quer preservar a lista atual):
    Configurações → desative "Auto-sync".


================================================================================
11) HISTÓRICO DE SNAPSHOTS
================================================================================

A extensão guarda automaticamente as últimas 20 extrações.
Cada snapshot registra:
  - Nome do grupo
  - Data e hora da extração
  - Total de contatos capturados
  - Lista completa (recuperável com 1 clique)

  Como acessar:
    Popup → aba "Histórico" → clicar em qualquer snapshot para restaurar.

  Retenção: 7 dias (conformidade LGPD). Após esse prazo, snapshots antigos
  são apagados automaticamente.


================================================================================
12) PAINEL EMBUTIDO — FIXAR DENTRO DO WHATSAPP WEB
================================================================================

Novidade da v1.9.29: em vez do popup (que fecha quando você clica fora),
você pode fixar a extensão como um painel dentro do próprio WhatsApp Web.

  Como ativar:
    1. Clique no ícone da extensão.
    2. Clique no botão "📌 Fixar no WhatsApp".
    3. Um painel lateral aparece dentro do WhatsApp Web e NÃO FECHA
       ao clicar em outras áreas.
    4. Para esconder, clique no X do próprio painel.

  Vantagens:
    • Trabalha ao lado do WhatsApp sem perder a extração.
    • Suporte total ao modo LOTE (que exige que a interface fique aberta).
    • Ideal para operações longas.


================================================================================
13) BOAS PRÁTICAS E USO RESPONSÁVEL
================================================================================

  ✅ FAÇA:
     • Use APENAS em grupos dos quais você participa.
     • Colete apenas dados que você tem base legal para tratar.
     • Explique aos contatos como você obteve o número deles.
     • Ofereça opt-out fácil (link para descadastro em toda mensagem).
     • Respeite os horários comerciais (8h-20h) para envio de mensagens.

  ❌ NÃO FAÇA:
     • Não envie spam ou mensagens em massa não solicitadas.
     • Não venda a lista de contatos para terceiros.
     • Não use para fins ilícitos (golpes, phishing, assédio).
     • Não extraia grupos que você não faz parte (impossível tecnicamente,
       mas reforçamos o princípio).

  A responsabilidade pelo USO dos dados é 100% sua. A ferramenta apenas
  organiza informações que já estão visíveis para você no WhatsApp Web.


================================================================================
14) SOLUÇÃO DE PROBLEMAS
================================================================================

  ❓ "Store interno não localizado"
     → O WhatsApp fez uma atualização recente. Aguarde a próxima versão
       da extensão ou use o método DOM (rola a lista automaticamente).
     → Enquanto isso: abra a lista de participantes manualmente (clique
       no nome do grupo → Ver todos) e clique em "Extrair" no painel.

  ❓ "O popup fecha quando clico fora"
     → Use o "Painel Embutido" (seção 12). O popup do Chrome sempre fecha
       ao perder o foco — é uma limitação do próprio Chrome.

  ❓ "Aparecem IDs @lid em vez de números"
     → Isso acontece em grupos com muitos usuários privados. A partir
       da v1.9.28 esses IDs são descartados automaticamente. Se ainda
       aparecerem, limpe os dados e extraia de novo.

  ❓ "Contato salvo na minha agenda não mostra o telefone"
     → O WhatsApp OMITE o número de contatos já salvos, mostrando só o
       nome. Isso é limitação do próprio WhatsApp Web, não da extensão.
       Solução: apague o contato da agenda do celular e recarregue o
       WhatsApp Web — o número volta a aparecer.

  ❓ "Modo LOTE parou no meio"
     → Verifique se você não trocou de aba durante a execução. O Chrome
       pausa scripts em abas em segundo plano. Mantenha a aba do
       WhatsApp Web visível durante o LOTE.

  ❓ "Números vieram com formato estranho"
     → A extensão sempre exporta em formato internacional (E.164):
       +55 seguido do DDD e número. Se você precisar de outro formato,
       edite a coluna no Excel com uma fórmula SUBSTITUIR.

  ❓ "Onde ficam meus dados?"
     → Apenas no armazenamento local do navegador (chrome.storage.local).
       Nunca são enviados para nenhum servidor. Ao desinstalar a extensão,
       os dados são apagados automaticamente.


================================================================================
15) PERGUNTAS FREQUENTES
================================================================================

  P: Preciso pagar mensalidade?
  R: Não. O produto é vendido em licença única. Atualizações futuras
     dependem do seu vendedor.

  P: Funciona em quantos computadores?
  R: A extensão em si roda em qualquer navegador Chromium. A licença
     comercial é definida pelo seu contrato de compra.

  P: Consegue extrair contatos de comunidades?
  R: Sim, comunidades no WhatsApp são conjuntos de grupos. Entre em cada
     grupo da comunidade e extraia — ou use o modo LOTE selecionando
     todos os grupos da comunidade de uma vez.

  P: Extrai contatos de conversas privadas (não-grupos)?
  R: Não. A ferramenta é específica para GRUPOS.

  P: Funciona em WhatsApp Business?
  R: Sim, a versão web do WhatsApp Business é idêntica à versão pessoal
     na estrutura interna.

  P: Consigo agendar disparos automáticos com a lista?
  R: Não. Esta extensão apenas EXTRAI. Para disparar mensagens, use
     ferramentas específicas (respeitando os Termos do WhatsApp).

  P: Quantos contatos consigo extrair?
  R: Ilimitado. Já testamos grupos com 2000+ participantes com sucesso.


================================================================================
16) AVISO LEGAL / LGPD
================================================================================

Esta ferramenta processa dados pessoais (números de telefone e nomes).
Ao utilizá-la, você:

  1. Declara ser participante dos grupos dos quais extrai contatos.
  2. Assume a responsabilidade de CONTROLADOR dos dados pessoais
     conforme a Lei Geral de Proteção de Dados (Lei 13.709/2018).
  3. Deve informar aos titulares dos dados (as pessoas dos grupos)
     sobre o tratamento realizado, quando aplicável.
  4. Deve ter uma BASE LEGAL válida para o tratamento (consentimento,
     legítimo interesse, execução de contrato, etc.).
  5. Deve garantir o direito de acesso, correção e exclusão aos titulares.

O fabricante da extensão atua apenas como fornecedor de tecnologia. Não
temos acesso aos dados que você extrai, pois nada é enviado para nossos
servidores. Isso está tecnicamente demonstrado pela ausência total de
requisições de rede da extensão (verificável no DevTools do Chrome).

O uso indevido — envio de spam, coleta sem base legal, comercialização
de dados pessoais, assédio — é de responsabilidade exclusiva do usuário
final e pode gerar sanções cíveis, administrativas e criminais.


================================================================================
                                SUPORTE
================================================================================

Dúvidas técnicas, sugestões ou problemas?
Entre em contato com quem te vendeu a extensão.

Obrigado por escolher o LovaPRO WA Extractor!
Boas extrações e bons negócios. 🚀

================================================================================
                          © LovaPRO — 2026
================================================================================
