178 lines
4.7 KiB
Markdown
178 lines
4.7 KiB
Markdown
# 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>
|