# Guardian — Expansiones Futuras
## Documentación de módulos planificados

**Fecha:** 2026-03-23
**Servidor:** atlas.soma9.cloud (91.134.54.216)
**Bot base:** @Soma9SecurityBot (ya activo)

---

## 1. Control de cPanel desde Telegram

### ¿Qué es?
Un módulo que conecta el bot de Telegram con las cuentas de cPanel en tu servidor. Puedes ver, crear, modificar y administrar todas las cuentas de hosting de tus clientes sin abrir WHM.

### Qué podrás hacer:

**Consultar:**
- Listar todas las cuentas de hosting
- Ver uso de disco, ancho de banda, emails de cada cuenta
- Ver dominios asociados a cada cuenta
- Ver cuentas suspendidas
- Buscar un cliente por nombre o dominio

**Administrar:**
- Crear cuentas nuevas
- Suspender / reactivar cuentas
- Cambiar plan de hosting
- Cambiar contraseña de una cuenta
- Hacer backup de una cuenta específica
- Migrar cuentas

**Monitorear:**
- Alertas de cuentas que exceden su disco
- Alertas de cuentas que exceden ancho de banda
- Reporte semanal de uso por cuenta

### Cómo se vería en Telegram:

```
Tú: "clientes"

Bot:
👥 Tienes 47 cuentas activas

📊 Resumen:
  • 43 activas
  • 3 suspendidas
  • 1 excediendo disco

[📋 Ver todas]
[🔍 Buscar cliente]
[➕ Crear cuenta]
[⚠️ Ver problemas]
```

```
Tú tocas "Ver problemas":

Bot:
⚠️ Cuentas con problemas:

🔴 juanperez.com — 98% disco (4.9GB / 5GB)
🟡 mariashop.com — 85% disco (8.5GB / 10GB)
🔵 carloslanding.com — suspendida hace 15 días

[📧 Avisar a juanperez.com]
[📈 Ampliar disco juanperez.com]
[🗑️ Eliminar carloslanding.com]
```

### Tecnología:
- WHM API (ya disponible en el servidor)
- Comandos: `whmapi1` para acciones administrativas
- `cpapi2` / `uapi` para acciones dentro de cuentas
- No requiere instalar nada adicional

---

## 2. Control de WHMCS desde Telegram

### ¿Qué es?
Un módulo que conecta el bot con WHMCS (sistema de facturación y gestión de clientes). Controla facturas, clientes, tickets de soporte y servicios desde Telegram.

### Requisito:
- WHMCS instalado y funcionando
- API de WHMCS habilitada (se activa en Configuración > General > Seguridad)

### Qué podrás hacer:

**Facturación:**
- Ver facturas pendientes / vencidas
- Crear facturas manualmente
- Marcar facturas como pagadas
- Enviar recordatorios de pago
- Ver ingresos del mes

**Clientes:**
- Buscar clientes
- Ver datos de un cliente
- Ver historial de pagos
- Crear clientes nuevos

**Servicios:**
- Ver servicios activos
- Suspender / reactivar por falta de pago
- Cambiar plan de un cliente
- Ver renovaciones próximas

**Soporte:**
- Ver tickets abiertos
- Responder tickets desde Telegram
- Cerrar tickets
- Asignar prioridades

**Reportes:**
- Ingresos del día/semana/mes
- Clientes morosos
- Tickets sin responder
- Servicios por vencer

### Cómo se vería en Telegram:

```
Tú: "facturación"

Bot:
💰 Resumen de facturación

Hoy: $150
Esta semana: $1,250
Este mes: $4,800

Pendientes: 8 facturas ($620)
Vencidas: 3 facturas ($175)

[📋 Ver pendientes]
[🔴 Ver vencidas]
[📧 Cobrar morosos]
[➕ Crear factura]
```

```
Tú tocas "Ver vencidas":

Bot:
🔴 Facturas vencidas:

1. Juan Pérez — $25
   Hosting básico — vencida hace 5 días

2. María López — $50
   Hosting premium — vencida hace 12 días

3. Carlos Ruiz — $15
   Dominio .com — vencida hoy

[📧 Enviar recordatorio a todos]
[⏸️ Suspender servicios morosos]
[👁️ Ver detalle de cada uno]
```

```
Tú tocas "Enviar recordatorio a todos":

Bot:
📧 Recordatorio enviado a:
  ✅ Juan Pérez (juan@email.com)
  ✅ María López (maria@email.com)
  ✅ Carlos Ruiz (carlos@email.com)

Se les envió el email de recordatorio de pago.
```

### Flujo de aprobación:
Para acciones importantes (suspender, eliminar, crear facturas), el bot pedirá confirmación:

```
Bot:
⚠️ Confirmar: Suspender servicio de María López
Hosting premium — $50/mes — vencida hace 12 días

[✅ Suspender] [❌ No, esperar]
```

### Tecnología:
- WHMCS API (REST)
- Autenticación por API Key
- No requiere modificar WHMCS
- Se conecta desde el mismo bot de Guardian

---

## 3. Agente IA para tareas en cPanel

### ¿Qué es?
Un agente de inteligencia artificial que recibe instrucciones en lenguaje natural y ejecuta tareas en las cuentas de cPanel automáticamente.

### Ejemplos de uso:

```
Tú: "crea una cuenta para el dominio nuevocliente.com,
     plan básico, 5GB de disco, email: cliente@nuevocliente.com"

Bot:
🤖 Entendido. Voy a:
  1. Crear cuenta cPanel: nuevocliente
  2. Dominio: nuevocliente.com
  3. Plan: básico (5GB disco, 50GB BW)
  4. Email de bienvenida a: cliente@nuevocliente.com

[✅ Proceder] [✏️ Modificar] [❌ Cancelar]
```

```
Tú: "revisa todas las cuentas que llevan más de 30 días
     suspendidas y dame una lista para eliminarlas"

Bot:
🤖 Revisando... encontré 4 cuentas:

  🗑️ oldsite.com — suspendida 45 días — sin pago
  🗑️ test123.com — suspendida 60 días — sin pago
  🗑️ miproyecto.net — suspendida 35 días — sin pago
  🗑️ demo.org — suspendida 90 días — sin pago

[🗑️ Eliminar todas]
[👁️ Ver detalle de cada una]
[❌ No eliminar ninguna]
```

```
Tú: "optimiza el rendimiento de la cuenta juanperez.com"

Bot:
🤖 Analizando juanperez.com...

Encontré:
  ⚠️ 2,340 emails en cola — limpiando
  ⚠️ Logs de 3GB — rotando
  ⚠️ Cache de WordPress desactualizado
  ⚠️ PHP 7.4 (debería ser 8.2)

[✅ Arreglar todo] [👁️ Detalle] [❌ No tocar]
```

### Principio de seguridad:
- **El agente NUNCA ejecuta sin tu confirmación**
- Siempre te muestra qué va a hacer y espera tu "OK"
- Las acciones destructivas (eliminar, suspender) siempre piden doble confirmación
- Todo queda registrado en el historial del bot

### Tecnología:
- IA: Groq API (gratis) o Claude API
- Ejecuta comandos WHM/cPanel a través de las APIs
- El agente entiende lenguaje natural y lo traduce a acciones técnicas

---

## 4. Bot de WhatsApp para clientes

### ¿Qué es?
Un bot de WhatsApp Business que atiende a tus clientes automáticamente. Pueden preguntar por sus servicios, pagar facturas, abrir tickets de soporte, todo por WhatsApp.

### Qué podrán hacer tus clientes:

**Consultas:**
- "¿Cuánto debo?" → Ve su factura pendiente
- "¿Cuándo se renueva mi hosting?" → Fecha de renovación
- "¿Cuál es mi servidor de email?" → Datos de configuración
- "¿Tienen hosting con WordPress?" → Info de planes

**Soporte:**
- "Mi sitio no carga" → Abre ticket automático + te notifica
- "No puedo entrar a mi email" → Guía de solución automática
- "Necesito más espacio" → Opciones de upgrade

**Pagos:**
- Enviar link de pago
- Confirmar pagos recibidos
- Recordatorios automáticos antes del vencimiento

### Cómo se ve para el cliente:

```
Cliente: "Hola, ¿cuánto debo?"

Bot:
Hola Juan! 👋

Tienes 1 factura pendiente:

📄 Hosting Premium — $50
   Vence: 28 de marzo 2026

💳 Pagar ahora: [link de pago]

¿Necesitas algo más?
```

```
Cliente: "Mi sitio esta caído"

Bot:
Lamento escuchar eso Juan. Déjame revisar...

🔍 Revisando juanperez.com...

Tu sitio está respondiendo normalmente desde nuestros servidores.
Puede ser un problema de DNS o de tu conexión.

¿Quieres que:
1. Abra un ticket para que un técnico lo revise
2. Te envíe una guía para limpiar tu caché DNS
3. Hablar con un humano
```

### Lo que tú ves en Telegram:

Cada conversación importante te llega como notificación:

```
Bot Guardian:
💬 WhatsApp — Juan Pérez
Reporta: "mi sitio esta caído"
El bot le respondió con diagnóstico automático.
El sitio SI está funcionando.

[👁️ Ver conversación]
[🎫 Abrir ticket]
[💬 Responder yo]
```

### Costos:
- 1,000 conversaciones/mes gratis (si el cliente escribe primero)
- Después: ~$0.04-0.08 por conversación
- Para la mayoría de negocios pequeños/medianos: $0/mes

### Tecnología:
- WhatsApp Cloud API (Meta)
- Cuenta Meta Business (gratis)
- IA para respuestas naturales (Groq gratis)
- Conectado al mismo servidor y bot de Guardian

---

## 5. Arquitectura completa

Cuando todo esté implementado:

```
                    ┌─────────────────────────────┐
                    │      Tu servidor             │
                    │      91.134.54.216            │
                    │                               │
┌───────────┐      │  ┌─────────────────────────┐ │
│ Telegram   │◀────▶│  │  Guardian Bot            │ │
│ (tú)       │      │  │  ├─ Seguridad (activo)   │ │
└───────────┘      │  │  ├─ cPanel control        │ │
                    │  │  ├─ WHMCS control         │ │
┌───────────┐      │  │  ├─ Agente IA             │ │
│ WhatsApp   │◀────▶│  │  └─ WhatsApp bridge      │ │
│ (clientes) │      │  └─────────────────────────┘ │
└───────────┘      │                               │
                    │  ┌──────────┐ ┌──────────┐   │
                    │  │  WHM     │ │  WHMCS   │   │
                    │  │  API     │ │  API     │   │
                    │  └──────────┘ └──────────┘   │
                    │                               │
                    │  ┌──────────────────────┐    │
                    │  │  IA (Groq API gratis) │    │
                    │  │  Lenguaje natural     │    │
                    │  └──────────────────────┘    │
                    └─────────────────────────────┘
```

**Todo en un solo servidor. Todo controlado por ti desde Telegram. Costo: $0.**

---

## 6. Orden de implementación sugerido

| Prioridad | Módulo | Dependencia | Dificultad |
|-----------|--------|-------------|------------|
| 1 | Guardian Security (Telegram) | Ninguna | ✅ HECHO |
| 2 | IA conversacional (Groq) | Guardian bot | Baja |
| 3 | Control de cPanel | Guardian bot | Media |
| 4 | Control de WHMCS | WHMCS instalado + Guardian | Media |
| 5 | Agente IA para cPanel | IA + Control cPanel | Media-Alta |
| 6 | Bot de WhatsApp | Meta Business + IA | Media |
| 7 | WhatsApp + WHMCS integrado | Todo lo anterior | Alta |

Cada módulo se agrega al mismo bot sin romper lo que ya funciona.

---

*Documento creado: 2026-03-23. Se actualizará conforme se implementen los módulos.*