Métricas de SMS
La página Metrics en el panel de Bird muestra cuánto tráfico de SMS llegó a los dispositivos y cómo cambia tu tasa de fallos. Esta guía explica cada valor y cuándo investigarlo.
Las métricas son la vista agregada de todo lo que envía tu espacio de trabajo. Los conteos usan una agregación aproximada de mensajes distintos, así que recurre a los registros de mensajes y facturación cuando necesites una conciliación exacta. Para el ciclo de vida de un mensaje individual (si este número lo recibió), consulta el registro de SMS y los eventos.
Lee tus métricas
Abre SMS > Metrics en el panel. El selector de rango ofrece las últimas 24 horas o 7, 30 o 90 días. Los valores se actualizan a medida que llegan los envíos y los acuses de recibo de entrega.
Las tasas usan la hora de envío de cada mensaje. Un acuse de recibo de entrega que llega hoy para un mensaje aceptado ayer cuenta en el día de ayer, junto con el propio accepted de ese mensaje. Cada rango describe, por tanto, los mensajes que enviaste en él, de principio a fin. accepted es el denominador de ambas tarjetas de tasa; es el conteo de mensajes que admitimos en el rango, y toda tasa se mide contra él.
Un rango que incluye envíos recientes puede subreportar temporalmente delivered mientras los acuses de recibo siguen llegando. El conteo se estabiliza cuando esos mensajes terminan.
Las tarjetas de resumen
La fila de tarjetas en la parte superior es tu revisión rápida de estado:
- Tasa de entrega: mensajes entregados como proporción de los aceptados. Muestra Healthy por encima del 95 %; en ese umbral o por debajo, algo está fallando en llegar a los dispositivos (números incorrectos, contenido bloqueado o problemas de enrutamiento) y el desglose de fallos indica cuál. La tarjeta también muestra el cambio respecto al periodo anterior.
- Tasa de fallos: la proporción de mensajes aceptados que terminaron undelivered, failed o expired. La tarjeta muestra tu tasa contra un límite del 5 % con una barra de progreso; alcanzarlo cambia la tarjeta a Risk. Una tasa de fallos alta sostenida suele indicar problemas de calidad de lista o de contenido.
- Aceptados: el conteo bruto de mensajes aceptados en el rango, con la cantidad entregada a los operadores (sent) y el cambio respecto al periodo anterior.
El panel usa los umbrales del 95 % y el 5 % para sus etiquetas Healthy y Risk. Una etiqueta Healthy no significa que todos los mensajes se entregaron.
Entrega a lo largo del tiempo
El gráfico de entrega traza el volumen de mensajes aceptados, entregados y fallidos a lo largo del rango para que puedas detectar tendencias y picos puntuales: una campaña problemática, una importación de lista de números que salió mal, una ruta que se degradó. La serie de failed agrupa aquí todos los resultados de no entrega (no entregados, fallidos y expirados) en una sola línea. El tamaño de intervalo sigue el rango (por hora para 24 horas, por día para ventanas más largas).
Tasa de fallos y sus causas
La página Metrics también traza la tasa de fallos por intervalo y agrupa las no entregas por causa en un histograma de resultados:
- No entregado: una no entrega no permanente. El dispositivo estaba apagado o inaccesible.
- Fallido: un fallo permanente; el mensaje no se puede entregar.
- Expirado: el operador dejó de intentar y reportó el mensaje como expirado. Bird no establece una ventana de validez propia.
- Rechazado: el mensaje fue rechazado (una verificación de política, un cobro fallido o un operador que lo rechazó) en lugar de intentado y perdido.
Cada intervalo muestra su conteo, y todos salvo rejected muestran su proporción de mensajes aceptados. Al conciliar los números: la tarjeta Tasa de fallos cuenta undelivered, failed y expired, mientras que rejected aparece en este histograma pero queda fuera del cálculo de tasa de fallos. Un mensaje rechazado fue denegado, no perdido en la entrega, por lo que se registra aparte de los fallos de entrega.
Latencia de entrega
La tabla de latencia divide los tiempos en Processing, Delivery y Total. Processing va desde la aceptación hasta la entrega al operador; Delivery va desde la entrega al operador hasta el resultado de entrega reportado; Total abarca desde la aceptación hasta ese resultado. Cada etapa incluye los percentiles p50, p95 y p99. Usa p95 y p99 para identificar un operador o destino lento. La latencia cubre toda la ventana, y un percentil sin datos muestra un guion.
Acceso programático
La API de stats expone el mismo resumen, series y desgloses que el panel. Los desgloses cubren país, operador, originador, categoría, estado, código de error y mensajes entrantes. Los valores coinciden con el panel para el mismo rango.
Para conciliación por mensaje en lugar de agregados, consume los eventos de webhook a medida que ocurren, o pagina a través de GET /v1/sms/messages.
Próximos pasos
Usa analíticas de SMS para conectar los reportes de entrega con el flujo de campaña o aplicación más amplio.
- Stats API: recupera todos los valores de esta página desde código.
- Registro de SMS: inspecciona los mensajes detrás de los agregados.
- Eventos: consume los eventos detrás de las métricas.
- Envío de SMS: revisa categorías, etiquetas, segmentos y gasto.
Recursos relacionados
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.
Comprender el conceptoWhat does a delivery receipt tell you?Seguir la ruta de aprendizajeOperate messaging reliably
Obtener un resumen de implementación