Inspecionador de Voz

Inspecionador de Voz é uma ferramenta criada para ajudar você a entender o que aconteceu durante as chamadas. Com o Voice Inspector, você pode acessar informações sobre uma chamada específica, incluindo:

• Estatísticas gerais
• Status da última chamada
• Lista dos NCCOs utilizados, juntamente com seu status
• Todos os eventos que ocorreram durante uma ligação
• Métricas de qualidade

Visão geral do Voice Inspector

O Voice Inspector é composto por duas seções principais: uma Página de pesquisa e um Página de informações sobre a chamada.

Página de pesquisa

É possível encontrar informações sobre um trecho de chamada pesquisando por um número de telefone “Para” ou “De”, pelo ID do trecho de chamada ou pelo ID da conversa. Os IDs dos trechos de chamada (uuid) e IDs de conversação (conversation_uuid) pode ser encontrado no callbacks. Somente as chamadas feitas nos últimos 21 dias podem ser localizadas pelo Voice Inspector.

A pesquisa por números de telefone permite apenas localizar chamadas PSTN, enquanto a pesquisa por ID de conversa ou ID de trecho de chamada permite localizar chamadas dentro do aplicativo, chamadas PSTN/SIP e trechos de WebSocket.

O seletor de fuso horário permite especificar um intervalo de datas no fuso horário de sua preferência.

A pesquisa pelo ID do trecho da chamada levará diretamente ao Página de informações sobre chamadas exibindo dados e métricas referentes a esse ID específico de trecho de chamada.

A pesquisa por ID de conversa exibirá um componente “Resumo da conversa”, juntamente com uma lista de trechos de chamada associados a esse ID de conversa.

A lista de etapas da chamada mostra:

• ID da chamada
• Horários de início e término da parte da opção de compra, juntamente com a duração
• O status final da etapa da chamada
• Preço da ligação

Página de informações sobre chamadas

O Página de informações sobre chamadas fornece informações detalhadas relevantes para uma etapa específica da chamada e é composto por várias seções, conforme descrito a seguir:

• Resumo da chamada
• NCCO
• Webhooks
• Métricas de qualidade

Resumo da chamada

Na parte superior da página está a seção “Resumo da chamada”. Essa seção oferece uma visão geral do que ocorreu durante a chamada. Ela é útil para compreender informações gerais sobre a chamada, incluindo o canal, o status, os horários de início e término, além da duração da chamada. Essas informações ajudam a verificar se você está analisando a chamada correta durante a depuração.

O Índice de Qualidade (QI) também oferece uma visão rápida da qualidade percebida durante a chamada — esse recurso está disponível apenas para chamadas de In-App Voice e chamadas WebRTC. As chamadas de voz (SIP/PSTN) exibirão uma pontuação do Índice MOS, um indicador semelhante da qualidade percebida durante a chamada; já as chamadas via WebSocket não apresentam dados de qualidade.

NCCO

A seção da NCCO apresenta Objetos de controle de chamadas processados durante a ligação.

Webhooks

A seção “Webhooks” exibe “Resposta” e “Evento” Webhooks enviado da plataforma da Vonage para o seu aplicativo:

• Método – Método HTTP utilizado (por exemplo, GET, POST)
• URL – Ponto de destino
• Código de status – resposta HTTP (por exemplo, 200 OK)
• Latência – Tempo de resposta em milissegundos
• Tentativas – Número de tentativas de entrega

Ao clicar em uma linha de webhook, a entrada é expandida para mostrar todos os detalhes da carga útil da solicitação.

Métricas de qualidade

A seção “Métricas de Qualidade” é útil para compreender a taxa de bits, o jitter, a perda de pacotes e a latência ao longo do tempo para o trecho da chamada. Embora essas estatísticas não possam determinar diretamente a qualidade subjetiva percebida durante a chamada, elas podem ajudar a entender o que pode ter contribuído para a baixa qualidade.

A qualidade da chamada é apresentada de uma das duas seguintes formas:

• Chamadas do tipo PSIP e PSTN: Como uma média da qualidade ao longo de toda a duração da ligação.
• Chamadas WebRTC (Client SDK): Gráficos que mostram a qualidade das chamadas em incrementos de um segundo.

As métricas de qualidade para taxa de bits, jitter e perda de pacotes são apresentadas tanto para os dados enviados quanto para os recebidos. Segue abaixo uma breve explicação sobre cada um desses Concepts:

• Índice de Qualidade (IQ) — Compatível com chamadas WebRTC. Uma medida objetiva da qualidade geral da chamada percebida pelo usuário. A escala varia de 1, que representa má qualidade de chamada, a 5, que significa excelente qualidade de chamada. A maioria das chamadas deve ter um QI entre 3 e 4. O QI é calculado com base em uma combinação das métricas de qualidade capturadas e percebidas durante a chamada.

• Pontuação Média de Opinião (MOS) - Exibido no lugar do QI para chamadas SIP/PSTN. Trata-se de outra métrica para medir a qualidade geral da voz, com valores que variam entre 1 e 5 para indicar a qualidade percebida de uma chamada de voz, sendo 1 a qualidade mais baixa e 5 a mais alta. Uma pontuação MOS inferior a 4 pode indicar problemas de qualidade da rede que podem afetar a qualidade da chamada.

• Taxa de bits - Compatível com WebRTC e chamadas de voz. A quantidade de bits (dados) enviados pela conexão do usuário. Embora a taxa de bits não possa ser diretamente associada à qualidade, uma taxa de bits mais alta geralmente está relacionada a uma melhor qualidade de chamada. Por exemplo, uma taxa de bits inferior a 64 Kbps em uma chamada PSTN pode resultar em qualidade de áudio prejudicada.

• Jitter - Compatível com WebRTC e chamadas de voz. A inconsistência na ordem dos pacotes recebidos pelo destinatário. Um alto nível de jitter pode resultar em deterioração da qualidade da chamada e causar distorção, ecos ou áudio entrecortado. Um jitter superior a 50 ms pode resultar em conversas incoerentes.

• Perda de pacotes — Compatível com WebRTC e chamadas de voz. Os dados são enviados em unidades chamadas pacotes durante uma chamada. Em muitas situações, alguns desses pacotes se perdem durante o trânsito, o que significa que não são recebidos pelo terminal do usuário. A perda de pacotes é calculada como a porcentagem de pacotes perdidos em relação ao total de pacotes enviados. Por exemplo, se 100 pacotes forem enviados e apenas 99 forem recebidos, há uma perda de pacotes de 1%. Uma perda de pacotes superior a 1% pode resultar em palavras cortadas ou frases inteiras perdidas.

• Latência — Compatível apenas com chamadas de voz. O tempo que um pacote de dados leva para ir de um terminal a outro. Qualquer latência superior a 100 ms pode causar falhas no áudio ou sobreposição de conversas entre os participantes.