Monitorizar los registros de producción de SMS: guía técnica con ejemplos de código para desarrolladores en Marruecos.
Si no monitoreas tus registros de producción, descubrirás que una campaña ha fracasado sólo cuando tus clientes llamen al soporte en masa. Aquí están los principios de observabilidad técnica (SRE) para aplicar a tus flujos de envío API SMS.
No solo verifique el número total de mensajes enviados. Debe extraer las relaciones clave (KPIs) de sus Webhooks DLR.
1. Tasa de entrega global: Es el porcentaje de mensajes que reciben el estatus 'Delivered' dividido por el total de mensajes aceptados por la API. - Benchmark saludable: > 92%. - Acción: Si cae por debajo del 85%, a menudo es un problema de calidad de su base de datos (números inactivos) o de un filtro activo por parte del operador.
2. La tasa de error (Hard Bounce Rate): Porcentaje de SMS que devuelven un Failed o Rejected. - Benchmark sano: < 5%. - Acción: Limpiar obligatoriamente los números Failed (inválidos) de su CRM. Conservarlos destruye el Trust Score de su ID de remitente.
3. La Latencia (Time-to-Deliver): Vital para los SMS de autenticación (OTP). Este es el tiempo entre su llamada HTTP 200 OK y la recepción del Webhook Delivered. - Benchmark: siga este plazo por operador y a lo largo del tiempo; un aumento brusco indica un problema de ruta. - Acción: Si el plazo crece hasta el punto de que sus usuarios abandonan el formulario de registro, implemente un fallback (ex: WhatsApp OTP).
Sus desarrolladores no deben pasar su tiempo en los dashboards. Estos son los algoritmos que deben dar la alerta.
Cree un script CRON que revise sus registros de envío cada 15 minutos. Define "Tresholds": - Alerta Orange: Si la tasa de 'Rejected' en los últimos 5 minutos supera el 10%, envíe un mensaje Slack/Teams al marketing para comprobar el contenido de la campaña (palabras prohibidas). - Alerta Roja: Si la API EnviarSMS devuelve 5 errores 'HTTP 503' o 'HTTP 401' consecutivos, envíe un SMS de emergencia al DevOps de inicio y haz clic automáticamente en un proveedor de rescate (Failover).
El enfoque "Pequeño Equipo" (Google Sheets): No necesita una infraestructura compleja. Cree un Google Sheet. Conecte su webhook de recepción a través de una herramienta como Zapier o Make.com, y simplemente incremente columnas (Data, Operador, Estado). Un simple gráfico cruzado dinámico le dará la salud de sus envíos por operador marroquí día a día.
El enfoque "Tech Mature" (Grafana / ELK): Desliza todos los eventos Webhooks en Elasticsearch o Prometheus. Cree un dashboard Grafana con: - Una medición de la tasa de entrega (verde / naranja / rojo). - Un gráfico cronológico (Time Series) que superpone los envíos IAM, naranja e inwi. Un agujero en la curva IAM le indicará inmediatamente un Sender ID desactivado específicamente para ese operador.
Un incidente de enrutamiento inevitablemente ocurrirá (mantenimiento del operador local, cable submarino cortado, error de aplicación).La calidad de un equipo técnico se mide por su "Post-Mortem" (Análisis por incidente).
Rutas locales hacia IAM, Orange e Inwi, con conmutación automática entre rutas y estado de entrega enviado por webhook.
WhatsApp Business API desde 0,65 MAD por mensaje. El mejor retorno de inversión.
Alojamiento que cumple con las regulaciones de protección de datos personales locales.
