up

2026-01-28 03:09:52 -05:00
parent faec66ebf3
commit e96f507a06
12 changed files with 148 additions and 66 deletions
@@ -0,0 +1,151 @@
+# 🤖 WhatsApp Bot Manager - Guía de Instalación Rápida
+
+## 🚀 Pasos para poner en funcionamiento:
+
+### 1. 📊 Instalar Base de Datos
+- Abrir en navegador: `http://localhost/migrador/install.php`
+- Hacer clic en "Ejecutar Instalación"
+- Verificar que todas las tablas se crearon correctamente
+
+### 2. 🔧 Verificar Sistema
+- Abrir: `http://localhost/migrador/test.php`
+- Revisar que todos los componentes estén en ✅
+
+### 3. 🌐 Acceder al Panel
+- Abrir: `http://localhost/migrador/index.php`
+- Navegar por las diferentes secciones
+
+### 4. ⚙️ Configurar WhatsApp (IMPORTANTE)
+1. Ir a **Configuración** en el panel
+2. Completar:
+   - **Token de WhatsApp**: EAAWTKu1iZAGABP46c7GZAFvHremu9uvTLOlgZCAa4eKUlaCqszzsQjjLcgnqORzo2EBhB7LZAcAqJ7clpGvNCk3oXKnqo8Fl0K2o7eHYoeaqZBesqjBPRfsd4ZBOdY4kN1YBJnmRznegTD9wtJZByVrRcMXF8YXaAJjLCuIFZCK7QFUpId7i4eVkFvbqUYnUKA91rgPvaeGRNZCLHa5ZC1ZB2Skn0gFNgPTBx7bedAMULYZD
+   - **Phone Number ID**: 938177732702718
+   - **Webhook Token**: mi_token_secreto_123
+3. Guardar configuración
+
+### 5. 🔗 Configurar Webhook en Facebook
+1. Ir a [Facebook for Developers](https://developers.facebook.com)
+2. Crear/configurar aplicación WhatsApp Business
+3. Webhook URL: `https://tudominio.com/migrador/api/webhook.php`
+4. Token de verificación: `mi_token_secreto_123`
+5. Suscribirse a eventos: `conversations`
+
+## 🎯 Prueba Rápida del Bot
+
+Envía estos mensajes por WhatsApp para probar:
+
+```
+👤 Usuario: "Hola"
+🤖 Bot: Mensaje de bienvenida
+
+👤 Usuario: "menu"
+🤖 Bot: Muestra menú principal
+
+👤 Usuario: "1"
+🤖 Bot: Muestra submenú de servicios
+
+👤 Usuario: "ayuda"
+🤖 Bot: Muestra información de ayuda
+```
+
+## 📋 Funcionalidades Principales
+
+### 🤖 Bot Automático
+- ✅ Menús navegables por números
+- ✅ Respuestas automáticas
+- ✅ Comandos especiales (menu, ayuda, salir)
+- ✅ Gestión de estados de usuario
+
+### 🎛️ Panel de Control
+- ✅ Dashboard con estadísticas
+- ✅ Gestión de conversaciones
+- ✅ Administración de usuarios
+- ✅ Editor de menús
+- ✅ Envío de mensajes
+- ✅ Configuración del sistema
+
+### 🔧 APIs Disponibles
+- ✅ Webhook para recibir mensajes
+- ✅ Envío de mensajes individuales
+- ✅ Envío masivo (broadcast)
+- ✅ Gestión de menús
+- ✅ Estadísticas y reportes
+
+## 🛠️ Estructura de Archivos
+
+```
+bot/
+├── 🏠 index.php              # Panel principal
+├── 🔧 install.php            # Instalador automático
+├── 🧪 test.php               # Script de pruebas
+├── 📖 README.md              # Documentación completa
+├── config/
+│   └── config.php           # Configuración
+├── database/
+│   └── schema.sql           # Esquema de BD
+├── api/                     # APIs REST
+│   ├── webhook.php          # Webhook principal
+│   ├── send_message.php     # Envío de mensajes
+│   ├── get_stats.php        # Estadísticas
+│   └── [más APIs...]
+├── classes/
+│   └── Database.php         # Conexión BD
+├── services/
+│   ├── WhatsAppService.php  # Servicio WhatsApp
+│   └── BotService.php       # Lógica del bot
+└── assets/
+    ├── css/styles.css       # Estilos
+    └── js/app_simple.js            # JavaScript
+```
+
+## 🎨 Personalización
+
+### Cambiar Menús
+1. Ir a **Menús** en el panel
+2. Editar menús existentes o crear nuevos
+3. Configurar opciones y acciones
+
+### Agregar Respuestas Automáticas
+1. Ir a **Respuestas Auto**
+2. Agregar nuevas palabras clave
+3. Definir respuestas personalizadas
+
+### Configurar Mensajes Masivos
+1. Ir a **Enviar Mensaje**
+2. Usar la sección "Mensaje Masivo"
+3. Seleccionar filtros de usuarios
+
+## 🚨 Solución de Problemas
+
+### ❌ Error de conexión BD
+- Verificar credenciales en `config/config.php`
+- Comprobar que MySQL esté funcionando
+- Revisar permisos del usuario
+
+### ❌ Webhook no funciona
+- Verificar que la URL sea accesible públicamente
+- Comprobar SSL (debe ser HTTPS)
+- Revisar logs en el panel
+
+### ❌ Bot no responde
+- Verificar token en configuración
+- Comprobar webhook en Facebook
+- Revisar logs de PHP
+
+## 📞 URLs de Prueba
+
+- **Panel**: http://localhost/bot/index.php
+- **Test**: http://localhost/bot/test.php
+- **API Stats**: http://localhost/bot/api/get_stats.php
+- **Webhook**: http://localhost/bot/api/webhook.php
+
+## 🎯 ¡Sistema Listo!
+
+Una vez completados todos los pasos, tendrás:
+
+- 🤖 **Bot funcional** respondiendo mensajes automáticamente
+- 🎛️ **Panel web** para gestión completa
+- 📊 **Dashboard** con métricas en tiempo real
+- 🔧 **APIs** para integraciones personalizadas
+
+¡Disfruta de tu nuevo sistema de WhatsApp Bot! 🚀