Como Usar
Instalação e primeiro uso, passo a passo.
Uso responsável: os contatos extraídos são dados pessoais de terceiros protegidos pela LGPD. Use apenas em grupos dos quais você faz parte e somente para finalidades legítimas. Não utilize os dados para spam ou envio de mensagens não solicitadas.
Passo 1: Instale e fixe a extensão
Acesse a página da extensão na Chrome Web Store e clique em Adicionar ao Chrome. Depois, abra o menu de extensões — o ícone de peça de quebra-cabeça na barra do navegador — e clique no alfinete ao lado do WhatsApp Ninja Extractor. Assim o ícone dele fica sempre visível, a um clique de distância.
Passo 2: Abra o Ninja Extractor no WhatsApp Web
Acesse web.whatsapp.com no Chrome — se for a primeira vez, escaneie o QR Code com o aplicativo do celular. Com o WhatsApp Web conectado, clique no ícone da extensão: ele abre um painel lateral fixo ao lado da conversa, com as abas Grupos, Comunidades e Config. Quando o painel mostra “Conectado ao WhatsApp Web”, está tudo pronto.
Passo 3: Escolha os grupos ou comunidades
Na aba Grupos, clique em Buscar grupos. A lista aparece na hora, já com todos os participantes lidos — você não precisa abrir conversa nenhuma nem rolar lista, porque a extensão lê os dados direto da memória do próprio WhatsApp Web. Marque os que quer extrair; há campo de filtro e os atalhos Selecionar todos e Limpar seleção. Para comunidades, a aba Comunidades funciona do mesmo jeito.
Com a seleção feita, clique em Iniciar extração. O progresso e o log aparecem no próprio painel, e dá para interromper a qualquer momento.
Passo 4: Baixe seus contatos
Ao terminar, o painel mostra quantos contatos foram extraídos e de quantos grupos. Escolha o formato — CSV (Excel), JSON ou vCard — e clique em Baixar arquivo. Ele vai para a pasta de downloads do seu computador, pronto para abrir no Excel, no Google Sheets ou importar no seu CRM.
Passo 5: Personalize sua extração
A aba Config guarda três ajustes, todos opcionais — vale conhecer antes da próxima extração:
- Incluir administradores do grupo — traz também quem administra o grupo ou a comunidade.
- Modo completo — busca o telefone de contatos salvos, entregando uma base mais completa. Só faz diferença no caso em que a leitura direta não está disponível e a extensão precisa recorrer à tela; nesse cenário ela abre o perfil de cada participante, o que leva bem mais tempo.
- Formato de exportação — CSV (Excel), JSON ou vCard, compatíveis com planilhas e CRMs.
O que o arquivo CSV contém
Cada linha representa um participante, com seis colunas. Ao exportar vários grupos de uma
vez, todos saem no mesmo arquivo — a coluna grupo é o que diz de onde veio cada
contato. JSON e vCard trazem os mesmos dados, em outro formato.
| Coluna | Descrição |
|---|---|
| grupo | Nome do grupo ou da comunidade de onde o contato foi extraído. |
| nome | Nome de exibição. Traz o telefone quando o WhatsApp não conhece um nome para a pessoa. |
| telefone | Número completo, com o código do país. |
| ddi | Código de discagem internacional, separado do restante do número. |
| pais | País deduzido pelo prefixo do número. Fica em branco quando o prefixo não permite a dedução. |
| admin | sim ou nao, indicando se a pessoa administra o grupo. |
Em breve na Chrome Web Store