Levar conversas do WhatsApp para uma IA

Muita empresa funciona dentro de grupos de WhatsApp. É ali que a equipe combina entregas, o cliente pede ajustes e o fornecedor avisa de atraso. Quando alguém pergunta “o que ficou decidido sobre aquilo semana passada?”, a resposta está enterrada em centenas de mensagens.

Uma IA como o ChatGPT ou o Claude resume isso bem. O difícil é tirar as mensagens do WhatsApp de um jeito organizado, só das conversas certas e sem entregar tudo a um serviço de terceiros no caminho.

Fizemos o whatsapp-group-reader para isso. É um aplicativo local, de código aberto, que lê o texto das conversas que você escolher e exporta num formato pronto para colar numa IA.

Resumo

• Lê só as conversas marcadas por você. Nada é sincronizado sozinho.
• Só lê. Não envia mensagens, reações, presença nem confirmação de leitura, e não baixa mídia.
• Tudo fica no seu computador, num banco local. Não há servidor na nuvem nem integração direta com IA.
• Exporta em texto compacto, para colar numa IA, ou em JSONL, para quem programa.
• Usa um cliente não oficial do WhatsApp. Existe risco de bloqueio da conta, e não dá para eliminá-lo.

Como funciona

1. Você abre o aplicativo e vincula o celular pelo QR, como no WhatsApp Web.
2. Atualiza a lista de conversas, marca só as conversas autorizadas pelos participantes e salva.
3. Escolhe o período, por exemplo as últimas 24 horas e no máximo 500 mensagens por conversa.
4. Clica em Sincronizar agora.
5. Exporta em texto para IA, ou baixa o JSONL completo.

A exportação para IA tem um cabeçalho de contexto e marcadores separando cada conversa. É só colar e perguntar: “resuma o que foi decidido”, “liste as pendências por pessoa”, “quais prazos foram combinados”.

Tirar uma conversa da seleção interrompe as próximas coletas, mas não apaga o que já foi salvo. O banco, a sessão e as exportações ficam na pasta de dados do usuário, e o aplicativo mostra onde.

Por que não usar uma biblioteca que fala direto com o servidor

Existem bibliotecas que reimplementam o protocolo do WhatsApp e conversam com o servidor por conta própria. Escolhemos o caminho oposto: o whatsapp-web.js controla o próprio WhatsApp Web, dentro de um navegador de verdade. Do lado do WhatsApp, o que aparece é o WhatsApp Web.

A aposta é que isso reduz o risco de bloqueio. Não dá para provar, porque o WhatsApp não documenta como detecta automação. Mas é a escolha conservadora: não há protocolo reconstruído para manter, e o comportamento fica colado ao cliente oficial. O custo é precisar de um navegador. No Windows, o aplicativo usa o Edge que já vem instalado.

Devagar de propósito

O aplicativo não tenta ser rápido. Ele lê uma conversa por vez, em blocos de 50 mensagens, com intervalos aleatórios entre blocos e entre conversas, e pausas maiores depois de alguns lotes. Uma conversa consultada há pouco tempo entra em espera antes de poder ser lida de novo.

Há dois ritmos: Conservador, o padrão, e Balanceado. Falhas de leitura têm no máximo duas novas tentativas, com espera crescente. A fila pode ser pausada, retomada ou cancelada sem perder o que já foi coletado.

Isso espaça as leituras que o aplicativo pede. Não controla o que o WhatsApp Web faz por conta própria, não imita uma pessoa e não elimina o risco do cliente não oficial.

O que fica de fora

O foco é texto. Mídia sem legenda, chamadas, reações, enquetes, status, canais e mensagens de sistema são ignorados. De uma foto ou vídeo com legenda, sai só o texto da legenda.

O painel de diagnóstico guarda só os 200 eventos mais recentes, em memória, e nunca registra o texto das mensagens.

Antes de usar, três cuidados

• Combine com o grupo. As mensagens não são só suas. Ler e exportar a conversa de outras pessoas para uma IA pede que elas saibam e concordem, ainda mais em grupos com clientes e fornecedores. Quem entrar no grupo depois também precisa saber.
• Escolha a IA com cuidado. O aplicativo não envia nada a lugar nenhum, mas o texto colado numa IA segue as regras daquele serviço. Para conversas sensíveis, confira se o plano usado não aproveita os dados para treinamento.
• Conte com o risco de bloqueio. É um cliente não oficial, e o bloqueio atinge o número vinculado, que é o mesmo que está nos grupos. Avalie isso antes de usar o número principal da empresa.

Para quem quer instalar

No Windows 10 e 11, há um pacote portátil de cerca de 50 MB, com tudo embutido:

1. Nas propriedades do arquivo .zip, marque “Desbloquear”, se a opção aparecer.
2. Extraia numa pasta curta e fora do OneDrive, como C:\WhatsAppReader. São necessários cerca de 250 MB livres.
3. Abra o Iniciar.cmd. O navegador abre sozinho no aplicativo. A primeira abertura pode levar 1 a 2 minutos.
4. Deixe a janela preta aberta enquanto usa. Ela é o programa.

Para desenvolvedores, o projeto roda no Windows e no macOS, com Node.js 24 ou mais recente:

git clone https://github.com/vasfvitor/whatsapp-group-reader
cd whatsapp-group-reader
corepack enable
pnpm install
pnpm dev

O projeto é uma prova de conceito. Funciona com um telefone e uma sessão por máquina, sem nuvem e sem vários usuários.

Se a sua empresa quer usar IA em cima das próprias conversas, documentos ou sistemas, com os dados sob controle, esse é o trabalho que fazemos em soluções com IA. Quando a pergunta é sobre os dados de um aplicativo, e não sobre conversas, o caminho é falar com o seu banco de dados.