# 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