WhatsApp Manutenção
Aplicativo local em desenvolvimento para permitir ao ChatGPT para Windows consultar conversas do WhatsApp previamente escolhidas pelo usuário.
Estado: versão 0.3.0 em desenvolvimento. Ainda não há instalador pronto para uso. O código foi preparado, mas o funcionamento completo no Windows e no ChatGPT ainda precisa ser demonstrado. O projeto procura contribuições para concluir essa validação e o empacotamento.
Experiência que queremos entregar
O usuário abre um único arquivo, clica em Preparar e conectar, escaneia o QR pelo celular e escolhe as conversas. O aplicativo registra a conexão local e administra os componentes necessários. O usuário não precisa abrir terminal, instalar Node, preparar túnel ou criar chave de API.
A interface permite alterar a seleção e bloquear o acesso. O assistente oferece somente quatro operações: verificar o estado, listar conversas autorizadas, ler mensagens e pesquisar mensagens.
O que já existe
- Interface em português para QR, seleção de até 30 conversas e bloqueio.
- Autorizações vinculadas à conta, com revogação durante consultas e recusa de conversas trancadas.
- Serviço local compartilhado pelo painel e pelo MCP, com autenticação local gerada automaticamente.
- Registro no arquivo de configuração do ChatGPT preservando as demais configurações.
- Fonte do iniciador Windows e do empacotador; eles ainda não foram compilados e validados.
- Testes com dados simulados. Última execução registrada: 46 aprovados, 0 falhos e 2 impedidos pelo ambiente, de um total de 48.
Onde ajudar primeiro
Veja as tarefas abertas no GitHub. Escolha uma tarefa e registre nela o trabalho que pretende realizar antes de abrir um pull request.
| Prioridade | Trabalho | Resultado esperado |
|---|---|---|
| P0 | Confirmar a integração real no ChatGPT Windows | O aplicativo reconhece o MCP local e realiza uma consulta autorizada. |
| P0 | Compilar e verificar o instalador | Um candidato .exe instala e abre como usuário comum. |
| P0 | Validar acesso e revogação de ponta a ponta | Conversas fora da seleção e respostas após bloqueio permanecem inacessíveis. |
| P1 | Revisar a interface e concluir a entrega | Uma pessoa sem conhecimentos técnicos consegue conectar e bloquear o acesso. |
A primeira prioridade é comprovar a compatibilidade com a versão real do ChatGPT para Windows utilizada. Os testes de edição de configuração não provam que o aplicativo reconhece a conexão. Se isso não funcionar, registrar a diferença e ajustar a arquitetura antes de distribuir um instalador.
Documentação
- Como contribuir
- Roteiro de conclusão
- Desenvolvimento e compilação
- Resultados e limitações dos testes
- Cuidados com dados e relatos de segurança
- Orientação para o usuário final
Começar a desenvolver
Use Node 24 ou superior e instale as dependências fixadas no lockfile:
npm ci --ignore-scripts --no-audit --no-fund
npm test
Esses comandos destinam-se a desenvolvedores. A instalação final não deverá exigir nenhum deles. Os testes usam exemplos simulados; npm test não solicita QR nem conecta uma conta WhatsApp real. Dois testes precisam de sockets locais; ambientes que os bloqueiam registram testes não executados.
Os testes do iniciador exigem Go e são executados separadamente:
cd launcher
go test ./...
Leia DESENVOLVIMENTO.md antes de compilar. A compilação exige componentes oficiais verificados e não substitui os testes reais no Windows. Não há automação de publicação ou lançamento configurada neste checkpoint.
Colaboração e escopo
Enviar propostas por pull request, acompanhadas dos resultados realmente obtidos. Trabalhar com dados simulados e contas de teste controladas pelo próprio desenvolvedor. Os colaboradores não precisam da sessão, do número ou das conversas do proprietário do projeto.
A integração WhatsApp usa biblioteca não oficial. O projeto não é afiliado à Meta ou à OpenAI. Licença de distribuição e eventual publicação aberta ficam a definir pelo mantenedor; este checkpoint não acrescenta uma licença ao código.