whatsapp/GUIA_HESTIACP_COMPLETA.md

🚀 Instalación en HestiaCP - WhatsApp Bot Manager

📦 Archivo para HestiaCP

• Archivo: whatsapp_HESTIACP_READY_20260104_104546.zip
• Optimizado para: HestiaCP + hosting compartido/VPS
• Tamaño: ~168KB

🔧 .htaccess Reparado para HestiaCP

✅ Mejoras Implementadas:

• Compatibilidad HestiaCP: Sintaxis moderna (Require all denied)
• Seguridad avanzada: Protección contra inyecciones SQL/XSS
• Rendimiento: Compresión GZIP y cache optimizado
• APIs: Headers específicos para WhatsApp webhook
• CSP: Content Security Policy configurado

🛡️ Protecciones de Seguridad:

• ✅ Archivos de configuración protegidos
• ✅ Archivos .env bloqueados
• ✅ Logs inaccesibles desde web
• ✅ Tests bloqueados en producción
• ✅ Headers de seguridad completos

📋 Instalación en HestiaCP

1. Acceso al Panel

1. Acceder a HestiaCP: https://tu-servidor:8083
2. Login con credenciales de admin
3. Ir a "Web" → Seleccionar dominio

2. Subir Archivos

1. File Manager → public_html/
2. Subir whatsapp_HESTIACP_READY_20260104_104546.zip
3. Extraer ZIP en public_html/
4. Borrar archivo ZIP después

3. Configurar Permisos en HestiaCP

1. En File Manager, seleccionar carpetas:
   - logs/ → Permisos 777
   - uploads/ → Permisos 777
   - config/ → Permisos 755

2. O por SSH:
   chmod 777 public_html/logs/
   chmod 777 public_html/uploads/
   chmod 644 public_html/.htaccess

4. Crear Base de Datos

1. En HestiaCP → "DB"
2. Add Database:
   - Name: whatsapp_bot
   - User: whatsapp_user
   - Password: [generar segura]
3. Importar database/schema.sql

5. Configurar config.php

// Editar public_html/config/config.php
define('DB_HOST', 'localhost');
define('DB_NAME', 'usuario_whatsapp_bot'); // prefijo_nombre
define('DB_USER', 'usuario_whatsapp_user'); // prefijo_usuario
define('DB_PASS', 'tu_password_db');
define('DB_PORT', 3306);
define('DB_CHARSET', 'utf8mb4');

🌐 Configuración Específica HestiaCP

SSL/HTTPS (Recomendado)

1. En HestiaCP → "Web" → tu dominio
2. "Edit" → SSL → "Generate" (Let's Encrypt)
3. Activar "Force SSL redirect"
4. En .htaccess descomenta las líneas HTTPS

PHP Version

1. En HestiaCP → "Web" → Edit domain
2. "Advanced options" → PHP Version: 8.1+
3. "Save"

Subdominio (Opcional)

1. En HestiaCP → "Web" → "Add Web Domain"
2. Domain: bot.tudominio.com
3. Mismo proceso de instalación

🔑 Acceso al Sistema

URLs de Acceso:

• Dashboard: https://tudominio.com/
• Login: https://tudominio.com/login.php
• Verificador: https://tudominio.com/verificar_servidor.php
• Webhook: https://tudominio.com/api/webhook.php

Credenciales:

• Usuario: admin
• Contraseña: 2fa904eee46f

🧪 Verificación Post-Instalación

1. Test básico

1. Ir a: https://tudominio.com/verificar_servidor.php
2. Verificar que todo esté en ✅ verde
3. Corregir cualquier ❌ error mostrado

2. Test de login

1. Ir a: https://tudominio.com/login.php
2. Ingresar credenciales
3. Verificar acceso al dashboard

3. Test de webhook

1. Verificar: https://tudominio.com/api/webhook.php
2. Debe mostrar: "Webhook endpoint activo"
3. Configurar URL en WhatsApp Business API

⚙️ Configuración WhatsApp API

En el Dashboard:

1. Login al sistema
2. Ir a "Configuraciones" 
3. Completar:
   - WhatsApp Access Token
   - Phone Number ID
   - Business Account ID
   - Webhook Verify Token

En WhatsApp Business API:

1. Facebook Developers → App → WhatsApp
2. Configuration → Webhook URL:
   https://tudominio.com/api/webhook.php
3. Verify Token: (copiar del dashboard)
4. Suscribirse a: conversations, message_status

🚨 Solución de Problemas HestiaCP

Error 500 - Internal Server Error

1. Revisar error log en HestiaCP → Statistics → Error Log
2. Verificar permisos de archivos/carpetas
3. Comprobar sintaxis de .htaccess
4. Revisar versión PHP (requiere 7.4+)

Base de datos no conecta

1. Verificar credenciales en config/config.php
2. Comprobar prefijo de usuario/DB en HestiaCP
3. Verificar que DB esté en mismo servidor
4. Probar conexión desde File Manager

Headers de seguridad

1. Si hay conflicto con CSP, editar .htaccess
2. Ajustar Content-Security-Policy según necesidades
3. Para debugging, comentar temporalmente CSP

Webhook no recibe mensajes

1. Verificar URL pública accesible
2. Comprobar SSL activo
3. Revisar logs en HestiaCP
4. Test manual: curl -X POST https://tudominio.com/api/webhook.php

📞 Soporte Específico HestiaCP

Documentación oficial: https://docs.hestiacp.com/ Panel de control: Acceso vía puerto 8083 Logs del sistema: /var/log/hestia/ PHP logs: Panel → Statistics → Error Log

🎯 Optimizaciones HestiaCP

Performance

1. Activar OPcache en PHP system_config
2. Configurar Redis/Memcached si disponible
3. Optimizar MySQL en HestiaCP system_config
4. Usar Cloudflare para CDN

Backup

1. HestiaCP → Backups → Schedule
2. Backup automático diario/semanal
3. Incluir: Web, DB, Mail
4. Almacenar en storage externo

¡Sistema listo para funcionar en HestiaCP! 🚀