← Portfólio

Software & automação · estudo de caso

Extrator de membros do WhatsApp

Um script de console, sem instalação, que transforma a lista de membros de um grupo do WhatsApp Web numa planilha — para grupos que você administra ou com o consentimento dos membros (LGPD).

TipoPessoal
PapelConcepção e desenvolvimento
PeríodoJul/2026
EstadoConcluído
TecnologiasJavaScript · DOM · CSV

O projeto em poucas palavras

Um script de cerca de 70 linhas, colado no console do navegador, que percorre a lista de membros de um grupo aberto no WhatsApp Web e baixa um arquivo CSV com nome e telefone. Não há nada para instalar: basta abrir a lista, colar o código e esperar.

O ponto de partida

O WhatsApp Web mostra os membros de um grupo em uma lista longa, que só carrega mais itens conforme se rola a tela, e não oferece exportação. Copiar centenas de nomes e números manualmente é lento e sujeito a erro, principalmente em grupos grandes.

Como funciona

O script localiza os itens da lista, descobre qual elemento da página é o contêiner com rolagem e desce sozinho, 500 pixels a cada 600 milissegundos, lendo os itens que aparecem. Ele termina quando a rolagem para de avançar depois de algumas tentativas.

Os detalhes que fazem diferença:

  • os contatos são guardados por telefone, então nenhum número se repete, mesmo que o mesmo item apareça em várias leituras;

  • o arquivo é gravado em UTF-8 com marca de ordem de bytes, para que o Excel abra os acentos corretamente;

  • vírgulas nos nomes são tratadas para não quebrar as colunas;

  • mensagens claras avisam se a lista de membros não estiver aberta ou se a área de rolagem não for encontrada.

O que guiou as decisões

Nem toda automação precisa de um aplicativo. Aqui, a solução mais simples era um trecho de código que roda no lugar onde a informação já está, sem instalação nem credenciais. Em contrapartida, uma ferramenta assim é frágil por natureza, e vale dizer isso de forma clara.

Uma ideia em movimento?

Vamos transformar a próxima pergunta em algo que funciona.

Conversar sobre um projeto ↗