WhatsApp Bot Manager 🚀

Panel administrativo para gestionar bots y envíos de WhatsApp Business

Desarrollado con 💚 por U-Site.app

---

🏢 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

---

✨ 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)

# 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:

   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)

# 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
• Guía de Despliegue
• Configuración SSE
• Solución de Problemas

---

🔒 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

---

Desarrollado con 💚 por U-site.app