Manual de Configuração do AgentWatcher

O AgentWatcher é uma ferramenta inteligente que monitora a inatividade do seu computador e altera automaticamente o status de presença do seu ramal no Yeastar P-Series. Quando você bloqueia sua máquina ou fica inativo, o AgentWatcher muda seu status para "Ausente", e quando você retorna, o status volta para "Disponível". Este manual irá guiá-lo através de todo o processo de configuração.

1. Pré-requisitos

Antes de começar, certifique-se de que você possui:

• Acesso de administrador ao portal web do seu Yeastar P-Series
• AgentWatcher instalado no seu computador
• Número do ramal que será monitorado
• Conexão de rede entre o computador e o Yeastar P-Series

2. Configuração no Yeastar P-Series

2.1. Habilitando a API

Para que o AgentWatcher possa se comunicar com o seu PABX, você precisa primeiro habilitar a API no Yeastar. Siga os passos abaixo:

1. Acesse o portal web do seu Yeastar P-Series com credenciais de administrador
2. Navegue até Integração > API
3. Ative a chave API clicando no toggle
4. (Opcional) Se desejar restringir o acesso, habilite a Restrição de IP e adicione o endereço IP do computador onde o AgentWatcher será executado
5. Na seção Configurações Avançadas, vá para a aba Monitor de Status da Extensão e habilite o monitoramento para os ramais desejados
6. Clique em Salvar

2.2. Obtendo as Credenciais da API

Após habilitar a API, você precisará do Client ID e do Client Secret para configurar o AgentWatcher. Esses valores são essenciais para autenticação.

1. Na mesma tela de configuração da API (Integrações > API)
2. Localize os campos Client ID e Client Secret
3. Copie esses valores e guarde-os em um local seguro
4. Você utilizará esses valores na configuração do AgentWatcher

3. Configuração no AgentWatcher

Com as informações do Yeastar em mãos, agora você pode configurar o AgentWatcher. Siga os passos abaixo:

1. Abra o aplicativo AgentWatcher no seu computador
2. Clique no botão Configurações ou acesse o menu de configuração
3. Preencha os seguintes campos:
   • FQDN do iPBX: O endereço do seu Yeastar P-Series (exemplo: pbx.suaempresa.com ou suaempresa.ras.yeastar.com)
   • Client ID: O Client ID que você copiou do Yeastar
   • Client Secret: O Client Secret que você copiou do Yeastar
   • Ramal: O número do ramal que será monitorado (exemplo: 1001)
   • Tempo de inatividade: O tempo em minutos que o AgentWatcher irá esperar antes de alterar o status do seu ramal para ausente (recomendado: 10 minutos)
4. Clique em Testar para verificar se as informações estão corretas. Você deve receber uma mensagem de sucesso: "Conexão com a API foi bem-sucedida!"
5. Se o teste for bem-sucedido, clique em Salvar para guardar as configurações

4. Como Funciona o AgentWatcher

Após a configuração, o AgentWatcher funcionará automaticamente em segundo plano:

5. Solução de Problemas

Erro: "Ramal não encontrado ou erro na conexão"

Se você receber essa mensagem ao testar a conexão, verifique:

• FQDN do iPBX: Certifique-se de que o endereço está correto e acessível. Teste digitando o endereço em um navegador.
• Client ID e Client Secret: Verifique se você copiou os valores corretamente do Yeastar. Certifique-se de que não há espaços em branco extras.
• Número do ramal: Confirme que o número do ramal está correto e que ele existe no Yeastar.
• API habilitada: Verifique se a API está realmente habilitada no Yeastar em Integrações > API.
• Permissões do ramal: Certifique-se de que o ramal tem permissões para alteração de status via API.
• Firewall: Se estiver usando um firewall, certifique-se de que a porta 8088 (ou a porta configurada) está aberta para comunicação com o Yeastar.

O status não muda automaticamente

Se o status do seu ramal não está mudando mesmo após a configuração:

• Verifique se o Monitor de Status da Extensão está habilitado no Yeastar para o seu ramal.
• Certifique-se de que o AgentWatcher está rodando (verifique o ícone na bandeja do sistema).
• Tente fechar e reabrir o AgentWatcher.
• Verifique se há logs de erro no diretório de instalação do AgentWatcher.

Permissão negada ao gravar logs

Se receber um erro de permissão ao gravar logs:

• Certifique-se de que o AgentWatcher foi instalado com permissões de administrador.
• Verifique se o diretório de instalação tem permissões de escrita para o usuário atual.
• Tente executar o AgentWatcher como administrador.

6. Suporte e Documentação

Para mais informações sobre a API do Yeastar P-Series, consulte a documentação oficial do Yeastar.

Se você tiver dúvidas ou problemas que não foram resolvidos por este manual, entre em contato com a equipe de suporte da Convectiva.