whatsapp/INSTALACION.md

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