# Agilize Docs para IA - Página atual Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize. Use esta versão quando a pergunta do usuário estiver restrita ao documento atual. Última geração: 2026-08-27T22:03:57.854Z ## Página - Título: Testar a qualidade de uma ligação VoIP - URL humana: https://agilize.app/docs/usuarios/transmissoes-e-telefonia/problemas-de-qualidade/testar-qualidade-ligacao-voip - Leitura completa para IA: https://agilize.app/docs/llms.txt - Descrição: Como baixar e usar o Agilize VoIP Tester no Windows ou Linux para investigar conectividade, microfone, áudio, registro SIP e NAT. ## Seções - Baixar o aplicativo para Windows - Se o navegador ou o Windows mostrar um aviso de segurança - Baixar o aplicativo para Linux - Antes de iniciar os testes - Reconhecer a tela inicial - Teste 1: qualidade da ligação e conectividade - Teste 2: qualidade do áudio, microfone e periféricos - Teste 3: áudio ou registro do ramal, SIP e NAT ## Conteúdo da página # Testar a qualidade de uma ligação VoIP O **Agilize VoIP Tester** ajuda a escolher o teste certo a partir do que você percebe na chamada. Ele pode medir a conexão, analisar o microfone ou executar testes técnicos de registro SIP, portas, RTP e NAT. Você não precisa conhecer esses termos para começar. Escolha o sintoma mais parecido com o seu caso e siga as instruções da tela. > **Importante:** problemas de VoIP podem envolver computador, headset, Windows, Wi-Fi, rede local, firewall, roteador, provedor de internet, SIP, RTP, PABX ou operadora. O aplicativo reúne evidências e indica hipóteses prováveis, mas um único teste não consegue eliminar todas as causas — principalmente quando a falha é intermitente. ## Baixar o aplicativo para Windows Arquivo esperado: `AgilizeVoipTester-Windows-x64.exe`. O aplicativo é portátil: não há um instalador com várias etapas. Depois do download, abra o arquivo para iniciar. ### Se o navegador ou o Windows mostrar um aviso de segurança O Microsoft Defender SmartScreen avalia a origem e a reputação dos arquivos baixados. Por isso, o Windows ou o Microsoft Edge pode alertar sobre um aplicativo novo ou ainda pouco baixado. Continue somente quando: - o download foi iniciado pelo link oficial deste artigo; - o nome do arquivo é `AgilizeVoipTester-Windows-x64.exe`; - o aviso informa que o aplicativo ou download não é reconhecido, e não que uma ameaça foi encontrada. --- title: "Como continuar após o aviso de reputação" caption: "Os textos podem variar um pouco conforme a versão do Windows e do navegador." definition: | flowchart LR A[Download oficial] --> B[Manter ou Continuar mesmo assim] B --> C[Abrir o arquivo] C --> D[Mais informações] D --> E[Executar assim mesmo] --- No **Microsoft Edge**, se o download for marcado como incomum: 1. Abra **Downloads** pelo ícone do navegador ou com **Ctrl + J**. 2. No arquivo do Agilize VoIP Tester, abra o menu de três pontos. 3. Escolha **Manter**. 4. Se aparecer outra confirmação, abra **Mostrar mais** e selecione **Manter mesmo assim** ou **Continuar mesmo assim**. Ao abrir o arquivo, se aparecer a tela azul **O Windows protegeu o computador**: 1. Clique em **Mais informações**. 2. Confira novamente o nome do aplicativo ou do arquivo. 3. Clique em **Executar assim mesmo**. Não desative o Microsoft Defender nem o SmartScreen para usar o aplicativo. Se o computador da empresa não mostrar a opção de continuar, a execução pode estar bloqueada por uma política corporativa; nesse caso, peça a liberação ao time de TI. > Se o aviso disser que foi encontrado vírus, malware ou outra ameaça — em vez de apenas informar que o aplicativo não é reconhecido — cancele a execução e fale com o suporte antes de continuar. ## Baixar o aplicativo para Linux Arquivo esperado: `AgilizeVoipTester-Linux-x86_64.AppImage`. O AppImage é portátil e já inclui os componentes principais do aplicativo. Ele foi preparado para computadores `x86_64` com Ubuntu 18.04 ou uma versão mais recente. Depois de baixar: 1. Abra a pasta **Downloads**. 2. Clique com o botão direito no arquivo e abra **Propriedades**. 3. Em **Permissões**, habilite a opção para executar o arquivo como programa. O nome dessa opção pode variar conforme a versão do Ubuntu. 4. Feche as propriedades e abra o AppImage com dois cliques. Se a opção visual não estiver disponível, abra o Terminal na pasta do download e execute: ```bash chmod +x AgilizeVoipTester-Linux-x86_64.AppImage ./AgilizeVoipTester-Linux-x86_64.AppImage ``` Em uma instalação sem suporte a FUSE, use: ```bash ./AgilizeVoipTester-Linux-x86_64.AppImage --appimage-extract-and-run ``` ## Antes de iniciar os testes Para o resultado ficar mais útil: - use o mesmo computador, headset e conexão em que o problema acontece; - conecte o headset antes de abrir o aplicativo; - feche outros programas que estejam usando o microfone se o Windows não liberar a captura; - mantenha a internet conectada durante todo o diagnóstico; - se o problema for intermitente, tente testar no mesmo horário ou enquanto o sintoma estiver acontecendo; - anote se o computador está no Wi-Fi, no cabo ou em uma VPN. O aplicativo prepara os testes automaticamente. Não é necessário informar usuário ou senha do seu ramal. ## Reconhecer a tela inicial Quando a indicação no canto superior direito estiver como **PRONTO**, escolha uma das três opções. ![Tela inicial do Agilize VoIP Tester com os testes de conectividade, microfone e SIP/NAT](/docs/images/usuarios/transmissoes-e-telefonia/voip-tester-tela-inicial.png) | O que está acontecendo? | Teste mais indicado | | --- | --- | | A chamada tem picotes, voz metalizada ou cai de forma aleatória. | **Qualidade da ligação — conectividade** | | Você ou o cliente ouve chiado ou estalos. | **Qualidade do áudio — microfone e periféricos** | | O ramal não registra, perde o registro ou a chamada fica sem áudio. | **Áudio ou registro do ramal — SIP e NAT** | Se houver mais de um sintoma, comece pelo que mais atrapalha a chamada. Depois, volte à tela inicial e execute os outros testes separadamente. ## Teste 1: qualidade da ligação e conectividade Use este teste para investigar picotes, voz metalizada, atrasos e interrupções aleatórias. 1. Na tela inicial, clique em **Qualidade da ligação — conectividade**. 2. Em **Tempo do teste**, mantenha **1 minuto** para a primeira verificação. 3. Clique em **Executar**. 4. Aguarde a medição terminar e consulte a aba **Resumo**. Durante a execução, o aplicativo mede a estabilidade entre o computador, o Servidor Agilize e destinos públicos. Ele também realiza uma chamada de teste para observar a mídia RTP e apresentar dados como latência, perda de pacotes e jitter. Se a chamada falha apenas de vez em quando, repita o teste por **3 ou 5 minutos**. Quando possível, deixe a medição ativa enquanto uma chamada real autorizada acontece em outro ramal. Isso aumenta a chance de registrar a oscilação no momento do problema. Como comparação simples, repita uma vez pelo cabo e outra pelo Wi-Fi, ou em outra rede. Uma diferença clara entre os resultados ajuda a localizar a origem da instabilidade. ## Teste 2: qualidade do áudio, microfone e periféricos Use este teste quando houver chiado, estalos, volume muito baixo ou alto, cortes na voz ou suspeita de headset com defeito. 1. Na tela inicial, clique em **Qualidade do áudio — microfone e periféricos**. 2. Confira a **Fonte de entrada de áudio**. Na maioria dos casos, mantenha **Padrão do sistema**. 3. Clique em **Executar**. 4. Na primeira etapa, clique em **Gravar silêncio** e fique em silêncio por 6 segundos. Não toque no headset, no cabo nem no controle de volume. 5. Na segunda etapa, clique em **Gravar fala** e fale normalmente por até 12 segundos, seguindo a frase sugerida na tela. 6. Aguarde a análise e consulte o **Resumo**. O áudio é processado localmente no computador. A gravação da fala pode ser ouvida no próprio aplicativo e fica disponível somente até ele ser fechado, a menos que você escolha **Salvar WAV**. O arquivo de áudio não é incluído automaticamente no relatório. Se aparecer um alerta, repita o teste com outro headset ou outra porta USB. Se o problema acompanhar o periférico, o headset, o cabo, o conector ou o ganho de entrada se tornam hipóteses mais fortes. ## Teste 3: áudio ou registro do ramal, SIP e NAT Use este teste quando o ramal não registra, perde o registro, completa a chamada sem áudio ou perde o áudio depois de alguns segundos. 1. Na tela inicial, clique em **Áudio ou registro do ramal — SIP e NAT**. 2. Marque um ou mais sintomas: - **Áudio cai depois de alguns segundos**; - **Sem áudio desde o início**; - **Ramal não registra**; - **Ramal perde o registro**. 3. Se o problema acontecer depois de algum tempo, mantenha a duração inicial sugerida ou aumente o acompanhamento para tentar reproduzi-lo. 4. Clique em **Continuar para os testes**. 5. Clique em **Executar** e aguarde. Esse diagnóstico pode levar alguns minutos. A partir dos sintomas marcados, o aplicativo seleciona automaticamente os testes necessários. Você não precisa alterar portas, STUN, SIP ALG, RTP ou NAT para fazer a primeira verificação. Esses conceitos aparecem no relatório porque ajudam o suporte técnico a separar situações diferentes, por exemplo: - o ramal não conseguiu se registrar no servidor; - a sinalização funcionou, mas o áudio RTP foi bloqueado; - o roteador mudou o mapeamento das portas; - uma faixa UDP não recebeu resposta; - o registro caiu durante a renovação; - o SIP ALG pode ter interferido nas mensagens da chamada. ## Entender o resultado sem se perder nos termos técnicos Comece sempre pela aba **Resumo**. Ela agrupa os alertas por hipótese provável e informa o que foi observado, como confirmar e o que pode ajudar a resolver. | Resultado | Como interpretar | | --- | --- | | **Aprovado** | O item funcionou durante esta execução. Uma falha intermitente ainda pode não ter aparecido. | | **Alerta** | Houve degradação ou comportamento que merece comparação e acompanhamento. | | **Falhou** | O teste encontrou uma evidência objetiva de falha naquele ponto, mas outras camadas também podem participar do problema. | | **Inconclusivo** | Não foi possível confirmar nem descartar a hipótese com segurança. Repita ou compare em outra condição. | Um resultado aprovado não significa que “a telefonia inteira está perfeita”. Ele significa que aquele caminho funcionou durante o intervalo medido. Da mesma forma, uma falha de RTP não prova sozinha se a causa está no computador, firewall, roteador, provedor ou PABX; ela mostra onde a investigação deve se concentrar. ## Compartilhar o diagnóstico com o suporte Depois que o teste terminar: 1. Clique em **Copiar resultados** para copiar a conclusão e as evidências dos testes executados. 2. Se precisar de um arquivo, clique em **Salvar PDF**. 3. Informe junto com o resultado: - data e horário aproximado do problema; - sintoma percebido; - uso de Wi-Fi, cabo ou VPN; - headset ou microfone utilizado; - se o teste ocorreu durante uma chamada real; - comparações feitas com outro headset, computador ou rede. Envie a gravação WAV apenas quando ela for necessária e quando você estiver confortável em compartilhar o conteúdo de voz. ## Quando o teste não encontra o problema Falhas intermitentes podem desaparecer antes da medição. Se o resultado estiver normal, mas o sintoma continuar: 1. aumente o teste de conectividade para 3 ou 5 minutos; 2. repita durante o horário em que a falha costuma acontecer; 3. compare cabo e Wi-Fi, com e sem VPN, quando isso for permitido; 4. teste outro headset para separar rede de periférico; 5. registre o horário exato de uma chamada afetada; 6. envie os resultados ao suporte para correlação com PABX, rota, operadora e registros da chamada. Para observar filas, ramais e chamadas em tempo real, consulte também o [Monitoramento de Telefonia](/docs/usuarios/transmissoes-e-telefonia/monitoramento-de-telefonia).