Inspector de voz
Inspector de voz es una herramienta creada para ayudarte a entender lo que ha ocurrido durante las llamadas. Con el Inspector de voz, puedes acceder a información sobre una llamada concreta, como:
- Estadísticas generales
- Estado de la última llamada
- Lista de NCCO utilizados junto con su estado
- Todos los eventos ocurridos durante una llamada
- Métricas de calidad
Visión general del inspector de voz
Voice Inspector se compone de dos secciones principales: una Página de búsqueda y un Página de información sobre llamadas.
También puedes acceder a la página de información de una llamada concreta desde los registros de voz, haciendo clic en el ID de la llamada en la lista de llamadas:

Página de búsqueda

Se puede encontrar información sobre un tramo de llamada buscando un número de teléfono "Para" o "Desde", un ID de tramo de llamada o un ID de conversación. Los identificadores de tramos de llamada (uuid) y los identificadores de conversación (conversation_uuid) se puede encontrar en el funciones de devolución de llamada. Sólo las llamadas realizadas en los últimos 21 días pueden encontrarse a través del Inspector de Voz.
La búsqueda mediante números de teléfono sólo permite buscar llamadas RTC, mientras que la búsqueda mediante ID de conversación o ID de tramo de llamada permite buscar llamadas dentro de la aplicación, llamadas RTC/SIP y tramos WebSocket.
El selector de zona horaria permite especificar el intervalo de fechas en la zona horaria preferida.
La búsqueda por ID de tramo de llamada conducirá directamente al Página de información de llamadas que muestra los datos y las métricas correspondientes a ese ID de tramo de llamada concreto.
Si realizas la búsqueda utilizando un número de teléfono, este debe tener un formato concreto:
-
A partir de Numbers - se permite la introducción de números alfanuméricos:
(/^[a-zA-Z0-9-_ ]{1,20}$/) -
Al número – Solo se admiten valores numéricos:
(/^\+?[0-9]{1,19}$/)
La búsqueda por ID de conversación devolverá un componente Resumen de conversación junto con una lista de los tramos de llamada pertenecientes a ese ID de conversación.

Se muestra la lista de tramos de llamada:
- ID de tramo de llamada
- Horas de inicio y fin del tramo de llamada, junto con el duración
- El estado final del tramo de la llamada
- Precio de la convocatoria
Página de información de llamadas
El Página de información de llamadas proporciona información detallada relativa a un tramo de llamada específico y se compone de varias secciones, como se indica a continuación:
- Resumen de la convocatoria
- OCN
- Webhooks
- Métricas de calidad
Resumen de la convocatoria

En la parte superior de la página se encuentra la sección Resumen de la llamada. Esta sección proporciona una visión general de alto nivel de lo que ocurrió durante la llamada. Esta sección es útil para comprender la información general sobre la llamada, incluido el canal de llamada, el estado, las horas de inicio y finalización junto con la duración de la llamada. Esta información ayuda a verificar que se está viendo la llamada correcta cuando se depura.
El Índice de Calidad (QI) también ofrece una visión general de la calidad percibida durante la llamada; esta función solo está disponible para llamadas de voz In-App Voice y llamadas WebRTC. Las llamadas de voz (SIP/PSTN) mostrarán una puntuación del índice MOS, un indicador similar de la calidad percibida durante la llamada; y las llamadas WebSocket no disponen de datos de calidad.
OCN
La sección NCCO muestra Objetos de control de llamadas procesados durante la llamada.
NCCO sólo se muestra para el tramo de llamada unido primero a la conversación; para los tramos creados con conectar acción, esta sección estará vacía, ya que NCCO se procesa a nivel de conversación.

Webhooks

La sección «Webhooks» muestra «Respuesta» y «Evento» Webhooks enviados desde la plataforma de Vonage a tu aplicación:
- Método - Método HTTP utilizado (por ejemplo, GET, POST)
- URL - Punto final de destino
- Código de estado: respuesta HTTP (p. ej., 200 OK)
- Latencia - Tiempo de respuesta en milisegundos
- Intentos - Número de intentos de entrega
Al hacer clic en una fila de webhook, se amplía la entrada para mostrar todos los detalles de la carga útil de la solicitud.

Métricas de calidad
La sección «Métricas de calidad» resulta útil para comprender la tasa de bits, la fluctuación, la pérdida de paquetes y la latencia a lo largo del tiempo en el tramo de la llamada. Aunque estas estadísticas no permiten determinar directamente la calidad subjetiva percibida durante la llamada, sí pueden ayudar a comprender qué factores pueden haber contribuido a una calidad deficiente.
La calidad de la llamada se presenta de dos maneras:
- Llamadas de tipo PSIP y RTC: Como calidad media a lo largo de toda la llamada.
- Llamadas WebRTC (Client SDK): Como gráficos de calidad que muestran la calidad de llamada experimentada en incrementos de un segundo.
Se presentan los indicadores de calidad relativos a la velocidad de transmisión, la fluctuación y la pérdida de paquetes, tanto en el caso de los datos enviados como en el de los recibidos. A continuación se ofrece una breve explicación de cada uno de estos conceptos:
- Índice de calidad (IC) — Compatible con llamadas WebRTC. Una medida objetiva de la calidad general de la llamada percibida por el usuario. La escala va del 1, que representa una mala calidad de llamada, al 5, que significa una calidad excelente. La mayoría de las llamadas deberían tener un QI comprendido entre 3 y 4. El QI se calcula a partir de una combinación de los parámetros de calidad registrados y percibidos durante la llamada.

- Puntuación media de opinión (MOS) - Se muestra en lugar de QI para llamadas SIP/PSTN. Es otra métrica para medir la calidad general de la voz, y oscila entre 1 y 5 para mostrar la calidad percibida de una llamada de voz, siendo 1 la calidad más baja y 5 la más alta. Una puntuación MOS inferior a 4 puede indicar problemas de calidad de la red que pueden afectar a la calidad de la llamada.

- Bitrate - Compatible con WebRTC y llamadas de voz. La cantidad de bits (datos) que se envían a través de la conexión del usuario. Aunque la velocidad de transmisión no puede vincularse directamente a la calidad, una velocidad de transmisión más alta suele ir acompañada de una mayor calidad de llamada. Por ejemplo, una velocidad de transmisión inferior a 64 Kbps en una llamada PSTN puede provocar una degradación de la calidad del audio.

- Fluctuación - Se admite para llamadas WebRTC y de voz. Incoherencia en el orden de los paquetes recibidos por el destinatario. Un alto nivel de jitter podría resultar en una calidad de llamada degradada y causar distorsión, ecos o audio entrecortado. Un jitter superior a 50 ms puede dar lugar a conversaciones incoherentes.

- Pérdida de paquetes — Compatible con WebRTC y llamadas de voz. Durante una llamada, los datos se envían en unidades denominadas «paquetes». En muchas ocasiones, algunos de estos paquetes se pierden durante la transmisión, lo que significa que el terminal del usuario no los recibe. La pérdida de paquetes se calcula como el porcentaje de paquetes perdidos respecto al total de paquetes enviados. Por ejemplo, si se envían 100 paquetes y solo se reciben 99, la pérdida de paquetes es del 1 %. Una pérdida de paquetes superior al 1 % podría provocar que se corten palabras o que se pierdan frases enteras.

- Latencia - Sólo se admite para llamadas de voz. El tiempo que tarda un paquete de datos en llegar de un extremo a otro. Cualquier latencia superior a 100 ms puede provocar interrupciones de audio o solapamiento de conversaciones entre los participantes.
