Files
whatsapp/README.md
T
2026-01-22 10:33:16 -05:00

93 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# WhatsApp Bot Manager 🚀
**WhatsApp Bot Manager** es un panel administrativo para gestionar bots y envíos de WhatsApp. Desarrollado por USite.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 **USite.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.*