Todos los artículos
    OTPObservabilityMetrics

    Métricas de OTP que revelan fallos de entrega y verificación

    Modelo de medición de OTP: verificación completada, reenvíos, distribuciones de latencia, desglose por ruta, razones canónicas de fallo y alertas desde tu propia línea base.

    Flowstates Team·Operaciones de mensajería al cliente12 de febrero de 2026 · 7 min de lectura

    La tasa de entrega responde a la pregunta equivocada

    Un DLR describe lo que la red reportó del mensaje. La pregunta del negocio es otra: ¿completó el usuario la verificación mientras seguía en el flujo? Ambos números pueden moverse en direcciones opuestas y solo el segundo es un resultado.

    Este modelo no contiene valores objetivo. Cada umbral que merece alerta sale del histórico reciente del propio programa, por ruta y destino.

    Métricas de resultado

    • Verificación completada sobre las sesiones en que se emitió un código.
    • Completado en el primer intento y comportamiento de reenvío: el reenvío suele subir antes de que caiga el completado.
    • Emisión duplicada: sesiones con más de un código válido, o códigos superados que el usuario introduce.
    • Códigos caducados o desordenados: apuntan a latencia, no a los usuarios.
    • Bucles de reintento: sesiones con múltiples solicitudes sin completar y abandonos.

    Distribuciones de latencia

    1. Emisión a aceptación: tu stack más la ingestión del proveedor.
    2. Envío a estado final: proveedor, red de destino y operador.
    3. Emisión a verificación: incluye al usuario y determina si tu expiración es realista.

    Compara la tercera distribución con la expiración configurada y con tu política de seguridad, en lugar de heredar un valor por defecto. Lo mismo define el plazo útil tras el cual otro intento ya no ayuda.

    Desgloses que localizan el problema

    Proveedor y ruta, país y operador, identidad de remitente y plantilla, plataforma y versión de app, clase de tráfico y recorrido, hora del día. Vigila la brecha entre entrega reportada y verificación por ruta, y separa errores de aplicación de errores de usuario en el endpoint de verificación.

    Razones canónicas de fallo

    Agrupa los códigos de proveedor por responsable: aplicación, política, proveedor, red de destino, destinatario y desconocido. Conserva el estado y código brutos junto al canónico.

    Coste y abuso

    Coste por verificación exitosa, no por mensaje. Vigila velocidad de solicitudes por número, cuenta y red, concentraciones hacia destinos inusuales o caros, y solicitudes que nunca acaban en verificación.

    Correlacionar sin registrar el código

    Se unen cinco tipos de registro: sesión de autenticación, emisión, intentos de mensaje, estados y resultado de verificación, mediante un identificador de correlación creado al decidir emitir. El código nunca forma parte de ese rastro: guarda solo lo necesario para validarlo.

    Esquema de medición

    auth_session, otp_issuance, message_attempt, message_status, verification

    Con esos cinco registros —y ningún valor de código— se derivan todas las métricas anteriores.

    Tabla de diagnóstico

    ObservaciónCausa probablePrimera comprobación
    Entrega alta y verificación baja en una rutaEntrega tardía o contenido poco fiableDistribución de envío a estado final y de emisión a verificación
    Suben reenvíos, completado estableMensajes tardíos dentro de la ventanaCola de la distribución por operador
    Suben reenvíos y baja completado en un paísFiltrado o problema de registroRazones de red de destino y estado del registro
    Suben intentos con código caducadoExpiración corta o más latenciaEmisión a verificación frente a la expiración
    Suben intentos con código superadoVarios códigos válidos por sesiónEmisiones por sesión; deduplicación por sesión
    Fallos con códigos válidos y a tiempoDefecto de aplicaciónTipos de fallo por versión de app
    Faltan estados finales en una rutaReporte incompleto del proveedorProporción sin estado final por proveedor
    Sube el coste por verificaciónReenvíos o abusoSolicitudes por verificación completada

    Alertas

    Alerta por desviación frente a la línea base del propio programa en esa ruta y destino. Cada alerta necesita responsable y acción: escalar al proveedor, cambiar de ruta, pausar una campaña o abrir un defecto.

    ¿Quieres revisar tu stack de mensajería?

    Reserva una revisión de 30 minutos con nuestro equipo. Sin presentación comercial: revisamos tu setup y te señalamos dónde está el riesgo operativo.