WhatsApp Bot - Planillas Río Frío

Este proyecto levanta un bot de WhatsApp utilizando Open-WA en Docker para integrar mensajes entrantes y salientes en el sistema de planillas de Beneficio Río Frío.

🚀 Cómo levantar el bot

Clonar el repositorio

git clone https://tu-repo.git
cd whatsapp-bot-planillas

Configurar el entorno

Crear un archivo .env basado en el ejemplo:
```
cp .env.example .env
```
Editá .env para definir tu WA_API_KEY y demás variables.

Desplegar con Docker Compose

docker compose -f docker-compose.whatsapp.yml up -d

Escanear el QR
- Ver los logs del contenedor.
- Escanear el código QR usando la app de WhatsApp Business.

Probar conexión

curl -H "x-api-key:TU_API_KEY" http://localhost:8080/chats

📦 Estructura del proyecto

whatsapp-bot-planillas/
├── docker-compose.whatsapp.yml
├── .env
├── .gitignore
└── README.md

⚙️ Variables de Entorno

Variable	Descripción
WA_API_KEY	Clave privada para autenticación API
WA_SESSION_ID	Nombre de la sesión (por default `planillas`)
WA_DISABLE_SPINS	Evita spinners molestos en logs (`true`)
WA_WEBHOOK	URL para recibir mensajes entrantes (opcional)

🔒 Seguridad

**No publiques tu .env** ni los archivos de sesión (sessions/).
Configurá Nginx Proxy Manager o Authentik para proteger tu endpoint.

📚 Recursos útiles

🛠️ Próximos pasos

Conectar el webhook a attendance-svc o core-hr.
Procesar mensajes y registrar asistencia automáticamente.
Automatizar respuestas básicas via WhatsApp.

Hecho con ☕ y dedicación en Río Frío, Honduras.