1. Objetivo e Quando Utilizar
Padronizar a coleta e a leitura de telemetria WebRTC diretamente no navegador do cliente (Google Chrome / Microsoft Edge) durante chamados de:
Áudio mudo (unidirecional ou bidirecional) logo ao atender.
Voz robotizada, picotando ou com atraso (delay).
Quedas repentinas de chamada após alguns segundos de conexão (timeout de RTP/ICE).
2. Coleta Rápida com o Cliente (Passo a Passo)
O analista deve instruir o cliente a realizar os passos abaixo enquanto uma chamada de teste estiver ativa (ou imediatamente antes de encerrá-la):
Abrir uma nova aba no navegador (sem fechar a aba do webphone
chat.sonax.net.brouwidget.sonax.cloud).Digitar na barra de endereços:
chrome://webrtc-internalse pressionar Enter.No topo da página, clicar no botão Create a WebRTC-Internals dump (isso baixa um arquivo
.txtcom o histórico completo para anexar ao ticket, caso precise escalar para N2/N3).Para análise ao vivo na tela (via AnyDesk/TeamViewer): localizar a aba correspondente ao webphone e clicar na última
RTCPeerConnectionlistada (a mais recente).
3. Checklist de Diagnóstico em 4 Passos
Passo 1: Estado da Conexão (ICE connection state)
Logo no topo da RTCPeerConnection selecionada, verifique a linha de evolução dos estados:
Saudável:
new => "checking" => "connected"(ou"completed").Falha de Firewall / NAT Rígido: Fica travado em
"checking"e muda para"failed"ou"disconnected".Ação: O roteador/firewall do cliente bloqueou portas UDP altas ou o cliente está atrás de NAT Simétrico sem servidor TURN configurado.
Passo 2: Rota de Mídia (ICE candidate grid)
Role até a tabela ICE candidate grid e localize a linha destacada em negrito com status succeeded. Compare o candidato local (cliente) com o remoto (servidor Asterisk):
| Tipo (Candidate type) | O que significa | Diagnóstico |
host (local) | IP privado da placa de rede (192.168.x.x). | Só fecha se estiver na mesma rede local do PABX. |
srflx (local) | IP público descoberto via servidor STUN. | Cenário ideal para clientes atrás de NAT doméstico/empresarial padrão. |
prflx (local) | IP público descoberto dinamicamente durante a troca de pacotes. | Comum em redes com Dual-WAN / Balanceamento de Link. Funciona, mas exige atenção se houver troca de rota no meio da chamada. |
relay (local) | Tráfego encapsulado via servidor TURN. | Usado quando UDP direto é bloqueado pelo firewall do cliente. |
Regra de Ouro na Tabela:
Verifique as colunas
Bytes sent / received.Se
Bytes sent > 0eBytes received = 0: O cliente envia áudio, mas não recebe (bloqueio de entrada no firewall do cliente ou falha de retorno).Se
Bytes sent = 0eBytes received > 0: O cliente ouve, mas ninguém o ouve (microfone bloqueado/mutado no SO ou bloqueio de saída UDP).
Verifique
STUN requests sent / responses received: Deve haver equilíbrio (ex:98 / 97). Se houver muitos envios e zero respostas (23 / 0), o firewall está descartando os pacotes keep-alive e a chamada vai cair em ~30 segundos.
Passo 3: Qualidade do Áudio Recebido pelo Cliente (inbound-rtp)
Na seção Stats Tables, clique para expandir o item inbound-rtp (kind=audio). Ele mostra como o áudio do Asterisk está chegando no navegador do cliente:
| Métrica | Valor Saudável | Valor Crítico (Problema) | Causa Provável |
packetsLost | 0 ou < 1% de packetsReceived | Acima de 2% a 3% | Perda de pacotes na operadora do cliente ou Wi-Fi instável. |
jitter | Abaixo de 0.03 (30 ms) | Acima de 0.05 (50 ms) | Variação de latência (buffer cheio, downloads na rede, Wi-Fi congestionado). |
concealedSamples | Baixo / estável | Subindo rapidamente | O Chrome está "inventando" áudio para tapar buracos de pacotes perdidos (gera voz robotizada). |
Passo 4: Qualidade do Áudio Enviado pelo Cliente (remote-inbound-rtp)
Expanda o item remote-inbound-rtp (kind=audio). Esta tabela traz o relatório que o servidor Asterisk devolveu via RTCP informando como está recebendo a voz do agente:
roundTripTime(RTT / Latência):Ideal:
0.015sa0.080s(15 ms a 80 ms).Alerta: Acima de
0.150s(150 ms) — o cliente e o interlocutor começam a falar um por cima do outro (delay perceptível).
fractionLost:Deve estar em
0(ou< 0.01). Se estiver alto aqui, mas baixo noinbound-rtp, o problema está especificamente no Upload da internet do cliente (muito comum em planos assimétricos ou redes móveis/rádio).
4. Matriz de Decisão e Encaminhamento (N1 → N2/N3)
| Sintoma no webrtc-internals | Causa Raiz Comprovada | Ação do Suporte |
ICE state = failed ou Bytes sent/received = 0 | Bloqueio de portas UDP (10000–60000) ou NAT Simétrico no cliente. | Orientar TI do cliente a liberar UDP de saída ou testar via roteamento 4G/5G para comprovar bloqueio local. |
RTT > 0.200s ou packetsLost alto em inbound-rtp | Gargalo na internet/Wi-Fi do cliente (ou rota da operadora). | Solicitar teste no cabo de rede e rodar MTR para o IP do servidor Asterisk (189.113.7.75 ou correspondente) antes de escalar. |
Bytes sent > 0, Bytes received > 0, packetsLost = 0, mas cliente não ouve/fala | Problema físico/navegador (dispositivo de áudio errado no Chrome ou headset USB com defeito). | Conferir permissões de microfone no Chrome e dispositivo padrão no Windows/macOS. |
ICE state = connected, mas chamada cai com BYE do servidor ou sem respostas STUN | Perda de keep-alive WSS ou timeout de sessão no proxy/Asterisk. | Salvar o WebRTC-Internals dump + print do Console (F12) e escalar para N3 com o Call-ID. |
Dicas para Aplicar no Treinamento da Equipe
Simulação Prática (Roleplay): Peça para os analistas abrirem o webphone em duas máquinas, abrirem o
chrome://webrtc-internalslado a lado e realizarem uma ligação real.Teste de Estresse Controlado: Durante a ligação de treinamento, peça para um analista ativar o Network Throttling (aba Network do DevTools
F12→ simular Slow 3G ou perda de pacotes) por 10 segundos para a equipe visualizar na hora o gráfico dejitter,packetsLosteconcealedSamplesdisparando.Padrão de Abertura de Chamado para N3: Tornar obrigatório anexar o arquivo
.txtgerado pelo botão Create a WebRTC-Internals dump sempre que o ticket envolver reclamação de qualidade de áudio sem falha aparente no MTR.
CENÁRIOS DE VALIDAÇÕES:
Cenário 1: Bloqueio de Firewall ou NAT Simétrico Rígido (Áudio Mudo / Falha no ICE)
Quando usar: ICE connection state vai para failed ou Bytes received = 0 / STUN responses = 0.
Assunto: Diagnóstico Técnico Webfone Sonax – Liberação de Tráfego UDP/WebRTC no Firewall
Olá, [Nome do Responsável de TI], tudo bem?
Realizamos uma análise de telemetria WebRTC (
webrtc-internals) diretamente na estação de trabalho do usuário [Nome do Agente] durante uma chamada de teste e identificamos que a sinalização SIP está conectando normalmente, porém o fluxo de mídia (áudio RTP) está sendo bloqueado ou descartado pelo firewall/roteador da rede local.Evidências coletadas na estação:
Estado ICE: Falha na negociação de rota de mídia (
ICE state: failed/ sem retorno de pacotes STUN).Tráfego de Mídia: Envio iniciado pela estação, mas sem retorno de pacotes UDP externos (
Bytes received: 0).Ação necessária na rede/firewall:Para que o áudio trafegue nos dois sentidos sem bloqueios, solicitamos a liberação das seguintes regras de saída (e retorno relacionado) na política de firewall:
Protocolo UDP (Portas altas): Liberar tráfego UDP de saída na faixa
10000a60000para os servidores de mídia da Sonax (ex.: IP189.113.7.75ou sub-rede informada no escopo de implantação).Protocolo STUN (UDP): Liberar saída na porta
19302(UDP) e3478(UDP/TCP) para descoberta de NAT.SIP ALG / Inspeção de Pacotes: Caso o firewall possua o recurso SIP ALG ou inspeção profunda de pacotes (DPI) ativa para VoIP/UDP, recomendamos desativá-lo, pois ele costuma corromper os cabeçalhos de mídia WebRTC.
NAT Estático / Simétrico: Caso a rede utilize balanceamento de múltiplos links (Dual-WAN), garantir persistência de sessão (sticky session) para que a sinalização WSS (
porta 443 TCP) e o áudio (UDP) saiam pelo mesmo IP público durante a chamada.Assim que a regra for aplicada, ficamos à disposição para realizar um novo teste rápido de validação com a equipe.
Cenário 2: Perda de Pacotes e Jitter Elevado na Rede Local ou Wi-Fi (Voz Robotizada / Picotando)
Quando usar: packetsLost acima de 2%, jitter maior que 50 ms (0.05s) ou concealedSamples elevado no inbound-rtp.
Assunto: Diagnóstico de Qualidade de Áudio – Oscilação de Rede Local / Perda de Pacotes
Olá, [Nome do Responsável de TI],
Analisamos a telemetria de mídia (
webrtc-internals) de uma chamada realizada pelo usuário [Nome do Agente] para identificar a causa das falhas/picotes no áudio. A conexão com os servidores da Sonax foi estabelecida corretamente, mas os indicadores apontam degradação de transporte na rede de acesso da estação:Indicadores registrados na chamada:
Perda de Pacotes (
packetsLost): [X]% (o limite recomendado para voz em tempo real é inferior a 1%).Variação de Latência (
jitter): [X] ms (acima do patamar ideal de 30 ms, forçando o navegador a sintetizar amostras de áudio e gerando efeito "robotizado").Latência Média (RTT): [X] ms.
Recomendações para estabilização:
Conexão Cabeada vs. Wi-Fi: Caso o computador esteja conectado via Wi-Fi, recomendamos testar via cabo de rede (Ethernet), pois interferências e retransmissões sem fio afetam diretamente o tráfego RTP em tempo real.
Priorização de Tráfego (QoS): Verificar se há consumo intenso de banda simultâneo (downloads, backups em nuvem, atualizações do Windows ou streaming) saturando o link e aplicar priorização de tráfego (QoS) para pacotes UDP/WebRTC.
Teste de Rota (MTR): Caso o problema persista no cabo, pedimos a gentileza de rodar um teste de MTR (ou WinMTR) a partir dessa estação apontando para o IP [IP do Servidor Asterisk, ex.: 189.113.7.75] por 2 minutos para verificarmos se a perda ocorre no roteador interno ou na operadora de internet.
Seguimos à disposição para analisar os resultados junto com vocês.
Cenário 3: Gargalo Exclusivo de Upload na Internet do Cliente (Cliente Ouve Bem, mas Não é Ouvido / Voz Cortando para o Destino)
Quando usar: inbound-rtp está limpo, mas remote-inbound-rtp mostra fractionLost alto ou roundTripTime elevado.
Assunto: Diagnóstico de Áudio Webfone – Perda de Pacotes no Upload da Rede
Olá, [Nome do Responsável de TI],
Durante a auditoria técnica de uma chamada do usuário [Nome do Agente], verificamos através dos relatórios RTCP (
remote-inbound-rtp) que o áudio enviado pela nossa plataforma chega perfeitamente ao computador do agente, porém o áudio enviado da estação para fora está sofrendo perda de pacotes no caminho de subida (upload).Resumo técnico:
Download (Recebimento na estação): Estável, sem perdas.
Upload (Envio da estação): Perda de [X]% dos pacotes de voz antes de alcançarem nosso servidor (
189.113.7.75), fazendo com que o cliente final ouça a voz do agente cortada ou com atraso.Pontos de verificação sugeridos:
Verificar se a taxa de upload do link de internet está saturada ou sofrendo packet shaping pelo provedor.
Validar se há firewalls, proxies transparentes ou antivírus corporativos inspecionando pacotes UDP de saída na estação.
Se possível, realizar um teste rápido roteando uma conexão 4G/5G na máquina apenas para isolar se o gargalo está no link principal da empresa.
Estamos à disposição para validar assim que realizarem a verificação.
Cenário 4: Mensagem Curta para WhatsApp / Chat (Contato Direto com o TI)
Quando usar: Atendimento ágil via WhatsApp ou chat de suporte onde um texto longo não é prático.
Olá [Nome]! Fizemos um diagnóstico técnico (
webrtc-internals) aqui na máquina do [Nome do Agente] e identificamos o motivo do problema no áudio:[Escolha a opção correspondente]
Opção Bloqueio: O webphone registra normalmente, mas o firewall/roteador da rede está bloqueando o retorno dos pacotes de áudio UDP (
ICE failed/Bytes received: 0). Precisamos que liberem saída UDP portas 10000 a 60000 para o IP189.113.7.75(e porta 19302 UDP para STUN), além de desativar o SIP ALG no roteador, se estiver ativo.Opção Perda/Jitter: A conexão fecha, mas está ocorrendo [X]% de perda de pacotes e jitter de [X] ms na rede local/link de internet, o que deixa a voz picotando. Se ele estiver no Wi-Fi, consegue testar no cabo de rede ou verificar se há algo consumindo a banda da rede?
Assim que validarem por aí, me avisa que já testamos uma ligação juntos!