whatsapp/GUIA_HESTIACP.md

🛠️ Guía de Instalación en HestiaCP

Desarrollado por U-Site.app - https://u-site.app

⚠️ Problema Común en Hostings Compartidos

El instalador automático (install.php) NO FUNCIONA en hostings compartidos como HestiaCP, cPanel, etc., porque requiere privilegios de administrador para crear bases de datos y usuarios.

✅ Solución: Instalación Manual

Usa el archivo install_manual.php que he creado específicamente para hostings compartidos.

---

📋 Pasos en HestiaCP

1. Crear Base de Datos

1. Entra al panel de HestiaCP
2. Ve a "Databases" o "Base de datos"
3. Haz clic en "Add Database"
4. Configura:
   • Database Name: whatsapp_bot (o el nombre que prefieras)
   • Database User: Crea un usuario (ej: whatsapp_user)
   • Password: Usa una contraseña segura
   • Privileges: Selecciona ALL o todos los permisos

2. Anotar Credenciales

Guarda esta información que necesitarás:

Host: localhost
Puerto: 3306 (generalmente)
Base de datos: [el nombre que creaste]
Usuario: [el usuario que creaste]
Contraseña: [la contraseña que configuraste]

3. Ejecutar Instalación Manual

1. Abre tu navegador web
2. Ve a: https://tudominio.com/ruta-del-bot/install_manual.php
3. Completa el formulario con las credenciales del paso anterior
4. Haz clic en "Configurar Sistema"

---

🔧 Características del Instalador Manual

✅ Lo que SÍ hace:

• ✅ Conecta con tu BD existente
• ✅ Crea todas las tablas necesarias
• ✅ Inserta datos de configuración inicial
• ✅ Genera contraseña de admin aleatoria
• ✅ Configura el archivo config.php
• ✅ Detecta automáticamente la URL del servidor
• ✅ Protege contra reinstalaciones accidentales
• ✅ Crea archivo de credenciales

❌ Lo que NO necesita:

• ❌ Privilegios de root/administrador
• ❌ Crear la base de datos (ya la creaste)
• ❌ Crear el usuario (ya lo creaste)
• ❌ Configuración especial del servidor

---

📁 Estructura Típica en HestiaCP

/public_html/
├── tu-bot/
│   ├── install_manual.php  ← Usa este archivo
│   ├── install.php         ← NO uses este (no funciona)
│   ├── config/
│   ├── api/
│   └── ...resto de archivos

---

🚨 Errores Comunes y Soluciones

Error: "se queda cargando"

Problema: El instalador automático intenta crear BD con privilegios que no tienes. Solución: Usa install_manual.php en lugar de install.php

Error: "Access denied for user"

Problema: Credenciales incorrectas o permisos insuficientes. Solución:

• Verifica que el usuario tenga ALL PRIVILEGES en la BD
• Confirma host, usuario y contraseña
• Asegúrate de que la BD existe

Error: "Connection refused"

Problema: Host o puerto incorrectos. Solución:

• Usa localhost como host
• Confirma que el puerto sea 3306
• Verifica que MySQL esté corriendo

Error: "Database doesn't exist"

Problema: Nombre de BD incorrecto o no existe. Solución:

• Verifica el nombre exacto en el panel de HestiaCP
• Asegúrate de que la BD fue creada correctamente

---

🎯 Después de la Instalación

1. Guarda las credenciales: Se generará un archivo CREDENCIALES_SISTEMA.txt
2. Prueba el sistema: Ve a test.php para verificar
3. Configura WhatsApp: Ve a server_setup.php
4. Accede al panel: Ve a index.php con usuario admin

---

📞 Soporte Técnico

• Email: support@u-site.app
• Web: https://u-site.app/support
• Documentación: Este archivo y los comentarios en el código

---

🔐 Credenciales por Defecto

Base de Datos

• Host: localhost
• Usuario/Contraseña: Los que TÚ configuraste en HestiaCP

Panel Admin

• Usuario: admin
• Contraseña: Se genera automáticamente (se muestra durante instalación)

---

⚡ Comandos Útiles para Debugging

Verificar conexión desde terminal:

mysql -h localhost -u tu_usuario -p tu_basedatos

Ver tablas después de instalar:

USE tu_basedatos;
SHOW TABLES;

Ver configuración de usuario:

SELECT User, Host FROM mysql.user WHERE User='tu_usuario';
SHOW GRANTS FOR 'tu_usuario'@'localhost';

---

¡Listo! Con esta guía deberías poder instalar sin problemas en HestiaCP. 🚀