# 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-03T18:36:58.062Z

## Página

- Título: Discagem por clique no Windows com MicroSIP
- URL humana: https://agilize.app/docs/usuarios/transmissoes-e-telefonia/discagem-por-clique-windows-microsip
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Como ativar a discagem por clique da Agilize no Windows 10 e Windows 11 e corrigir casos em que o MicroSIP ou softphone padrão não abre.

## Seções

- Antes de começar
- Como a Agilize aciona a ligação
- Ativar no Windows 11
- Ativar no Windows 10
- Testar fora da Agilize
- Testar pela Agilize
- Quando o MicroSIP não aparece como opção
- Aplicar o script oficial da Agilize

## Conteúdo da página

# 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:

```text
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

1. Abra **Iniciar > Configurações**.
2. Acesse **Aplicativos > Aplicativos padrão**.
3. Na busca de tipo de arquivo ou tipo de link, pesquise por `sip`.
4. Abra o resultado **SIP**.
5. Selecione **MicroSIP** ou o softphone SIP usado pela operação.
6. Confirme em **Definir padrão**.
7. Feche e reabra o navegador.
8. 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](#quando-o-microsip-nao-aparece-como-opcao).

## Ativar no Windows 10

1. Abra **Iniciar > Configurações**.
2. Acesse **Aplicativos > Aplicativos padrão**.
3. Clique em **Escolher aplicativos padrão por protocolo**.
4. Procure o protocolo **SIP**.
5. Selecione **MicroSIP** ou o softphone SIP usado pela operação.
6. Feche e reabra o navegador.
7. 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](#quando-o-microsip-nao-aparece-como-opcao).

## Testar fora da Agilize

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

1. Pressione **Windows + R**.
2. Digite um teste simples:

```text
sip:201
```

3. 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:

```text
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](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:

1. Feche o MicroSIP.
2. Instale ou reinstale a versão com instalador do MicroSIP.
3. Abra o MicroSIP uma vez.
4. Volte em **Aplicativos padrão** e procure `sip`.
5. 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:

```text
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

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

```powershell
$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:

1. Na tela **Aplicativos padrão**, procure por `sip`.
2. Selecione **SIP**.
3. Escolha **MicroSIP**.
4. Feche e reabra o navegador.
5. 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`:

```powershell
$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:

```text
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:

```powershell
$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:

```powershell
$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:

```bat
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:

1. Clique para ligar na Agilize.
2. Quando aparecer a confirmação para abrir o MicroSIP, permita a abertura.
3. 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:

1. O usuário tem ramal vinculado na Agilize?
2. O MicroSIP está instalado e abre manualmente?
3. O MicroSIP está Online?
4. `sip:201` abre o MicroSIP pelo **Windows + R**?
5. `sip:011999999999` abre o MicroSIP pelo **Windows + R**?
6. O protocolo **SIP** está definido para MicroSIP em **Aplicativos padrão**?
7. O navegador permite abrir o MicroSIP?
8. Clicar na Agilize abre o MicroSIP?
9. A chamada manual pelo MicroSIP funciona?
10. 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.

## Guias relacionados

- [Monitoramento de Telefonia](/docs/usuarios/transmissoes-e-telefonia/monitoramento-de-telefonia)
- [WhatsApp, chat, SMS e telefone na rotina](/docs/usuarios/flow-e-atendimento/whatsapp-chat-sms-e-telefone-na-rotina)
- [Cadastro de ramais](/docs/configuracao/telefonia/cadastro-de-ramais)
- [Cadastro de filas de telefonia](/docs/configuracao/telefonia/cadastro-de-filas-telefonia)