Init Commit
This commit is contained in:
116
README.md
Normal file
116
README.md
Normal file
@@ -0,0 +1,116 @@
|
||||
# WhatsApp Promo Monitor
|
||||
|
||||
Sistema automatizado de **máxima seguridad** para monitorear y descargar multimedia de WhatsApp Web utilizando C# (.NET) y React.
|
||||
|
||||
> ⭐ **Nivel de Seguridad**: 9.5/10 - Anti-detección avanzada con Cuotas Automatizadas y Peak Protection.
|
||||
|
||||
## 📋 Descripción
|
||||
|
||||
Este proyecto captura automáticamente imágenes y videos recibidos en WhatsApp Web y los guarda localmente. Utiliza un motor de automatización con PuppeteerSharp altamente humanizado para evitar bloqueos, gestionando automáticamente cuotas de descarga y picos de actividad.
|
||||
|
||||
## 🏗️ Estructura del Proyecto
|
||||
|
||||
```
|
||||
WAPP-Multimedia/
|
||||
├── src/
|
||||
│ ├── Backend/ # Backend .NET (Core, Engine, Worker)
|
||||
│ └── Frontend/ # Frontend React (Dashboard)
|
||||
└── README.md
|
||||
```
|
||||
|
||||
## 🚀 Características Principales
|
||||
|
||||
- ✅ **Automatización Humanizada**: Movimientos de mouse, scrolls y pausas realistas.
|
||||
- ✅ **Cuotas Inteligentes (NUEVO)**: Límites configurables por hora y día para evitar el ban.
|
||||
- ✅ **Peak Protection (NUEVO)**: Ralentización automática del guardado ante ráfagas de mensajes.
|
||||
- ✅ **Extracción 100% Automática**: Identifica el número del remitente sin intervención humana.
|
||||
- ✅ **Dashboard en Vivo**: Monitoreo de logs, galería y estado de conexión vía SignalR.
|
||||
- ✅ **Anti-Detección Elite**: 15 técnicas de ocultación de fingerprinting.
|
||||
|
||||
## 🎯 Extracción Automática de Números
|
||||
|
||||
El sistema utiliza **5 niveles de respaldo** para obtener el teléfono (desde metadatos internos hasta selectores visuales). Funciona sin necesidad de tener el chat abierto o hacer clic manual, asegurando que cada archivo guardado tenga su origen identificado.
|
||||
|
||||
## 📦 Instalación y Ejecución
|
||||
|
||||
### 1. Backend (.NET)
|
||||
```bash
|
||||
cd src/Backend/WhatsappPromo.Worker
|
||||
dotnet run
|
||||
```
|
||||
*Servicio en: `http://localhost:5067`*
|
||||
|
||||
### 2. Frontend (React)
|
||||
```bash
|
||||
cd src/Frontend/WhatsappPromo.Dashboard
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
*Dashboard en: `http://localhost:5173`*
|
||||
|
||||
## 🛡️ Seguridad y Anti-Detección
|
||||
|
||||
### **Gestión Automatizada (Backend)**
|
||||
Para máxima seguridad, el sistema autogestiona su comportamiento:
|
||||
1. **Límites de Cuota**: Detiene el procesamiento si se supera el máximo configurado por hora/día.
|
||||
2. **Cola Segura**: Los mensajes recibidos se encolan en memoria y se procesan con delays humanos variables.
|
||||
3. **Throttling Automático**: Al alcanzar el 80% de la cuota horaria, el sistema ralentiza el guardado (Peak Protection) para suavizar la curva de actividad ante los ojos de WhatsApp.
|
||||
|
||||
### **Evasión de Fingerprinting**
|
||||
- ✅ **Navigator Hiding**: Oculta `webdriver`, simula `plugins`, `languages` y `hardware specs`.
|
||||
- ✅ **API Spoofing**: Simula Battery API, Connection API y normaliza Permissions.
|
||||
- ✅ **Graphics Masking**: Falsifica WebGL Vendor y Renderer (Intel UHD Graphics).
|
||||
- ✅ **Behavioral Jitter**: Añade 0-5ms de variación aleatoria a cada acción técnica.
|
||||
|
||||
---
|
||||
|
||||
## 🕒 Guía de Uso Responsable (Manual de Buenas Prácticas)
|
||||
|
||||
Aunque el sistema es altamente seguro, la detección por parte de los servidores de WhatsApp depende de tu comportamiento operativo.
|
||||
|
||||
### **1. La Regla de Oro: NO operar 24/7**
|
||||
Un usuario real nunca está conectado 24 horas. Para mantener una cuenta segura:
|
||||
- **Horario Laboral**: Opera entre 6 y 10 horas al día.
|
||||
- **Pausas Nocturnas**: Apaga el sistema durante la noche (ej. 20:00 a 08:00).
|
||||
- **Días Libres**: No conectes el sistema todos los días. Deja 1 o 2 días de descanso semanal.
|
||||
|
||||
### **2. Configuración de Cuotas Seguras**
|
||||
Recomendamos iniciar con estos valores conservadores:
|
||||
- **Máximo por Hora**: 5 - 15 archivos.
|
||||
- **Máximo por Día**: 20 - 50 archivos.
|
||||
*Nota: El sistema dejará en espera los archivos que excedan estos límites hasta que se reinicie el ciclo (la siguiente hora o el día siguiente).*
|
||||
|
||||
### **3. Variación de Horarios**
|
||||
Evita la "precisión robótica". No inicies el sistema exactamente a las 09:00:00 todos los días. Varía tus horarios ±30 minutos para simular un comportamiento humano errático.
|
||||
|
||||
### **🚨 Señales de Alerta**
|
||||
Si WhatsApp te solicita verificaciones SMS frecuentes o experimentas desconexiones inusuales:
|
||||
1. **Detén el sistema** de inmediato.
|
||||
2. **Espera 72 horas** antes de volver a conectar.
|
||||
3. **Reduce tus cuotas** a la mitad al reiniciar.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Puntuación de Seguridad Final
|
||||
|
||||
```
|
||||
┌───────────────────────────────────────────────────┐
|
||||
│ NIVEL DE PROTECCIÓN ANTI-DETECCIÓN │
|
||||
├───────────────────────────────────────────────────┤
|
||||
│ Navigator & APIs: ✅ 10/10 (Completo) │
|
||||
│ Hardware & Graphics: ✅ 10/10 (Spoofing) │
|
||||
│ Behavior & Quotas: ✅ 9/10 (Automatizado) │
|
||||
├───────────────────────────────────────────────────┤
|
||||
│ TOTAL FINAL: ⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐ (9.5/10) │
|
||||
└───────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 📝 Notas Técnicas
|
||||
- **Perfiles**: La sesión se guarda en la carpeta `whatsapp-profile` del backend.
|
||||
- **Multimedia**: Los archivos se almacenan por defecto en `ReceivedMedia`.
|
||||
- **CORS**: Asegúrate de que el frontend tenga acceso al puerto 5067 del backend.
|
||||
|
||||
---
|
||||
|
||||
**Versión**: 2.5 | **Última actualización**: 2026-02-09
|
||||
**Estado de Seguridad**: ✅ Protección Integral Automatizada
|
||||
Reference in New Issue
Block a user