ScreenAgent para Windows

ScreenAgentFechado NICE ScreenAgent é um serviço executado em desktops de agente que requerem gravação de tela. está disponível se você tiver CXone Recording Avançado e uma licença de gravação de tela.

Instale o ScreenAgent em computadores para registrar ou monitorar atividades na tela de um agente durante uma interação. O ScreenAgent é executado em segundo plano e grava automaticamente de acordo com as políticas de gravação (consulte CXone Recording) Supervisores e avaliadores também podemmonitorar a atividade de um agente durante uma interação.

Para garantir que o CXone Recording Envolvimento da Força de Trabalho (WEM) ofereça uma experiência perfeita ao cliente que utilize a tecnologia mais atualizada, certifique-se de usar as versões com suporte do ScreenAgent:

  • ScreenAgent para Windows versões 3.0.22 ou posterior.

  • ScreenAgent para MAC versões 3.0.1 ou posterior.

Se você estiver usando versões anteriores do ScreenAgent, precisará atualizar todos os seus usuários para o ScreenAgent 3.0.x anteriores. As versões mais antigas não são compatíveis e podem não gravar as telas dos seus agentes.

Você pode encontrar a versão mais recente do ScreenAgent na página de downloads.

Para usar versões ScreenAgent 3.0.x, certifique-se de ter permitido os seguintes FQDNs:

  • Para FedRamp: cxone-gov.niceincontact.com

  • Para todas as outras regiões: cxone.niceincontact.com

Você pode instalar o ScreenAgent nos computadores dos agentes ou em um ambiente de infraestrutura de desktop virtual (VDI). VDIs compatíveis:

  • VMware Horizon

  • Citrix Virtual Desktops (anteriormente XenApp)

  • Citrix Virtual Apps (anteriormente XenApp)

  • Ambientes de VDI não persistentes

  • Ambientes multissessão

  • Ambientes de VDI do tipo servidor/terminal

O VMware Horizon não requer nenhuma configuração especial. Quanto a outros ambientes de VDI, consulte os pré-requisitos.

Você pode Verificar a conectividade ScreenAgent antes ou depois da instalação.

Para locatários configurados com 100% de gravação de tela, a gravação da tela começa até 25 segundos após o login do agente. A Gravação de tela não funciona corretamente durante esses 25 segundos.

 

Você pode assistir a um vídeo que fornece uma visão geral da instalação do ScreenAgent no computador de um agente. O vídeo inclui os pré-requisitos e as etapas de instalação.

Para mais informações, veja FAQs para o ScreenAgent.

Para uma lista de recursos adicionados a versões anteriores do ScreenAgent, consulte ScreenAgent: Notas de versão cumulativas.

Pré-requisitos

Antes de instalar o ScreenAgent, certifique-se de:

  1. Verificar o Requisitos de conectividade. Lembre-se de que o ScreenAgent não registra se o seu firewall gera certificados autoassinados ou retira cabeçalhos de solicitação de pacotes HTTPS.

  2. Se o seu site usa VDIs, certifique-se de:

    • Você está usando o ScreenAgent V3.x.x e versões superiores.

    • Para o modo de aplicativos virtuais Citrix:

      • Habilite uma política de loopback de IP virtual. Adicione ScreenAgent.exe e Chrome.exe à lista de programas de loopback virtual do IP virtual. Lembre-se de que cada programa deve estar listado em uma linha separada.

      • Instale o ScreenAgent no servidor Citrix Virtual Apps.

    • Em um ambiente não persistente:

      • Utilize o ScreenAgent versão 3.0 ou mais avançada.

      • Instale o ScreenAgent na imagem de base da VDI.

      • Tire um instantâneo de tela da imagem de base

      • Distribua para todas as instâncias da VDI.

    • Para ambientes multissessão e ambientes VDI do tipo terminal/servidor:

      • Utilize o ScreenAgent versão 3.0 ou mais avançada.

      • Configure o ScreenAgent para que funcione no modo Login do SO.

      • Os usuários precisam fazer login no ScreenAgent com as credenciais de login do SO.

      O valor Login do SO para cada perfil de funcionário deve ser exclusivo. O valor Login do SO não pode ser usado para vários perfis de funcionários, mesmo que alguns dos perfis de funcionários duplicados estejam inativos. Se vários perfis de funcionários tiverem o mesmo valor Login do SO, o ScreenAgent não será executado para nenhum agente usando esse valor Login do SO.

    Caso esteja trabalhando em um ambiente de VDI multissessão ou não persistente, e se depare com problemas, entre em contato com o suporte da NICE para verificar se o seu ambiente específico é compatível.

    O modo de desktop virtual VMware Horizon e Citrix não requer nenhuma configuração especial.

  3. Verifique a configuração do computador do agente.

  4. Certifique-se de que o usuário que está instalando o ScreenAgent (por exemplo, o administrador) tem privilégios de administrador no computador do agente.

  5. Verifique se o usuário que está instalando o ScreenAgent (por exemplo, o administrador) tem estas permissões do CXone:

    • Pode acessar downloads de suporte: Ligado, isso permite que você acesse a página Suporte - Downloads.

    • Chave de acesso: Criar, isso é para gerenciar chaves de acesso para sua organização.

  6. Gere uma chave de acesso para ScreenAgent.

    Você pode usar a mesma chave de acesso para instalar o ScreenAgent em todos os computadores dos agentes em seu locatário.

    A chave de acesso recebe todas as permissões do CXone usuário que o gera. Se este usuário for um administrador, qualquer pessoa com a chave de acesso terá privilégios de administrador. Portanto, por razões de segurança, primeiro crie um usuário e função CXone para ScreenAgent e, em seguida, gere a chave com o usuário ScreenAgent.

    1. Crie uma função para o serviço ScreenAgent:

      1. Clique no seletor de aplicativo e selecioneAdmin.
      2. Vá para Segurança > Funções e permissões.

      3. Clique em Nova função.

      4. Dê um nome para a função, como Chave de acesso do ScreenAgent.

      5. Remova todas as permissões da função, exceto Chave de acesso e Minha chave de acesso.

      6. Salvar e ativar o perfil.

    2. Crie um funcionário para o serviço ScreenAgent:

      1. Clique no seletor de aplicativo e selecioneAdmin.
      2. Clique em Funcionários.

      3. Clique em Novo Empregado.

      4. Dê um nome para o funcionário, como ScreenAgent.

      5. Na lista de drop-down do Função primária, selecione a função tecla de acesso ScreenAgent que você acabou de criar.

      6. Na guia Geral, limpe todos os atributos.

      7. Crie o funcionário ScreenAgent. Você pode gerar chaves de acesso somente depois de criar a conta.

    3. Abra o funcionário ScreenAgent novamente e vá para a guia Segurança. Clique em Adicionar chave de acesso para gerar uma chave de acesso.

    4. Copie o ID da chave de acesso e a chave de acesso secreto e salve-os em algum lugar seguro. Se você não copiar o Chave de acesso secreta ou, se você o perder, precisará criar um novo. Use esta ID de chave de acesso e chave de acesso secreta ao instalar o ScreenAgent nos computadores de todos os agentes.

    5. Ative a conta de funcionário ScreenAgent clicando no botão Ativar conta no email de ativação.

  7. Baixe o MSI do ScreenAgent.

    1. Vamos para CXone e efetue login como um usuário com a permissão Pode acessar downloads de suporte.

    2. Clique no seu nome de usuário e selecione Suporte e downloads.

    3. Baixe o MSI necessário. Observe para onde baixar o MSI, você precisará do local do arquivo posteriormente.

  8. O ScreenAgent oferece suporte a cinco métodos de autenticação de proxy para gravação de tela—Basic, Digest, Kerberos, NTLM e Negotiate. Ao usar o método de autenticação proxy:

    • Certifique-se de definir o proxy no nível do sistema operacional nas configurações proxy.

    • Para o método de autenticação Basic and Digest, você deve definir credenciais no Gerenciador de Credenciais do Windows.

    • Não há mudança na instalação. No entanto, se você quiser usar o proxy para ScreenAgent sem alterar o proxy no sistema operacional, você pode usar o proxy direto na instalação do ScreenAgent.

    • Tenha em mente que esses métodos de autenticação são apenas para gravação de tela e não para monitoramento de tela.

Instalar o ScreenAgent para Windows

Você pode instalar o ScreenAgent usando uma ferramenta de implantação ou instalar manualmente no computador de cada agente.

Se você estiver usando uma ferramenta de implantação, configure a instalação para uma destas opções:

  • Executar com direitos de usuário (modo de usuário/contexto de usuário)—Você não precisa reiniciar o computador do agente.

  • Executar com direitos administrativos—Você deve reiniciar os computadores de todos os agentes.

É possível especificar o local da instalação:

  • Como padrão, o ScreenAgent é instalado na pasta \NICE-InContact\ScreenAgent da unidade C. É possível especificar outro caminho de instalação, no comando de instalação.

  • Ao efetuar a atualização para uma versão mais avançada, será possível definir outro caminho de instalação. A versão anterior será removida e a mais avançada será instalada no local especificado.

  • A reinstalação da mesma ScreenAgent versão substitui a instalação já existente no mesmo local. Para alterar o caminho de instalação, desinstale a instância existente e especifique o local da reinstalação.

Alguns parâmetros do ScreenAgent podem ser alterados após a instalação. Veja Alterar configuração do ScreenAgent. Para atualizar outros parâmetros de instalação, reinstale o cliente ScreenAgent.

Para atualizar o ScreenAgent para uma versão posterior, instale o cliente ScreenAgent. Você não precisa desinstalar a versão anterior.

Quando se atualiza ou reinstala o ScreenAgent, a instalação utiliza automaticamente a configuração existente, exceto se você especificar diferentes parâmetros. Veja Reinstalar ou atualizar com a configuração vigente. Quando se desinstala o ScreenAgent, a configuração não é salva, sendo necessário especificar os parâmetros de instalação durante a atualização ou reinstalação.

Atualize ou reinstale o ScreenAgent quando os agentes não estiverem sendo gravados. Se um agente estiver em uma ligação durante a instalação, a gravação na tela será interrompida para essa ligação. Após a instalação, as chamadas serão gravadas de acordo com as políticas de gravação e scripts do Studio.

Para instalar o ScreenAgent:

  1. Certifique-se de que todos os pré-requisitos estejam atendidos.

  2. Abra o prompt de comando como administrador. Na linha de comandos, navegue até onde você baixou o MSI e insira o comando de instalação com os parâmetros relevantes.

  3. Verifique o sucesso da instalação no arquivo de log. O arquivo install.log está na pasta da qual você instalou a MSI, normalmente a pasta %UserProfile%\downloads.

    • Verifique se o instalador possui privilégios de administrador.

    • Se o computador do agente não tiver o Microsoft .NET Framework 4.0 ou superior, instale-o.

    O arquivo de configuração, configFile.ini, fica automaticamente oculto após a instalação. Para visualizar e abrir o arquivo, habilite Itens ocultos no Explorador de Arquivos do Windows.

  4. Certifique-se de que o agente tenha o atributo Pode ser gravado (tela) (no CXone, acesse Administrador > Funcionários e clique no agente). Este atributo é necessário para ativar a gravação de tela, o monitoramento de tela ou ambos.

  5. Grave uma chamada e verifique o arquivo de log do ScreenAgent. O arquivo ScreenAgent.log está localizado em: %appdata%\ScreenAgent\logs\ScreenAgent.log.

    Seus logs do ScreenAgent também são carregados automaticamente na nuvem, onde a equipe de suporte da NICE CXone pode acessá-los, se necessário.

    Se houver algum erro, consulte Solucionar problemas de gravações.

Você pode assistir a um vídeo que fornece uma visão geral de como melhorar as interações do agente com o monitoramento de tela em tempo real usando o ScreenAgent.

Configuração da chave de registro do Google Chrome para a lista de negações

Ao usar os navegadores do Google Chrome na máquina do agente, se o valor UiAutomationProviderEnabled não estiver presente na Chave de registro do Google Chrome, os URLs especificados na lista de negação poderão não ser excluídos da gravação. Consulte Gerenciar uma lista de recusa de gravação de tela.

Para adicionar o valor à chave do Registro:

  1. Verifique se a máquina do agente está usando o navegador Chrome 126 ou posterior.

  2. Verifique se você tem privilégios de administrador do Windows.

  3. Verifique se o caminho do registro HKLM:\SOFTWARE\Policies\Google\Chrome existe.

  4. Execute a seguinte linha de script do Powershell para adicionar o valor ao registro do Google Chrome:

    Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Google\Chrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord

Alterar configuração do ScreenAgent

Após a instalação, você pode alterar algumas configurações do ScreenAgent.

O arquivo de configuração, configFile.ini, fica automaticamente oculto após a instalação. Para visualizar e abrir o arquivo, habilite Itens ocultos no Explorador de Arquivos do Windows.

  1. Abra o arquivo configFile.ini na pasta de instalação do ScreenAgent, geralmente em C:\Program Files\NICE-InContact\ScreenAgent.

  2. Edite os valores de parâmetros:

    • Modifique o valor framePerSecond, na seção [recordingParameters]. Por padrão, este valor é 5.

      Os valores permitidos são 1, 2, 3, 4 ou 5 .

      Reduzir o número de quadros por segundo reduz o tamanho do arquivo, a CPU e a RAM.

      Quadros por segundo Redução de quadros Impacto no tamanho/largura de banda do arquivo, CPU e RAM (estimado)

      5

      Padrão (máximo)

      Nenhum(a)

      4

      20% menos

      Redução de aproximadamente 15%

      3

      40% menos

      Redução de aproximadamente 30%

      2

      60% menos

      Redução de aproximadamente 45%

      1

      80% menos

      Redução de aproximadamente 60%

    • Modifique o valor resolutionLevel, na seção [recordingParameters]. Por padrão, esse valor é nulo, a resolução de tela atual.

      Os valores permitidos são nulo, baixo, médio ou alco(com distinção de maiúsculas e minúsculas).

      Diminuir a resolução reduz o tamanho do arquivo, a CPU e a RAM.

      Nível de resolução Redução na RESOLUÇÃO Impacto no tamanho/largura de banda do arquivo, CPU e RAM (estimado)

      Nulo

      Padrão (resolução de tela atual)

      Nenhum(a)

      Elevado

      Resolução da tela/1,5

      Redução de aproximadamente 20%

      Médio

      Resolução da tela/2

      Redução de aproximadamente 40%

      Baixo

      Resolução da tela/4

      Redução de aproximadamente 60% (recomendado apenas para telas 4K)

      Para redefinir a resolução da tela, altere o valor de resolutionLevel para null.

    • Modifique o valor loadCertificates, na seção [others]. Por padrão, esse valor é true.

      Os valores permitidos são true ou false.

  3. Salve o arquivo configFile.ini.

  4. Para aplicar as alterações, reinicie o aplicativo ScreenAgent:

    1. No Gerenciador de Tarefas do Windows, finalize a tarefa ScreenAgentWatchDog.exe atual e, em seguida, finalize os processos ScreenAgent.exe.

    2. Na pasta de instalação do ScreenAgent, execute ScreenAgentWatchdog.exe.

Verificar a conectividade ScreenAgent

Use a ferramenta de Verificação de conectividade do ScreenAgent para executar um sequência de testes para verificar o acesso à rede e garantir que o ScreenAgent funcionará corretamente.

  • Você pode usar a ferramenta antes ou depois da instalação do ScreenAgent.

  • Você pode baixar a versão mais recente da ferramenta de Verificação de conectividade na página Downloads.

  • Recomenda-se usar esta ferramenta quando a configuração de rede de um agente mudou ou é diferente da configuração normal. Você não precisa executar a ferramenta para cada agente.

  • Você pode executar a ferramenta de Verificação de conectividade várias vezes usando o mesmo comando.

  • Após a execução de cada teste, uma notificação de sucesso ou falha é exibida. No final da execução, um resumo exibe o status de cada teste.

  • Depois de concluir os testes, a ferramenta de Verificação de conectividade cria um arquivo de log.

  • A ferramenta de Verificação de conectividade atualmente não inclui testes para verificar a rede para monitoramento de tela em tempo real.

  1. Baixe o arquivo EXE da ferramenta de Verificação de conectividade:

    1. Vamos para CXone e efetue login como um usuário com a permissão Pode acessar downloads de suporte.

    2. Clique no seu nome de usuário e selecione Suporte e downloads.

    3. Baixe o arquivo EXE necessário. Observe onde você baixa o arquivo EXE, você precisará do local do arquivo mais tarde.

  2. Execute a ferramenta de Verificação de conectividade.

    1. Execute o prompt de comando como administrador.

    2. Copie e cole o comando no prompt de comando e edite os parâmetros listados na tabela.

      <caminho para o arquivo exe> ACCESS_KEY_ID=<ID da chave de acesso> ACCESS_KEY_SECRET=<chave de acesso secreta> REGION_TYPE=<URL do subdomínio (3 primeiros caracteres) do CXone> WEB_PROXY=<opcional: URL do servidor proxy>

    Exemplo de comando:

    C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088
  3. A ferramenta de Verificação de conectividade começa a executar os testes. Após a execução de cada teste, uma notificação de sucesso ou falha é exibida. Se um teste falhar, o motivo da falha será exibido. No final da execução, um resumo exibe se cada teste passou, falhou ou não precisou ser executado (N/A). Por exemplo, se o ScreenAgent não estava em execução em segundo plano quando a ferramenta de verificação da conectividade foi iniciada, os testes para fechar o ScreenAgent e reiniciar o que não precisa ser executado.

    Depois de concluir os testes, a ferramenta de verificação de conectividade cria um arquivo log (SA_Connectivity_tool_log_<runUniqueUUID>) na mesma pasta do arquivo de instalação da ferramenta de verificação de conectividade. O arquivo log inclui todas as informações que foram exibidas no prompt de comando.

Testes de conectividade