wpp-gateway-oss
Gateway auto-alojado para notificaciones WhatsApp transaccionales con rotación de canales, cola asíncrona y failover automático. Usa Baileys (WhatsApp Web) para evitar costes oficiales, priorizando la fiabilidad sobre el uso masivo.
Ficha actualizada 22 sept 2026, 17:13 · upstream 22 sept 2026, 15:26 · release sin release detectada
Qué es wpp-gateway-oss
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio implementa un gateway de notificaciones WhatsApp auto-alojado diseñado para sistemas que requieren alertas transaccionales como OTPs o confirmaciones. Surge como alternativa pragmática a la API oficial de WhatsApp Business, evitando sus costes por conversación y burocracia de aprobación de plantillas.
La arquitectura se basa en TypeScript con Fastify para el API público, una cola BullMQ gestionada por Redis y un worker que utiliza Baileys para interactuar con WhatsApp Web. El sistema implementa rotación automática entre múltiples canales para mitigar riesgos de baneo, junto con colas de espera y failover cuando un canal cae.
Incluye un panel administrativo multi-tenant construido con Next.js, permitiendo gestión de usuarios con 2FA, visualización de métricas por canal y proyecto, y configuración de límites diarios. La infraestructura requiere PostgreSQL para persistencia de datos y Redis para la cola, gestionables vía Docker Compose.
- Envío de códigos OTP para autenticación de usuarios en aplicaciones web o móviles
- Notificaciones de alertas del sistema a administradores cuando están activos
- Confirmaciones de registro o suscripción a servicios digitales
- Actualizaciones de estado de pedidos o procesos automatizados
- Recuperación de contraseñas mediante mensajes transaccionales seguros
- Rotación automática de canales para distribuir el tráfico y evitar detección por Meta
- API asíncrona que devuelve 202 Accepted inmediatamente, desacoplando al cliente de la latencia de WhatsApp
- Panel administrativo con multi-tenencia, gestión de tokens por proyecto y límites de cuota
- Persistencia de sesiones de WhatsApp Web que sobreviven a reinicios sin escanear QR nuevamente
- Detección de baneos real (códigos 401/403) para retirar canales dañados del pool automáticamente
- Gestión de silencios horarios y límites diarios por canal para mantener la salud de las cuentas
- Dependencia de Baileys, una librería no oficial que conlleva riesgo de detección por parte de Meta
- Requiere infraestructura propia (PostgreSQL y Redis) o contenedores externos para funcionar
- Configuración inicial manual de canales mediante escaneo de códigos QR en el panel
- No apto para campañas masivas de marketing, limitado a mensajes transaccionales solicitados
- La retención de datos se gestiona con particiones nocturnas que pueden requerir supervisión
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Node.js 22+, pnpm 11+ y Docker. Generar secretos (ENCRYPTION_KEY, SESSION_SECRET) con OpenSSL antes de iniciar. Ejecutar 'pnpm infra:up' para levantar PostgreSQL y Redis. Aplicar migraciones con 'pnpm db:deploy'. El worker consume la cola mientras el API maneja las peticiones HTTP. Escanear QR en el panel para activar canales.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.