# WhatsApp Bot Manager 🚀

**WhatsApp Bot Manager** es un panel administrativo para gestionar bots y envíos de WhatsApp. Desarrollado por U‑Site.app, pensado para instalaciones autohospedadas con PHP y MySQL.

---

## 🔧 Características principales

- Gestión de conversaciones y plantillas
- Integración con WhatsApp Business API
- Control de usuarios y seguridad (protección contra fuerza bruta)
- Manejo de archivos multimedia y envíos
- Scripts de instalación y migración incluidos

---

## ✅ Requisitos

- PHP 8.0+ (extensiones: PDO/MySQL, mbstring, curl, openssl, json)
- MySQL/MariaDB
- Servidor web (Apache/Nginx) o PHP built-in para desarrollo

---

## 🛠 Instalación rápida (desarrollo)

1. Clonar el repositorio y entrar en la carpeta:

   ```bash
   git clone <repo-url> whatsapp
   cd whatsapp
   ```

2. Configurar la base de datos en `config/config.php` o crear un archivo `.env` en la raíz.

3. Ejecutar el instalador desde el navegador: `http://tu-servidor/install.php` y seguir los pasos.

4. Para levantar un servidor de desarrollo rápido:

   ```bash
   php -S 127.0.0.1:8000 -t . >/tmp/php-server.log 2>&1 &
   # Abre: http://127.0.0.1:8000
   ```

---

## 🧭 Archivos y scripts útiles

- `install.php`, `instalar_bd.php` — instalador y creación de tablas
- `create_media_table.sql`, `execute_media_table.php` — tabla de media
- `config/config.php` — configuración principal y carga de `.env`
- `run_tests.php` — pruebas básicas
- `deploy.sh` — script de despliegue (producción)
- `verify_*` y `diagnostico_*` — páginas de diagnóstico y verificación

Consulta `README_SETUP.md`, `INSTALACION.md` y `DEPLOYMENT_GUIDE.md` para documentación extendida.

---

## 🎨 Personalización de UI

- Estilos principales: `assets/css/styles.css`
- Para ajustar el tamaño global de fuente cambia `html { font-size: ... }` o `body { font-size: ... }`

---

## 🧪 Solución rápida de problemas

- Logs del servidor integrado: `/tmp/php-server.log`
- Verificar tokens y configuración con: `verificar_servidor.php`, `verificar_token.php`, `verificar_whatsapp_config.php`
- Comprobar tablas con: `verify_media_table.php`, `check_table_structure.php`

---

## � Notas de seguridad: directorios de pruebas

Los recursos de pruebas y depuración (scripts `test_*`, `debug_*`, `diagnostico_*`, `tests/`, `scripts/` de prueba, etc.) han sido movidos al directorio `dev/`. **No** expongas `dev/` en entornos de producción. Recomendaciones:

- Mantén `dev/` fuera del documento raíz público o protégelo con HTTP auth/.htaccess.
- Añade `dev/` y `tmp/` a `.gitignore` y rota credenciales que hayan estado en `CREDENCIALES_BASICO.txt`.
- Revisa y elimina cualquier endpoint que active modo `debug` vía parámetros en producción.

---

## �📬 Soporte y créditos

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

Para soporte, abre un issue o contacta al correo de soporte configurado en la app.

---

*README corto y enfocado. Revisa los archivos de documentación para guías detalladas.*