Ou instale via winget abrindo o PowerShell ou Prompt de Comando e executando:
winget install Convectiva.AgentWatcher
Ou instale via winget abrindo o PowerShell ou Prompt de Comando e executando:
winget install Convectiva.AgentWatcher
O AgentWatcher 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 status muda para "Ausente"; quando você retorna, volta para "Disponível". A partir da versão 1.0.3 ele também permite trocar o status à mão pela bandeja do sistema e pausar ou retomar o seu ramal em cada fila, inclusive por horário programado. Este manual cobre todo o processo de configuração e uso.
Novidades da versão 1.0.3
winget install --silentAntes de começar, certifique-se de que você possui:
Para que o AgentWatcher possa se comunicar com o seu PABX, você precisa primeiro habilitar a API no Yeastar. Siga os passos abaixo:
Dica: O monitoramento de status da extensão é essencial para que o AgentWatcher funcione corretamente. Sem isso, o sistema não conseguirá alterar o status do seu ramal.
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.
Com as informações do Yeastar em mãos, agora você pode configurar o AgentWatcher. Siga os passos abaixo:
pbx.suaempresa.com ou suaempresa.ras.yeastar.com)1001)
Sucesso! Após salvar as configurações, o AgentWatcher começará a monitorar a inatividade do seu computador e alterará automaticamente o status do seu ramal.
Clique com o botão direito no ícone do AgentWatcher, ao lado do relógio do Windows. O menu traz duas coisas distintas — e vale entender a diferença, porque elas são independentes:
Status do ramal é o seu estado de presença: Disponível, Ausente, Viagem de Negócios, Não Perturbe, Pausa Almoço ou Fora do Trabalho. Vale para quem liga diretamente para você. O estado atual aparece marcado.
Pausa na fila é por fila, uma a uma. Você pode estar Disponível e mesmo assim pausado na fila de Suporte — ou o contrário. Pausar na fila não muda o seu status, e mudar o status não tira você da fila.
Basta clicar no status desejado. A troca vale imediatamente no PABX, e o monitoramento automático de inatividade continua funcionando normalmente — se você ficar inativo depois, o status irá para "Ausente" como sempre.
Abaixo dos status, o menu lista as filas de que o seu ramal participa. Cada item diz o que vai acontecer ao clicar — "pausar" ou "voltar para a fila" — e mostra uma marca quando você está pausado nela.
Em vez de lembrar de pausar o almoço todo dia, você pode programar. No menu da bandeja, clique em Programar pausa...
Cada pausa tem:
Você pode criar várias pausas para a mesma fila — por exemplo, um café às 10:00 e o almoço às 12:00 — e pausas diferentes para filas diferentes. As regras ficam gravadas no seu computador, em %LOCALAPPDATA%\AgentWatcher.
A regra da tela bloqueada — importante
A pausa entra no horário programado mesmo com a tela bloqueada. Se você saiu para almoçar, a fila não deve chamá-lo justamente nesse momento.
Já a retomada não acontece com a tela bloqueada. Se o horário de voltar chegar e você ainda não estiver no computador, a volta fica pendente — e o AgentWatcher devolve você à fila assim que você desbloquear a máquina. Assim a fila nunca passa a chamar um lugar vazio.
O programado nunca briga com a sua decisão. Se você voltar do almoço mais cedo e sair da pausa pelo menu, o AgentWatcher não torna a pausar até aquela janela terminar. No dia seguinte, a programação volta a valer normalmente.
Após a configuração, o AgentWatcher funcionará automaticamente em segundo plano:
Quando você bloqueia o computador: O AgentWatcher detecta o bloqueio e altera o status do seu ramal para "Ausente".
Tempo de inatividade: O AgentWatcher detecta o tempo de inatividade de acordo com o tempo configurado (5, 10 ou 15 min). Após esse período, altera o status do seu ramal para "Ausente".
Quando você retorna: Assim que você desbloquear o computador ou retomar a atividade, o AgentWatcher altera o status do seu ramal para "Disponível".
Pausas programadas: Nos horários que você programou, o AgentWatcher pausa o seu ramal nas filas escolhidas e o devolve a elas no fim do período — respeitando a regra da tela bloqueada descrita na seção 5.
Monitoramento contínuo: O AgentWatcher continua monitorando em segundo plano, mesmo que você minimize a janela. O ícone na bandeja do sistema indica que a aplicação está ativa.
Se você receber essa mensagem ao testar a conexão, verifique:
Se o status do seu ramal não está mudando mesmo após a configuração:
%LOCALAPPDATA%\AgentWatcher (cole esse caminho na barra do Explorador de Arquivos).A partir da versão 1.0.3, os logs e as pausas programadas ficam em %LOCALAPPDATA%\AgentWatcher, e não mais na pasta de instalação.
Não altere as permissões da pasta de instalação. A pasta C:\Program Files\Convectiva\AgentWatcher é propositalmente somente-leitura para usuários comuns. Até a versão 1.0.2 ela era gravável por qualquer usuário do computador, o que permitia substituir os arquivos do programa e capturar as credenciais de outras pessoas que usassem a mesma máquina. Dar permissão de escrita ali reabre essa falha, e não é necessário para nada.
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.
Nota: Este manual corresponde à versão 1.0.3 do AgentWatcher, com o Yeastar P-Series. Algumas telas ou opções podem variar dependendo da sua versão específica. As notas de cada versão estão em github.com/ederpardeiro/AgentWatcher/releases.