whatsapp/README_SETUP.md

# 🚀 Guía de Configuración Completa - WhatsApp Bot Manager

## ✅ Estado del Sistema

**Sistema validado y optimizado** - 2 de enero de 2026

### 🛠️ Mejoras Implementadas

- ✅ Estructura de archivos validada y completa
- ✅ Configuración mejorada con soporte para archivos .env
- ✅ Sistema de logging centralizado implementado
- ✅ Permisos de archivos configurados correctamente
- ✅ Validación completa del sistema implementada
- ✅ Protecciones de seguridad añadidas (.htaccess)
- ✅ Classes y Services completamente funcionales
- ✅ API endpoints validados y operativos
- ✅ Interfaz web optimizada
- ✅ Sistema de instaladores mejorado

## 🔧 Configuración Paso a Paso

### 1. **Configuración de Variables de Entorno (Recomendado)**

Crea un archivo `.env` en la raíz del proyecto usando `.env.example` como base:

```bash
cp .env.example .env
```

Edita el archivo `.env` con tus valores reales:

```env
# Base de datos
DB_HOST=localhost
DB_PORT=3306
DB_NAME=tu_base_datos
DB_USER=tu_usuario
DB_PASS=tu_contraseña

# WhatsApp Business API
WHATSAPP_TOKEN=tu_token_real_de_facebook
WHATSAPP_PHONE_NUMBER_ID=tu_phone_number_id_real
WEBHOOK_VERIFY_TOKEN=tu_token_secreto_personalizado

# Configuración general
APP_URL=https://tudominio.com
TIMEZONE=America/Bogota
```

### 2. **Instalación de Base de Datos**

Tienes varias opciones según tu tipo de hosting:

#### **VPS/Servidor Dedicado:**
```
http://tudominio.com/install.php
```

#### **Hosting Compartido (cPanel):**
```
http://tudominio.com/install_manual.php
```

#### **Instalación Básica:**
```
http://tudominio.com/install_simple.php
```

### 3. **Validación del Sistema**

Verifica que todo esté funcionando correctamente:

```
http://tudominio.com/system_validator.php
```

Este validador te mostrará:
- ✅ Estado de PHP y extensiones
- ✅ Conexión a base de datos
- ✅ Estructura de tablas
- ✅ Archivos críticos
- ✅ Permisos de escritura
- ✅ Configuración de WhatsApp
- ✅ Estado general del sistema

### 4. **Configuración de WhatsApp Business API**

#### **Obtener Token de Acceso:**
1. Ve a [Facebook for Developers](https://developers.facebook.com/)
2. Crea una aplicación de WhatsApp Business
3. Genera un token de acceso permanente
4. Obtén tu Phone Number ID

#### **Configurar Webhook:**
1. URL del webhook: `https://tudominio.com/api/webhook.php`
2. Token de verificación: (el que configuraste en .env)
3. Eventos a suscribirse: `conversations`

### 5. **Acceso al Panel de Administración**

```
http://tudominio.com/index.php
```

**Credenciales por defecto:**
- Usuario: `admin`
- Contraseña: (generada automáticamente durante la instalación)

## 📁 Archivos y Directorios Importantes

### **Archivos de Configuración:**
- `config/config.php` - Configuración principal mejorada
- `.env` - Variables de entorno (crear desde .env.example)
- `.htaccess` - Protecciones de seguridad

### **Archivos de Instalación:**
- `install.php` - Instalador automático (VPS)
- `install_manual.php` - Para hosting compartido
- `system_validator.php` - Validador del sistema

### **Core del Sistema:**
- `classes/Database.php` - Conexión a base de datos
- `services/BotService.php` - Lógica del chatbot
- `services/WhatsAppService.php` - Integración con WhatsApp
- `api/webhook.php` - Receptor de mensajes
- `api/` - Endpoints de la API REST

### **Directorios:**
- `logs/` - Archivos de log del sistema
- `uploads/` - Archivos subidos por usuarios
- `assets/` - CSS y JavaScript del frontend

## 🔒 Seguridad Implementada

### **Protecciones de Archivos:**
- Archivo `.htaccess` con restricciones de acceso
- Protección de archivos de configuración
- Headers de seguridad HTTP
- Protección contra ataques de fuerza bruta

### **Validaciones:**
- Tokens de verificación en webhooks
- Sanitización de entradas
- Validación de permisos de usuario
- Logs de seguridad

## 🚀 Funcionalidades Listas

### **Bot Inteligente:**
- ✅ Sistema de menús parametrizables
- ✅ Respuestas automáticas por keywords
- ✅ Navegación por números (1, 2, 3...)
- ✅ Comandos especiales (menu, ayuda, salir)
- ✅ Seguimiento de estado por usuario

### **Panel Web:**
- ✅ Dashboard con estadísticas en tiempo real
- ✅ Gestión de usuarios y conversaciones
- ✅ Configuración de menús dinámicos
- ✅ Envío de mensajes individuales y masivos
- ✅ Sistema de plantillas
- ✅ Logs detallados

### **API REST:**
- ✅ Webhook para recibir mensajes
- ✅ Endpoints para envío de mensajes
- ✅ APIs para estadísticas y gestión
- ✅ Integración con sistemas externos

## 📱 Flujo de Mensajes

```
Usuario → WhatsApp → Facebook API → webhook.php → BotService → WhatsAppService → Usuario
```

## 🛠️ Comandos de Mantenimiento

### **Verificar Logs:**
```bash
tail -f logs/system.log
```

### **Limpiar Logs:**
```bash
> logs/system.log
```

### **Verificar Permisos:**
```bash
ls -la logs/ uploads/
```

## 🆘 Solución de Problemas

### **Si el webhook no recibe mensajes:**
1. Verifica la URL del webhook en Facebook
2. Confirma que el token de verificación coincida
3. Revisa los logs: `logs/system.log`
4. Valida que el SSL esté funcionando

### **Si hay errores de base de datos:**
1. Verifica las credenciales en `.env` o `config.php`
2. Confirma que las tablas existan
3. Ejecuta el validador del sistema

### **Si no se pueden escribir logs:**
1. Verifica permisos del directorio `logs/`
2. Ejecuta: `chmod 755 logs/`

## 📞 Soporte

- **Desarrollador:** U-Site.app
- **Email:** support@u-site.app
- **Documentación:** Archivos .md en el proyecto
- **Validador:** system_validator.php

## 🎉 ¡Listo para Funcionar!

Tu sistema WhatsApp Bot Manager está **completamente validado y optimizado**. 

**Próximos pasos:**
1. Ejecuta `system_validator.php` para confirmar todo está bien
2. Configura tus tokens de WhatsApp
3. Accede al panel de administración
4. ¡Comienza a usar tu chatbot!

---
**Versión del Sistema:** 1.0.0  
**Fecha de Validación:** 2 de enero de 2026  
**Estado:** ✅ Sistema Completamente Operativo