# WhatsApp Bot Manager 🚀

<p align="center">
  <img src="https://img.shields.io/badge/PHP-8.2+-777BB4?style=for-the-badge&logo=php&logoColor=white" alt="PHP 8.2+">
  <img src="https://img.shields.io/badge/MariaDB-10.11-003545?style=for-the-badge&logo=mariadb&logoColor=white" alt="MariaDB">
  <img src="https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker&logoColor=white" alt="Docker Ready">
  <img src="https://img.shields.io/badge/WhatsApp-API-25D366?style=for-the-badge&logo=whatsapp&logoColor=white" alt="WhatsApp API">
</p>

<p align="center">
  <strong>Panel administrativo para gestionar bots y envíos de WhatsApp Business</strong>
</p>

<p align="center">
  Desarrollado con 💚 por <a href="https://u-site.app"><strong>U-Site.app</strong></a>
</p>

---

## 🏢 Sobre U-Site.app

**U-Site.app** es una casa de desarrollo de software especializada en soluciones empresariales, automatización y aplicaciones web modernas. Creamos herramientas que simplifican procesos y potencian negocios.

🌐 **Website:** [u-site.app](https://u-site.app)

---

## ✨ Características

- 📱 **Gestión de conversaciones** - Interfaz tipo WhatsApp Web
- 📨 **Plantillas de mensajes** - Envíos masivos con templates aprobados
- 🤖 **Bot automatizado** - Respuestas automáticas configurables
- 🔐 **Autenticación segura** - Protección contra fuerza bruta
- 📎 **Multimedia** - Soporte para imágenes, documentos, audio y video
- 🔔 **Notificaciones SSE** - Tiempo real sin polling
- 🐳 **Docker Ready** - Despliegue en contenedores
- 🇨🇴 **Zona horaria Colombia** - Configurado para América/Bogotá

---

## 🛠️ Requisitos

| Requisito | Versión |
|-----------|---------|
| PHP | 8.0+ |
| MariaDB/MySQL | 10.11+ / 8.0+ |
| Redis | 7.0+ |
| Docker | 24.0+ (opcional) |

**Extensiones PHP requeridas:** PDO, MySQL, mbstring, curl, openssl, json, gd

---

## 🚀 Instalación

### Opción 1: Docker (Recomendado)

```bash
# Clonar repositorio
git clone https://github.com/tu-usuario/whatsapp.git
cd whatsapp

# Desarrollo local
docker-compose -f docker-compose.dev.yml up -d

# Producción
docker-compose -f docker-compose.prod.yml up -d
```

**URLs de acceso (desarrollo):**
- 🌐 App: http://localhost:8080
- 🗄️ phpMyAdmin: http://localhost:8084

### Opción 2: Instalación Manual

1. Clonar y configurar:
   ```bash
   git clone https://github.com/tu-usuario/whatsapp.git
   cd whatsapp
   cp .env.example .env
   ```

2. Editar `.env` con tus credenciales

3. Ejecutar instalador: `http://tu-servidor/install.php`

---

## 📁 Estructura del Proyecto

```
whatsapp/
├── api/                 # Endpoints API REST
├── assets/              # CSS, JS, imágenes
├── classes/             # Clases PHP (Database, Services)
├── config/              # Configuración
├── database/            # Scripts SQL y backups
├── docker/              # Configuración Docker (nginx, php, supervisor)
├── services/            # Servicios (WhatsApp, Bot)
├── uploads/             # Archivos subidos
├── Dockerfile           # Imagen principal
├── Dockerfile.worker    # Imagen para workers
├── docker-compose.dev.yml    # Desarrollo
├── docker-compose.prod.yml   # Producción
└── deploy-vps.sh        # Script de despliegue
```

---

## ⚙️ Configuración

### Variables de Entorno (.env)

```env
# Base de datos
DB_HOST=mysql
DB_PORT=3306
DB_NAME=usite_whatsapp_bot
DB_USER=tu_usuario
DB_PASS=tu_password

# WhatsApp Business API
WHATSAPP_TOKEN=tu_token_aqui
WHATSAPP_PHONE_NUMBER_ID=tu_phone_id
WEBHOOK_VERIFY_TOKEN=tu_webhook_token

# Redis
REDIS_HOST=redis
REDIS_PORT=6379
```

### Webhook de WhatsApp

Configura el webhook en Meta Developer Console:
- **URL:** `https://tu-dominio.com/api/webhook.php`
- **Verify Token:** El mismo que `WEBHOOK_VERIFY_TOKEN`

---

## 🐳 Contenedores Docker

| Contenedor | Descripción | Puerto |
|------------|-------------|--------|
| `whatsapp-app` | PHP + Nginx | 80, 443 |
| `whatsapp-mysql` | MariaDB 10.11 | 3306 |
| `whatsapp-redis` | Redis 7 | 6379 |
| `whatsapp-worker` | Procesos background | - |

---

## 📖 Documentación Adicional

- [Guía de Instalación](INSTALACION.md)
- [Guía de Despliegue](DEPLOYMENT_GUIDE.md)
- [Configuración SSE](README_SSE.md)
- [Solución de Problemas](SOLUCION_HOSTING.md)

---

## 🔒 Seguridad

- Los directorios `dev/`, `tests/`, `scripts/` contienen herramientas de desarrollo
- **NO exponer** estos directorios en producción
- Proteger con `.htaccess` o configuración de nginx
- Rotar credenciales regularmente

---

## 📄 Licencia

Propietario - © 2026 [U-Site.app](https://u-site.app)

---

<p align="center">
  <strong>Desarrollado con 💚 por <a href="https://u-site.app">U-site.app</a></strong>
</p>