Script em JavaScript para extração automática de contatos não salvos a partir do WhatsApp Web, seguindo o padrão brasileiro de numeração (+55). O script gera um arquivo CSV compatível com o Google Contatos, facilitando a organização e importação dos números extraídos.
Este projeto foi desenvolvido para identificar conversas no WhatsApp Web cujo nome do chat seja um número de telefone, o que indica, na maioria dos casos, que o contato não está salvo na agenda. A partir dessa identificação, o script coleta os números válidos do Brasil e gera um arquivo CSV pronto para importação no Google Contatos.
Acesse https://web.whatsapp.com e faça login normalmente.
Pressione F12 ou Ctrl + Shift + I e selecione a aba Console.
Cole o conteúdo do script JavaScript no console e pressione Enter.
Role a lista lateral de conversas lentamente até o final para garantir que todas as conversas sejam carregadas e analisadas, os contatos identificados pelo script, ficaram marcos em verde.
Clique no botão Exportar Não Salvos exibido na interface.
O arquivo CSV será gerado e baixado automaticamente.
Acesse https://contacts.google.com
Utilize a opção Importar e selecione o arquivo CSV gerado.
- Leitura das conversas exibidas no WhatsApp Web
- Identificação de contatos não salvos com base no nome do chat
- Validação de números no padrão brasileiro (+55 + DDD + número)
- Remoção automática de números duplicados
- Coleta progressiva conforme a rolagem da lista de conversas
- Geração de arquivo CSV compatível com Google Contatos
- Download automático do arquivo gerado
O WhatsApp Web não fornece uma informação explícita indicando se um contato está salvo ou não.
Este script utiliza a abordagem mais confiável disponível no ambiente web:
- Se o nome da conversa for um número de telefone, o contato é considerado não salvo
- Se o nome da conversa for um texto (nome), o contato é considerado salvo
Essa limitação é inerente à plataforma.
- Navegador (Google Chrome, Edge ou Firefox)
- Conta ativa no WhatsApp
- Acesso ao WhatsApp Web
O arquivo gerado segue o padrão oficial de importação do Google Contatos:
Name,Given Name,Additional Name,Family Name,Group Membership,Phone 1 - Type,Phone 1 - Value
WhatsApp 1,WhatsApp 1,,,My Contacts,Mobile,+5511999999999Apos o download do arquivo, você pode modificar a planilha, removendo informaçoes de contato que não deseja que seja sicronizado ao Google Contatos.
Se for remover alguma informação dos contatos apos o download do csv, de maneira nenhuma apague as colunas da planilha, apos a atualização da sua preferencia, salvar em CSV.
- Role a lista de conversas lentamente para evitar falhas na coleta
- Evite executar o script repetidas vezes sem necessidade
- Utilize apenas em contas próprias
- Verifique os contatos antes de importar definitivamente no Google Contatos
- O script é executado localmente no navegador
- Nenhum dado é enviado para servidores externos
- Não realiza envio de mensagens nem automação de interações
- Apenas lê informações visíveis na interface do WhatsApp Web
Se o botão de Exportar Não Salvos não aparecer? não se desespere, atualize a pagina e rode novamente o script.
Se nem todos os contatos não foram exportado? certifique-se de rolar completamente a lista de conversas antes de exportar.
Números inválidos não aparecem no CSV Apenas números válidos no padrão brasileiro são exportados.
Este projeto é fornecido apenas para fins organizacionais. O autor não se responsabiliza por usos que violem os termos de serviço do WhatsApp ou leis locais.
Utilize com responsabilidade.
Contribuições são bem-vindas por meio de Pull Requests ou Issues para correções, melhorias ou sugestões.
Este projeto pode ser distribuído sob licença MIT ou outra licença de sua preferência.