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:

cp .env.example .env

Edita el archivo .env con tus valores reales:

# 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
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:

tail -f logs/system.log

Limpiar Logs:

> logs/system.log

Verificar Permisos:

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