waxum
Pasarela REST API unificada para WhatsApp escrita en Rust que soporta tanto el protocolo multi-dispositivo no oficial como la API Cloud oficial de Meta, consolidando más de 230 endpoints en un único binario.
Ficha actualizada 28 sept 2026, 2:12 · upstream 28 sept 2026, 1:57 · release v0.12.9
Qué es waxum
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Waxum actúa como una capa de abstracción que permite gestionar múltiples sesiones de WhatsApp desde una única instancia. Soporta dos proveedores simultáneamente: el protocolo multi-dispositivo (ideal para números personales y pequeñas empresas) y la API Cloud oficial de Meta (para negocios verificados a escala). Esto elimina la necesidad de mantener infraestructuras separadas para cada tipo de conexión.
El proyecto ofrece capacidades completas de mensajería, incluyendo envío de multimedia, ubicación, tarjetas de contacto, encuestas y respuestas con contexto. Además, gestiona llamadas de voz y video mediante codificadores nativos en Rust (MLOW) y permite transcripciones externas. La gestión de sesiones incluye autenticación QR o por código, reconexión automática y estadísticas de flota.
La arquitectura prioriza la observabilidad y la fiabilidad operativa. Incluye consola integrada, métricas Prometheus, OpenAPI 3.1, circuit breakers para webhooks y colas de mensajes no entregados (DLQ). Sin embargo, depende de librerías externas de terceros (whatsapp-rust) fijadas a revisiones específicas de Git, lo que impide su publicación en crates.io y requiere una herramienta de gestión de dependencias externa o Docker.
- Automatización de marketing masivo mediante colas de envío programado y deduplicación.
- Soporte al cliente escalable con múltiples agentes gestionados desde un único servidor.
- Integración con CRMs externos para sincronizar contactos y estados de chat en tiempo real.
- Pruebas de integración de API (Sandbox) utilizando la consola integrada y endpoints de playground.
- Gestión de flotas de WhatsApp Business mediante métricas de uptime y estadísticas por sesión.
- Binario único compilado en Rust que soporta múltiples bases de datos (SQLite, PostgreSQL, MySQL) sin reescritura.
- Compatibilidad dual nativa: protocolo multi-dispositivo y API Cloud oficial de Meta bajo las mismas rutas REST.
- Observabilidad robusta con soporte para Prometheus, Swagger UI, consola operativa integrada y eventos SSE.
- Gestión avanzada de webhooks con firmas HMAC-SHA256, circuit breakers automáticos y reinicio masivo de fallos.
- Soporte nativo para llamadas de voz y video mediante codificador MLOW propio y almacenamiento de grabaciones en S3 o disco local.
- No soporta llamadas grupales (voice calls multi-party) debido a limitaciones del motor upstream whatsapp-rust.
- El cifrado en reposo no está implementado por diseño; se requiere cifrado a nivel de sistema operativo o volumen.
- Dependencia de librerías externas fijadas a revisiones Git, lo que impide la publicación oficial en crates.io.
- Requiere Rust nightly específico (nightly-2026-04-05) para compilación desde fuente, aunque el binario Docker está disponible.
- La gestión de dependencias externas no permite actualizaciones automáticas sin intervención manual del usuario.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Para producción, se recomienda usar la imagen oficial de Docker o compilar con Rust nightly específico. Configurar base de datos PostgreSQL para más de 50 sesiones. Definir variables de entorno para autenticación (SUPERADMIN_TOKEN), almacenamiento de medios (WA_MEDIA_DIR) y webhooks. Asegurar que el límite de archivos abiertos (nofile) sea superior a 65536.
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.