Saltar al contenido
dev infrastructure Clínicas Svenson — Performance & Resilience

Critical Messaging Engine

Motor de notificaciones de alta disponibilidad con fallback inteligente WhatsApp/SMS y validación de reglas de negocio en tiempo real.

PHP 8.2MySQLSQL Server (ODBC)WhatsApp API (S1)SMS GatewayOAuth2

El Reto

Svenson requería un sistema de recordatorio de citas que garantizara la entrega bajo cualquier circunstancia, respetando estrictas regulaciones de privacidad y horarios de contacto. El sistema anterior sufría de falta de trazabilidad y no gestionaba eficientemente los fallos de entrega en el canal principal.

Objetivo: Desarrollar un "Orquestador de Mensajería" capaz de procesar lotes masivos de citas, validar números móviles, consultar listas negras dinámicas y ejecutar un fallback a SMS en milisegundos si WhatsApp no estaba disponible.

La Solución

Diseñé un motor en PHP enfocado en la resiliencia y la auditabilidad. La arquitectura se basa en un ciclo de vida de procesamiento por lotes con validaciones granulares en cada etapa.

Arquitectura de Resiliencia

  • Validación de Negocio Avanzada: Implementación de filtros de seguridad que descartan números erróneos, fijos o en listas negras dinámicas mediante conexiones persistentes para minimizar la latencia.
  • Estrategia de Fallback Inteligente: Secuencia automatizada donde el sistema intenta el envío vía WhatsApp y, ante cualquier código de error o falta de opt-in, conmuta instantáneamente al canal SMS con normalización de caracteres GSM.
  • Persistencia y Arquitectura de Datos: Diseño de un esquema relacional optimizado que centraliza el control de envíos. Cada transacción gestiona de forma atómica los estados de entrega de ambos canales (IDs de mensaje, códigos de resultado y timestamps de sincronización), permitiendo un sistema anti-duplicidad de alta precisión basado en estados transaccionales.
  • Lógica de Reintentos Automáticos: Implementación de políticas de reintento (exponential backoff) para llamadas críticas a la API de SvensonNet, asegurando la sincronización de citas incluso ante inestabilidades temporales de red.
  • Control Horario Estricto: Ventana de ejecución protegida para evitar envíos en horarios intempestivos, cumpliendo con la normativa vigente y mejorando la satisfacción del cliente.
🛡️

SQL Protection

Escapado integral de variables y uso de servicios de base de datos desacoplados para prevenir inyecciones.

🔄

Auto-Retry Engine

Lógica de 3 niveles de reintento para autenticación y descarga de lotes de citas vía API SvensonNet.

📊

Unified Auditing

Sistema de trazabilidad en SQL que registra cada intento, canal utilizado y motivo de descarte para auditoría total.

📱

Phone Validator

Microservicio interno para limpieza y validación Regex de telefonía móvil española (6xx/7xx).

Resultados

El sistema se consolidó como la columna vertebral de comunicación de citas de la compañía, operando con una tasa de error técnico inferior al 0.5% y una trazabilidad del 100%.

  • Reducción significativa del absentismo gracias al sistema de doble canal (WhatsApp + SMS).
  • Eliminación de molestias a clientes por duplicidad de mensajes mediante el sistema de verificación de estado integrado en base de datos.
  • Arquitectura 100% auditable: Los reclutadores y auditores de negocio pueden verificar el estado de entrega y los logs de ejecución de cada lote en tiempo real.
  • Gestión eficiente de lotes: Procesamiento optimizado capaz de manejar miles de citas diarias sin degradación del rendimiento del servidor.