# 🛠️ Guía de Instalación en HestiaCP

**Desarrollado por U-Site.app** - [https://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:
```bash
mysql -h localhost -u tu_usuario -p tu_basedatos
```

### Ver tablas después de instalar:
```sql
USE tu_basedatos;
SHOW TABLES;
```

### Ver configuración de usuario:
```sql
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.** 🚀