Skip to content
leoco/dev
← Volver a proyectos
Backend (integraciones y arquitectura modular)·2026·Repo privado

Whatbox Cloud

Plataforma de mensajería multi-canal donde el núcleo del producto vive en un handler de webhooks unificado que normaliza payloads heterogéneos de WhatsApp, Instagram y Messenger a un modelo interno único, con detección de mensajes 'echo' (enviados desde la app móvil) para no duplicar lógica de UI. La arquitectura modular (cada feature como paquete independiente con sus propias rutas, modelos y migraciones) permite empaquetar subconjuntos de módulos como productos vendibles por separado. El multi-tenancy se aplica de forma consistente por company_id, con límites de uso (mensajes, contactos, campañas) evaluados en cada request contra el plan contratado.

Disponible bajo NDA · puedo hacer un walkthrough en una llamada.
STACK TÉCNICO
LaravelPHPModular architectureMeta Graph APIOpenAI
DESAFÍOS

Condiciones de carrera al crear contactos

Mensajes concurrentes del mismo contacto podían crear duplicados. Solución: lockForUpdate() combinado con double-check locking en findOrCreateContact antes de insertar.

Normalizar tres proveedores heterogéneos

WhatsApp, Instagram y Messenger envían webhooks con estructuras completamente distintas. Solución: un MetaWebhookHandler central que despacha según el campo 'object' del payload y traduce todo a un modelo interno común (Contact, Message, SocialNotification).

SOLUCIONES

Arquitectura modular empaquetable

Más de 40 módulos independientes (namespace, rutas, modelos y migraciones propios) que pueden combinarse y empaquetarse selectivamente para distribución como productos separados, sin tocar el núcleo de la aplicación.

Gating de planes en tiempo real

Un middleware de negocio calcula el consumo mensual/anual de mensajes, campañas y contactos por empresa contra los límites del plan contratado, bloqueando o redirigiendo antes de que la request llegue al controller.

¿Te interesa este proyecto o tienes una idea similar?