You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

Funciones avanzadas de Voice Insights

Métricas de llamadas, secuencias de eventos y acceso a la API

Los datos de Voice Insights se recopilan para cada llamada realizada en Twilio. Se incluyen paneles de control agregados y resúmenes de llamadas con cada minuto de voz realizado en Twilio, pero las métricas de alta precisión, los eventos de progreso de llamadas y la disponibilidad programática son imprescindibles para ciertas aplicaciones. Para los clientes que requieren una mayor especificidad sobre el comportamiento de las llamadas o que disponen de aplicaciones de análisis avanzadas, ofrecemos un conjunto de funciones adaptadas para realizar un monitoreo de la calidad de las llamadas compleja y altamente estricta.

Métricas

Vistas de series temporales de fluctuación, pérdida de paquetes y velocidad de paquetes para secuencias entrantes y salientes respecto a llamadas de operador móvil y de enlaces; fluctuación, pérdida de paquetes recibidos, puntuación media de la opinión, tiempo de ida y vuelta y niveles de entrada/salida de audio para llamadas del SDK de Voice: estos detalles están disponibles en la consola y a través de la API.

En algunos casos, no basta con saber que la variación de la métrica de la llamada puede haber degradado la experiencia en una llamada. Si necesitas saber con precisión cuándo se produjo la variación durante la llamada y durante cuánto tiempo, necesitas una vista de serie temporal de esos datos.

Eventos

La secuencia de eventos mostrará los eventos de progreso de llamadas de Twilio para llamadas de Programmable Voice, respuestas de señalización SIP para llamadas de enlaces y eventos de conexión de dispositivos Twilio e ICE para llamadas del SDK de Voice. Estos detalles están disponibles en la consola y a través de la API.

Los SDK de Twilio proporcionan una gran fuente de datos de llamadas en forma de eventos de depuración, error, información y advertencia. Estos eventos están disponibles para tu aplicación a través del SDK, pero enriquecer el registro de llamada de Twilio con la secuencia de eventos proporciona un contexto adicional a fin de comprender el comportamiento de las llamadas. También se proporcionan eventos de progreso de llamada, como la transición del estado de llamada sonando a llamada contestada.

API de Voice Insights

Si tu caso de uso requiere acceso programático a los datos de Voice Insights, disponemos de puntos finales de API para recuperar eventos, métricas y resúmenes posteriores a la llamada casi en tiempo real. Ingresa los datos de tus llamadas en tus propias aplicaciones y mejora tus registros de llamadas con los detalles proporcionados por Insights.

Obtén más información sobre los puntos finales de Voice Insights en estas páginas:

Precios

Las funciones avanzadas están disponibles a un precio de USD 0,0025 por minuto. Hay disponible un descuento por volumen. Comunícate con el departamento de ventas para obtener más información.

Activar las funciones avanzadas de Voice Insights a través de la API

Consulta nuestra documentación de API.

Activar las funciones avanzadas de Voice Insights en la consola

Para activar Voice Insights, inicia sesión en la consola con tu cuenta de Twilio y dirígete al área Monitor. En la sección Insights, haz clic en Call Insight Settings (Configuración de llamada de Insights). Ahora haz clic en el botón Select (Seleccionar) para activar las funciones avanzadas de Voice Insights. Las funciones avanzadas de Voice Insights ya están activadas.

Call Insights Settings.png

A fin de activar las funciones avanzadas de Voice Insights para tus subcuentas, haz clic en la pestaña Subaccounts (Subcuentas). Utiliza la lista desplegable Account Type(Tipo de cuenta) para ver todas las cuentas o solo las cuentas con las funciones avanzadas de Voice Insights activadas actualmente. La lista desplegable Filter By (Filtrar por) te permite elegir si deseas buscar por Account SID (SID de cuenta) o por nombre descriptivo de cuenta.

Call Insights Settings Subaccounts

Una vez activadas las funciones avanzadas de Voice Insights, puedes acceder a los eventos y métricas de una llamada específica desde la consola. Para ello, abre la página de registros y haz clic en la marca de tiempo de la columna Date (Fecha) de la llamada específica a la que deseas acceder. En la nueva página que se abre, puedes acceder tanto a eventos como a métricas desde la pestaña Metrics (Métricas).

Eventos

La secuencia de eventos proporciona eventos sobre cualquier transición de cambio de estado que se produzca durante una llamada, advertencias sobre el deterioro de la calidad de la red o un funcionamiento incorrecto del equipo de audio y los eventos que se generan cuando el usuario final envía los comentarios. El registro de eventos también contiene errores que se observan en los errores de conexión. Los errores de conexión se producen cuando el SDK de Twilio Voice no puede conectarse con los servidores de Twilio. Estos fallos pueden producirse debido a una degradación grave de la red o a un firewall. Hay dos vistas: Event Stream (secuencias de eventos) y Event List (lista de eventos).

En la vista de secuencias de eventos, se muestra el progreso de los eventos horizontalmente. En algunos casos en los que, por ejemplo, una llamada del SDK de Voice tiene un gran número de cambios de conexión ICE, la cantidad de eventos puede superar el que cabe en la vista horizontal, de modo que mientras todos los eventos son visibles y seleccionables en la línea de tiempo, solo una parte de los eventos tendrá títulos y marcas de tiempo visibles.

Event Stream

La vista de lista de eventos muestra todos los eventos ordenados por marca de tiempo independientemente de cuántos hay; como se ya se mencionó, las llamadas más largas realizadas con SDK de Voice o las llamadas en condiciones de red problemáticas pueden dar lugar a cientos de eventos.

Event List

Métricas

Las métricas se recopilan en las puertas de enlace de medios de Twilio y por sensores en los SDK de Voice. Recopilamos métricas cada segundo para las llamadas del SDK de Voice y cada diez segundos para las llamadas de SIP/operador móvil (estadísticas acumulativas de los diez segundos anteriores). Las líneas de umbral naranja punteadas en los gráficos indican los valores a partir de los cuales se puede percibir una caída en la calidad de la llamada. Esta línea de umbral se basa en los estándares ITU-T de calidad de VoIP.

Métricas de la puerta de enlace de Twilio

Twilio Gateway Metrics

Métricas del SDK de Voice

Las llamadas del SDK de Voice tienen métricas adicionales que representan lo que los sensores del SDK recibieron de la puerta de enlace de Twilio.

SDK Metrics

Para llamadas de enlaces SIP elásticos y SDK de Voice, puedes elegir entre varias vistas en una sola página. Para las llamadas del SDK, habrá una vista de SDK que representa lo que se envió y se informó por los sensores en el SDK de Voice, y una vista de la puerta de enlace de Twilio que muestra lo que se recibió en la periferia de medios de Twilio desde el SDK y lo que se envió al SDK desde el elemento principal/secundario. De forma similar, las llamadas de enlaces SIP elásticos tendrán dos vistas: una vista SIP/PBX que muestra lo que se envió y se recibió desde tu infraestructura SIP, y una vista de la puerta de enlace de Twilio que mostrará lo que se envió y se recibió desde la puerta de enlace del operador móvil.

Metrics View Selector

Los gráficos de métricas se pueden ampliar si deseas ver más detalles; para ello, selecciona la región del gráfico que te interese. Una vez que hayas ampliado el gráfico, puedes hacer clic en Zoom Out (Alejar) para restaurar la vista.

Zoom Out

Interpretar los gráficos de métricas

A continuación, se muestra un ejemplo de llamada del SDK de Voice con algunos problemas de transporte. Primero, veamos la vista de la puerta de enlace de Twilio.

Voice Insights Metrics Gateway View

Hay un par de cosas que vale la pena explorar aquí.

1. Fluctuación en la secuencia recibida en la puerta de enlace de Twilio desde el SDK de Voice. Aunque la fluctuación máxima nunca supera el umbral ITU-T de 30 ms (no cruza la línea naranja punteada) la fluctuación media supera nuestro umbral, por lo que la línea de fluctuación es roja.

2. Fluctuación en la secuencia enviada al SDK de Voice desde la puerta de enlace de Twilio. Casi lo inverso del primer gráfico, la fluctuación media se mantiene baja. Sin embargo, la fluctuación máxima supera el umbral de 30 ms significativamente. Ten en cuenta que la línea de fluctuación máxima permanecerá en el valor más alto hasta que se supere; por ejemplo, en la captura de pantalla anterior parece que un grupo de paquetes llegaron desordenados, por lo que el máximo se establece en 101 ms y permanece allí durante el resto de la llamada porque ese valor no se supera.

3. Pérdida de paquetes en la secuencia recibida en la puerta de enlace de Twilio desde el SDK de Voice. Podemos ver varios picos breves de pérdida de paquetes, pero el porcentaje de pérdida de paquetes nunca supera nuestro umbral, por lo que la representación gráfica permanece bajo la línea naranja punteada.

4. Tasa de paquetes incoherente en la secuencia enviada al SDK de Voice desde la puerta de enlace de Twilio.

Esta es la vista del SDK para esta misma llamada.

image2019-7-26_12-56-30.png

La vista del SDK informa lo que se recibió en los sensores del SDK desde la puerta de enlace de Twilio. Aquí podemos ver un salto en la fluctuación recibida en el SDK (ver #1) al mismo tiempo que los picos de fluctuación salientes máximos en el gráfico anterior (#2).

Para obtener más información sobre las periferias de medios de Twilio, consulta Comprender las periferias de medios de Twilio.

Calificar esta página:

¿Necesitas ayuda?

Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

        
        
        

        Gracias por tus comentarios.

        Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

        Enviando tus comentarios…
        🎉 Gracias por tus comentarios.
        Se produjo un error. Inténtalo de nuevo.

        Gracias por tus comentarios.

        thanks-feedback-gif