Métricas de voz
La página Metrics en el panel de Bird agrega los tramos de llamada que tu espacio de trabajo realizó y recibió: cuántos conectaron, cuánto duraron, cómo terminaron y adónde fueron. Úsala para informes de llamadas en un periodo. Para seguir una llamada concreta, abre el registro de llamadas.
Una llamada puede contener varios legs, como las conexiones creadas al reenviarla o marcar a otro participante. Cada leg se cuenta por separado en estas métricas.
Un tramo se contabiliza en el momento en que comenzó y se agrega cuando termina, así que el intervalo más reciente se sigue llenando mientras haya llamadas activas. La página requiere permisos de lectura de voz y de analíticas en tu rol del espacio de trabajo.
Consulta tus métricas
Abre Voice > Metrics. Cuatro pestañas comparten un selector de rango y una fila de filtros: Overview, Call quality, Numbers and routing y Traffic patterns. Cambiar de pestaña conserva tu rango y tus filtros.
El selector de rango ofrece las últimas 24 horas o 7, 30 o 90 días, y empieza en 7 días. Los rangos en días agrupan por tu día calendario local; el rango de 24 horas es una ventana móvil de 24 intervalos horarios. Arrastrar sobre un gráfico temporal reduce todas las tarjetas de la página a ese tramo.
Se combinan cuatro filtros: Tu número (tu extremo del leg), Destino (el país de destino del leg), Trunk SIP y Resultado. Cada filtro aplicado tiene una etiqueta que puedes quitar, y la mayoría de las tarjetas incluyen un control que aplica el filtro de la fila que estás consultando.
Tasa de respuesta y duración de llamada
La pestaña Overview comienza con cinco mosaicos. Los primeros cuatro muestran el cambio respecto a la ventana anterior de igual duración:
- Answer-seizure ratio: tramos respondidos divididos entre cada intento en el rango. Los intentos que terminaron sin respuesta permanecen en el denominador, así que el ASR baja tanto cuando una ruta deja de completar como cuando los números que marcas no contestan. Su cambio es una diferencia en puntos porcentuales.
- Duración media de llamada: la duración facturable media de los legs respondidos. Se excluyen los legs no respondidos, por lo que ACD no indica con qué frecuencia se establece la conexión. Unos pocos legs muy largos elevan la media por encima de la mediana; la distribución de duraciones en la pestaña Calidad de llamada muestra esa dispersión.
- Total de legs y Legs respondidos: los dos recuentos con los que se calcula ASR.
- Números distintos: cuántos números diferentes estuvieron en el otro extremo, contando cada uno una sola vez aunque aparezca en varios legs. Compararlo con el total de legs permite distinguir el tráfico distribuido entre muchos participantes del tráfico concentrado en unos pocos.
Volumen de llamadas y tasa de respuesta a lo largo del tiempo
El gráfico de tendencia apila los legs respondidos y los demás legs hasta el volumen total del período en el eje izquierdo, y muestra ASR como una línea en un eje derecho del 0 al 100%. Los intervalos dependen del rango: por hora para el rango de 24 horas y por día para los demás. Leer ambas medidas juntas distingue el crecimiento del deterioro: una línea plana con barras crecientes indica más tráfico en una ruta que sigue conectando, y una línea descendente con barras estables indica una ruta que dejó de conectar. Ver todos los legs, debajo de la tarjeta, abre el registro de legs para el mismo período.
Cómo terminaron las llamadas
Un gráfico de anillo y su leyenda separan los intentos de leg del rango por resultado final, con un recuento y una proporción del total de legs para cada uno:
| Resultado | Qué significa |
|---|---|
| Answered | El leg se conectó |
| No answer | Se agotó el tiempo, lo cual no prueba que el teléfono sonó |
| Failed | Rechazada por el otro extremo o la red |
| Rejected | Declinada por el otro extremo, o rechazada por Bird |
| Unknown | No se pudo determinar el resultado |
| Other | Un resultado que esta lista aún no nombra |
Se omiten los resultados sin legs en el rango. Para averiguar por qué se produjo un rechazo, en lugar de con qué frecuencia, abre los propios legs: Llamadas rechazadas explica el motivo que Bird registra en cada uno.
Países principales
La tabla de países ordena los 10 principales países de destino por volumen de legs, y su pie indica cuántos países tuvieron actividad en el rango. El país es el destino del leg: el país al que marcaste en un leg saliente y el país de tu propio número en uno entrante.
En un rango de días, el pie también muestra la proporción de tus legs que cubre la tabla, y cada fila representa su proporción con una barra. El rango de 24 horas omite ambas: lee el desglose por días naturales locales completos, mientras que las tarjetas superiores cubren un período móvil de 24 horas. Los dos totales representan cantidades diferentes, por lo que calcular una proporción entre ellos resultaría engañoso. Cambia a 7 días o más cuando necesites la cifra de cobertura.
Cada fila muestra el recuento de legs, la división Salientes / Entrantes de ese país y su propio ASR. Un ASR por país muy inferior al de la página suele ser la primera señal de un problema de enrutamiento limitado a un destino. La división muestra un guion cuando no se pudo determinar.
Calidad de llamada
La pestaña Call quality contiene las medidas de conexión y la distribución de duración. Una medida aparece cuando Bird la midió en el rango, y una ausente significa que Bird no midió nada, lo cual es diferente de una puntuación baja:
- Ring delay, mediana y percentil 95: cuánto esperó la persona que llamó entre marcar y escuchar el tono de llamada. Una diferencia entre ambos valores indica una ruta que normalmente conecta rápido y a veces no.
- Calidad del audio: la puntuación de opinión media, la escala estándar del 1 al 5 que evalúa cómo sonó una llamada, promediada entre los legs en los que se midió. Una conexión normal obtiene más de 4. Por debajo de ese valor, filtra por un trunk o un destino para averiguar si la caída se limita a una ruta. Comprueba también los legs cortos en la misma pestaña, porque una ruta que conecta sin transmitir audio afecta a ambas medidas.
- Legs cortos: legs respondidos que terminaron en menos de 30 segundos, mostrados como proporción de los legs respondidos. En el tráfico saliente, una proporción creciente suele indicar una ruta que conecta pero no transmite audio.
Cuánto duran los legs distribuye los legs respondidos en seis bandas de duración facturable, desde menos de 30 segundos hasta 10 minutos o más, con la duración media encima. La duración facturable es el tiempo respondido, por lo que esta es la distribución que determina los cargos de voz.
Tráfico entrante y saliente
La pestaña Números y enrutamiento separa las dos direcciones que una vista combinada oculta. Las tarjetas cuentan los Legs salientes y los Legs entrantes, junto con su cambio respecto al período anterior, además de los Números activos y los Trunks activos que tuvieron tráfico. Dirección a lo largo del tiempo apila ambas direcciones por intervalo, de modo que se ve un cambio limitado al tráfico entrante que quedaría diluido en la tendencia combinada.
Debajo del gráfico, una tabla desglosa el período por tu número, el país de tu número, el trunk SIP o la dirección, con legs, legs respondidos, ASR y ACD en columnas ordenables. El país de tu número es tu propio extremo del leg, un eje diferente del país de destino de la pestaña Descripción general. Las filas de trunks muestran qué trunk está degradado; compara el ASR entre ellos en lugar de leer uno de forma aislada. Las etiquetas de números y trunks enlazan a su registro, y los resúmenes de números abren una vista paginada con búsqueda de cada número que tuvo legs.
Patrones de tráfico
La pestaña Traffic patterns perfila cuándo llegan las llamadas, en tu zona horaria local: tu día de la semana y hora más concurridos, una cuadrícula de día de la semana por hora y un perfil por hora del día. La cuadrícula y el perfil horario necesitan un rango mayor a un día, y la cuadrícula lee como máximo los últimos 30 días, así que en un rango de 90 días lo indica. El perfil por día de la semana aparece cuando el rango abarca 14 días; por debajo, cada día de la semana tiene una sola observación.
Acceso programático
Usa las operaciones de estadísticas de CLI o MCP para obtener los agregados detrás del panel. Estas operaciones de agregación aún no tienen un contrato público de HTTP ni de SDK. Para informes de HTTP o SDK, usa los registros públicos de tramos descritos a continuación para calcular tus propios agregados.
- CLI. bird voice stats summary devuelve el agregado del periodo que muestran los mosaicos, y bird voice stats daily y bird voice stats hourly devuelven las series detrás del gráfico de tendencia. Los desgloses son by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day y by-response-code, que agrupa llamadas por código SIP final y no se grafica en el panel. Los comandos aceptan la misma ventana, zona horaria y los filtros de destino, número, troncal y resultado que aplica la página, con una excepción: by-response-code acepta solo la ventana, la zona horaria y --direction, y su ventana es de días calendario en lugar de instantes, así que responde sobre una población más amplia que una página filtrada. El acceso de solo lectura que otorga un bird auth login básico es suficiente para todos ellos. Consulta la guía de Bird CLI para instalar y autenticarte.
- Agentes. El servidor de MCP expone las mismas lecturas de estadísticas como herramientas.
- Tus propios agregados. Para informes personalizados o un almacén de datos, GET /v1/voice/legs devuelve registros de tramos filtrados, y la exportación CSV del registro de tramos cubre los registros que coinciden con tus filtros actuales. Voice events envía transiciones de llamada a tu endpoint. Reconcílialos contra los registros de tramos completados porque los eventos pueden faltar o llegar desordenados.
Los números de CLI y del panel coinciden para la misma ventana cuando usan la misma zona horaria. El panel envía tu zona horaria almacenada en cada lectura; un comando sin --timezone agrupa en UTC.
Próximos pasos
| Página | Qué cubre |
|---|---|
| Registro de llamadas | Los tramos individuales detrás de estos agregados, y por qué uno fue rechazado |
| Voice events | Los eventos de llamada para consumir en tus propios informes |
| Realizar llamadas | Lo que Bird lee de un INVITE, y cómo se tarifica una llamada |
| Solución de problemas | Partir de un síntoma hasta una causa cuando una métrica se mueve en la dirección equivocada |
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 is a voice API?Explorar la funcionalidadVoiceGuía de implementaciónVoice overview
Obtener un resumen de implementación