Discagem por clique no Windows com MicroSIP

A discagem por clique da Agilize abre o aplicativo de telefonia instalado no computador do operador usando um link do tipo sip:. No Windows, esse link precisa estar associado a um softphone, como o MicroSIP. Se essa associação estiver ausente, quebrada ou apontando para outro aplicativo, clicar para ligar na plataforma não abre nada ou abre o programa errado.

Use este guia para preparar estações Windows 10 e Windows 11 e para diagnosticar o erro mais comum: clicar no telefone e o MicroSIP não abrir.

Antes de começar

Confirme estes pontos antes de mexer no Windows:

o usuário da Agilize tem um ramal vinculado;
o MicroSIP, ou outro softphone SIP compatível, está instalado no computador;
o ramal está configurado no MicroSIP com servidor, usuário, senha e domínio corretos;
o MicroSIP fica Online ou registrado antes do teste;
o computador tem microfone e saída de áudio disponíveis;
o navegador usado para acessar a Agilize permite abrir aplicativos externos.

Quando o usuário não tem ramal vinculado, a plataforma pode bloquear a ligação antes de acionar o softphone. Nesse caso, corrija primeiro o cadastro do ramal.

Como a Agilize aciona a ligação

A Agilize usa links sip: para acionar a discagem local. Em ligações para telefone externo, a plataforma envia o destino em formato semelhante a:

sip:0DDDNUMERO

Em ligações para ramal interno ou ações de monitoramento, o link também usa sip:, mas pode enviar apenas o ramal ou um código de recurso da telefonia.

Isso significa que o Windows precisa saber qual aplicativo abre links sip:. Configurar apenas tel: ou callto: pode ajudar em outros sistemas, mas não resolve a discagem por clique da Agilize se o protocolo sip: continuar sem associação.

Ativar no Windows 11

Abra Iniciar > Configurações.
Acesse Aplicativos > Aplicativos padrão.
Na busca de tipo de arquivo ou tipo de link, pesquise por sip.
Abra o resultado SIP.
Selecione MicroSIP ou o softphone SIP usado pela operação.
Confirme em Definir padrão.
Feche e reabra o navegador.
Teste a discagem na Agilize.

Se o MicroSIP não aparecer na lista, siga a seção Quando o MicroSIP não aparece como opção.

Ativar no Windows 10

Abra Iniciar > Configurações.
Acesse Aplicativos > Aplicativos padrão.
Clique em Escolher aplicativos padrão por protocolo.
Procure o protocolo SIP.
Selecione MicroSIP ou o softphone SIP usado pela operação.
Feche e reabra o navegador.
Teste a discagem na Agilize.

Se o Windows não mostrar SIP na lista, o protocolo provavelmente não foi registrado pelo softphone. Siga a seção Quando o MicroSIP não aparece como opção.

Testar fora da Agilize

Antes de culpar a plataforma, teste o protocolo diretamente no Windows.

Pressione Windows + R.
Digite um teste simples:

sip:201

Pressione Enter.

Resultado esperado: o Windows abre o MicroSIP ou pergunta qual aplicativo deve abrir links sip:.

Depois teste um telefone externo no padrão usado pela operação:

sip:011999999999

Se esse teste não abre o MicroSIP, o problema está na associação do protocolo no Windows, no navegador ou na instalação do softphone. Se o teste abre o MicroSIP, mas a ligação não completa, o problema está mais provavelmente no ramal, na conta SIP, no prefixo de discagem ou na telefonia.

Testar pela Agilize

Você pode testar a partir de uma tela que tenha ação de chamada ou pelo monitoramento de telefonia.

Acesse https://my.agilize.app/voice/pbx/monitoring.

Acesso pela tela: barra superior Monitorar > Telefonia.

Ao clicar para ligar, observe qual destes sintomas acontece:

Sintoma	Causa provável	Próxima correção
Nada abre	`sip:` não tem aplicativo padrão, navegador bloqueou app externo ou registro do protocolo está quebrado.	Teste `sip:201` pelo Windows + R e revise Aplicativos padrão.
O Windows pergunta qual app usar	Protocolo existe, mas não há padrão definido.	Escolha MicroSIP e marque a opção para sempre usar esse app quando disponível.
Abre outro app, como Teams, Skype ou Phone Link	Outro aplicativo assumiu o protocolo `sip:`.	Troque o padrão de SIP para MicroSIP.
MicroSIP abre, mas não disca	O MicroSIP recebeu o link, mas não processou o número ou a conta SIP não está pronta.	Teste discagem manual no MicroSIP e revise conta, prefixo e formato do número.
MicroSIP disca, mas a chamada falha	O protocolo está funcionando; a falha está na telefonia.	Revise ramal, registro SIP, senha, domínio, rota de saída e prefixo.

Quando o MicroSIP não aparece como opção

Isso costuma acontecer quando:

foi usada versão portátil do MicroSIP sem registro no Windows;
o MicroSIP foi movido de pasta depois de configurado;
o usuário instalou sem permissão suficiente;
uma atualização do Windows ou de outro app alterou associações;
o registro do protocolo aponta para um caminho antigo.

Tente primeiro a correção simples:

Feche o MicroSIP.
Instale ou reinstale a versão com instalador do MicroSIP.
Abra o MicroSIP uma vez.
Volte em Aplicativos padrão e procure sip.
Defina o MicroSIP como padrão para SIP.

Se a operação usa MicroSIP portátil ou o aplicativo ainda não aparece, use o script oficial da Agilize para registrar o MicroSIP como opção de discagem.

Aplicar o script oficial da Agilize

Script oficial:

https://my.agilize.app/others/Aplicar-Microsip-Padrao-Discagem.ps1

O script não instala o MicroSIP. Ele procura o executável já instalado, registra o MicroSIP como aplicativo capaz de abrir o protocolo sip: e pode abrir a tela de Aplicativos padrão para concluir a escolha no Windows.

Por padrão, o script registra apenas sip, que é o protocolo usado pela Agilize. Ele também aceita outros protocolos se forem informados manualmente, como tel e callto.

O script procura estes executáveis:

microsip.exe;
MicroSIP.exe;
Ligou.me.exe.

Ele procura primeiro em locais comuns, como pasta do próprio script, pasta atual, %LOCALAPPDATA%, %APPDATA%, Program Files, Program Files (x86), Downloads e Desktop. Se não encontrar, use -MicroSIPPath ou -DeepSearch.

Precisa executar como administrador?

Na maioria dos casos, não precisa executar como administrador.

Execute sem administrador quando a correção for para o operador logado no computador. Esse é o cenário recomendado para estações individuais, porque a associação de aplicativo padrão do Windows é uma escolha do usuário.

Execute como administrador apenas quando o time de TI quiser registrar o MicroSIP também em nível de máquina. Mesmo assim, em Windows 10 e Windows 11, o Windows pode manter uma escolha protegida do usuário para o protocolo. Se outro aplicativo continuar como padrão, finalize pela tela Aplicativos padrão do próprio usuário.

Evite executar como outro usuário administrador. Se o script for rodado com credenciais de outro usuário, a configuração do usuário atual pode não ser corrigida.

Executar pelo PowerShell

Abra o menu Iniciar.
Pesquise por PowerShell.
Abra normalmente, sem administrador, salvo orientação do time de TI.
Execute:

$script = "$env:TEMP\Aplicar-Microsip-Padrao-Discagem.ps1"
Invoke-WebRequest -Uri "https://my.agilize.app/others/Aplicar-Microsip-Padrao-Discagem.ps1" -OutFile $script
Set-ExecutionPolicy -Scope Process Bypass -Force
& $script -OpenDefaultApps -Test

O parâmetro -OpenDefaultApps abre a tela de aplicativos padrão do Windows ao final. O parâmetro -Test tenta abrir uma URL de teste sip:100 para confirmar se o Windows já consegue acionar o softphone.

Depois da execução:

Na tela Aplicativos padrão, procure por sip.
Selecione SIP.
Escolha MicroSIP.
Feche e reabra o navegador.
Teste novamente a discagem na Agilize.

Se o PowerShell mostrar [WARN] Executando sem Administrador, isso é esperado quando a correção é feita para o usuário atual.

Se o PowerShell mostrar aviso de UserChoice, o Windows já tem uma escolha protegida para aquele protocolo, possivelmente apontando para Teams, Skype, Phone Link ou outro aplicativo. Nesse caso, o script registrou o MicroSIP, mas a troca final precisa ser feita em Aplicativos padrão.

Informar o caminho do MicroSIP manualmente

Se o script não localizar o MicroSIP, execute informando o caminho do microsip.exe:

$script = "$env:TEMP\Aplicar-Microsip-Padrao-Discagem.ps1"
Invoke-WebRequest -Uri "https://my.agilize.app/others/Aplicar-Microsip-Padrao-Discagem.ps1" -OutFile $script
Set-ExecutionPolicy -Scope Process Bypass -Force
& $script -MicroSIPPath "C:\Program Files\MicroSIP\microsip.exe" -OpenDefaultApps -Test

Outros caminhos comuns:

C:\Program Files\MicroSIP\microsip.exe
C:\Program Files (x86)\MicroSIP\microsip.exe
C:\Users\SEU_USUARIO\AppData\Local\MicroSIP\microsip.exe
C:\Ferramentas\MicroSIP\microsip.exe

Se o MicroSIP estiver em uma pasta fora dos caminhos comuns, use o caminho completo no parâmetro -MicroSIPPath.

Fazer busca mais ampla

Se você não sabe onde o MicroSIP foi salvo, rode:

$script = "$env:TEMP\Aplicar-Microsip-Padrao-Discagem.ps1"
Invoke-WebRequest -Uri "https://my.agilize.app/others/Aplicar-Microsip-Padrao-Discagem.ps1" -OutFile $script
Set-ExecutionPolicy -Scope Process Bypass -Force
& $script -DeepSearch -OpenDefaultApps

A busca ampla pode demorar mais, principalmente em computadores com muitos arquivos.

Registrar outros protocolos

A discagem por clique da Agilize usa sip:. Se a empresa também quer que o MicroSIP abra links de outros sistemas que usam tel: ou callto:, o time de TI pode executar:

$script = "$env:TEMP\Aplicar-Microsip-Padrao-Discagem.ps1"
Invoke-WebRequest -Uri "https://my.agilize.app/others/Aplicar-Microsip-Padrao-Discagem.ps1" -OutFile $script
Set-ExecutionPolicy -Scope Process Bypass -Force
& $script -Protocols sip,tel,callto -OpenDefaultApps

Para corrigir a Agilize, o protocolo essencial é sip.

Verificar o registro atual sem editar

Para conferir se o Windows conhece o protocolo sip:, abra Prompt de Comando e execute:

reg query HKCU\Software\Classes\sip\shell\open\command
reg query HKCR\sip\shell\open\command

O resultado deve apontar para o executável atual do softphone. Se apontar para uma pasta antiga, rode novamente o script informando o caminho correto em -MicroSIPPath.

Não edite manualmente a chave UserChoice das associações de protocolo do Windows. Em Windows 10 e Windows 11, essa associação é protegida pelo sistema. Use a tela de Aplicativos padrão depois de aplicar o script.

Configurar navegador

Depois que o Windows está correto, o navegador ainda pode pedir confirmação para abrir o aplicativo externo.

No Chrome, Edge ou navegadores baseados em Chromium:

Clique para ligar na Agilize.
Quando aparecer a confirmação para abrir o MicroSIP, permita a abertura.
Se houver opção para sempre permitir esse tipo de link, marque essa opção.

Se o navegador não mostra pergunta nenhuma:

feche todas as janelas do navegador e abra novamente;
teste sip:201 na barra de endereço;
teste por Windows + R para separar problema do navegador e problema do Windows;
confira se políticas corporativas não bloqueiam abertura de aplicativos externos;
teste em outro navegador apenas para diagnóstico.

Corrigir problemas de chamada depois que o MicroSIP abre

Quando o MicroSIP abre, a associação do Windows está resolvida. A partir daí, verifique telefonia.

Problema	Verificação
MicroSIP mostra Offline ou não registrado	Revise servidor SIP, domínio, usuário, senha e transporte da conta.
Erro de senha, proibido ou não autorizado	Reconfigure a senha SIP do ramal ou solicite nova senha ao administrador.
Chamada externa falha, mas ramal interno funciona	Revise prefixo de saída, rota de saída e permissões do ramal.
Ramal interno não chama	Verifique se o ramal de destino existe, está online e pertence à mesma operação.
A chamada completa, mas não tem áudio	Revise microfone, alto-falante, permissões de microfone do Windows, VPN, rede e SIP ALG do roteador.
O MicroSIP abre minimizado	Confira a bandeja do sistema, perto do relógio do Windows. O aplicativo pode estar aberto em segundo plano.
O número aparece com caracteres estranhos	Teste com número só com dígitos e confirme o cadastro do telefone na Agilize.

No MicroSIP, teste também digitando o número diretamente no teclado do aplicativo. Se a ligação manual não funciona, o problema não está no clique da Agilize.

Checklist rápido para suporte

Use esta ordem para fechar o diagnóstico sem pular etapas:

O usuário tem ramal vinculado na Agilize?
O MicroSIP está instalado e abre manualmente?
O MicroSIP está Online?
sip:201 abre o MicroSIP pelo Windows + R?
sip:011999999999 abre o MicroSIP pelo Windows + R?
O protocolo SIP está definido para MicroSIP em Aplicativos padrão?
O navegador permite abrir o MicroSIP?
Clicar na Agilize abre o MicroSIP?
A chamada manual pelo MicroSIP funciona?
A chamada pela Agilize aparece nos registros ou no monitoramento de telefonia?

O que informar ao time técnico

Se o problema continuar, envie estas informações para o responsável técnico da operação:

versão do Windows: 10 ou 11;
navegador usado;
versão do MicroSIP;
se sip:201 abriu pelo Windows + R;
se o protocolo SIP aparece em Aplicativos padrão;
se o MicroSIP aparece Online;
print do erro do MicroSIP, se houver;
exemplo do tipo de destino testado: ramal interno ou telefone externo;
horário aproximado do teste.

Não envie senha SIP, token, credencial de acesso ou dados sensíveis.

Discagem por clique no Windows com MicroSIP

Próximo passo