151 lines
4.6 KiB
Markdown
151 lines
4.6 KiB
Markdown
# 🤖 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! 🚀 |