# 🤖 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! 🚀