ScreenAgent para Windows

ScreenAgentClosed NiCE ScreenAgent é um serviço executado nos desktops de agentes que exigem gravação de tela. está disponível se você tiver estas licenças:

  • CXone ACD (voice) ou Third Party Telephony Providers

  • Screen Recording Basic ou Advanced

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

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

Para garantir que o Recording Management (CXone) ofereça uma experiência do cliente integrada que utiliza a tecnologia mais atualizada, certifique-se de que está utilizando 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 de ScreenAgent na página Suporte e Downloads.

Você pode usar a ScreenAgent Ferramenta de verificação de conectividade antes ou depois da instalação.

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

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

Para mais informações, consulte Perguntas frequentes relativas ao ScreenAgent.

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

VDIs compatíveis

Para o ambiente de infraestrutura de desktop virtual (VDI), as VDIs suportadas incluem:

  • VMware Horizon

  • Citrix Virtual Desktops (o antigo XenDesktop)

  • Citrix Virtual Apps (anteriormente XenApp) - compatível somente em ambientes locais

  • Ambientes de VDI não persistentes

  • Ambientes multissessão

  • Ambientes de VDI do tipo terminal-server

  • AVD Apps Remotos (requer a Solução alternativa para Apps Remotos do VDI)

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

Considerações sobre o Zscaler

Embora o NiCE CXone não tenha sido projetado para interagir com serviços de proxy de inspeção de tráfego como Zscaler e Netscape, alguns usuários conseguiram configurar a gravação de tela com sucesso usando esses serviços.

Se sua organização usa o Zscaler, verifique se as políticas do Zscaler não bloqueiam a comunicação de agentes ou supervisores com os servidores CoTurn (TURN) do NiCE CXone, que são necessários para a conectividade de gravação e monitoramento de tela. testes demonstraram que determinadas configurações de ZPA (Zscaler Private Access) podem impedir que agentes remotos sejam gravados ou monitorados mesmo quando a gravação ou o monitoramento funcionam para usuários on-premises.

Se a gravação de tela ou o monitoramento falhar para usuários remotos:

  • Assegure-se de que as atualizações de política do Zscaler mais recentes tenham sido aplicadas tanto aos dispositivos do agente quanto aos dispositivos do supervisor.

  • Verifique se as políticas de roteamento e acesso do ZPA permitem a comunicação com os servidores CoTurn NiCE CXone.

  • Colete e relate os logs o mais rápido possível. Os logs de solução de problemas do NiCE CXone são substituídos ao longo do tempo, o que pode limitar a análise de causa raiz caso os problemas sejam relatados posteriormente.

A NiCE CXone Gravação de Tela requer que os dispositivos do agente e do supervisor estabeleçam conectividade WebRTC. Um supervisor pode conseguir se conectar aos servidores CoTurn enquanto um agente não consegue. Sempre valide a conectividade de ambos os endpoints, do agente e do supervisor, ao solucionar problemas de gravação ou monitoramento.

Pré-requisitos

Antes de instalar o ScreenAgent, certifique-se de:

  1. Verifique os requisitos de conectividade para sua região com o Connectivity Requirements Wizard.

  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:

        A Citrix não oferece suporte à configuração de loopback de IP virtual em máquinas hospedadas na nuvem. Esse recurso é essencial para a operação do ScreenAgent como aplicativo remoto, portanto, somente há suporte quando a Citrix está operando em uma máquina on-premise.

        Para mais informações, consulte a documentação da 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 ser listado em uma linha separada.

        • Instale o ScreenAgent no servidor Citrix Virtual Apps.

    • Em um ambiente VDI 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 da imagem de base.

      • Distribuir para todas as instâncias de VDI.

    • Para ambientes multissessão e ambientes VDI do tipo terminal-server:

      • 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 de Login do SO para cada perfil de funcionário deve ser exclusivo por locatário. O valor de Login do SO não pode ser usado para múltiplos perfis de funcionário dentro do mesmo locatário, mesmo que alguns dos perfis de funcionário duplicados estejam inativos. Se múltiplos perfis de funcionário tiverem o mesmo valor de Login do SO, ScreenAgent não será executado para nenhum agente que use esse valor de Login do SO.

    Caso esteja trabalhando em ambientes de VDI multissessão ou não persistentes, 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 ScreenAgent (por exemplo, o administrador) tenha privilégios de Admin no computador do agente.

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

    • 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 NiCE 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 motivos de segurança, primeiro crie um usuário e uma função NiCE 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 aplicativos icon of app selector e selecioneAdmin.
      2. Acesse Segurança > Funções e Permissões.

      3. Clique em Nova função.

      4. Dê um nome para a função, como ScreenAgent chave DE acesso.

      5. Remova todas as permissões da função, exceto Access Key e My Access Key.

      6. Salvar e ativar o perfil.

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

      1. Clique no seletor de aplicativos icon of app selector e selecioneAdmin.
      2. Clique em Funcionários.

      3. Clique em Novo funcionário.

      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 ScreenAgent funcionário. Você pode gerar chaves DE acesso somente depois de criar a conta.

    3. Abra o funcionário ScreenAgent novamente e vá até 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 SECRETA e salve-os em um local seguro. Se você não copiar o Chave DE acesso secreta ou, se você o perder, precisará criar um novo. Use esta ID da chave DE acesso e chave DE acesso secreta ao instalar o ScreenAgent nos computadores de todos agentes.

    5. Ative a conta de funcionário ScreenAgent clicando no botão ativar conta no e-mail de ativação.

  7. Baixe o MSI do ScreenAgent.

    1. Vá para NiCE CXone e faça login como um usuário com a permissão Pode acessar downloads de suporte.

    2. Clique no seu Nome do 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 de 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 a credencial no Gerenciador de Credenciais do Windows.

    • Não há nenhuma alteração 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 somente para gravação de tela e não para monitoramento de tela.

Instalar 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 das seguintes opções:

  • Executar com os direitos do usuário (modo de usuário/contexto de usuário)—Não é necessário reiniciar o computador do agente.

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

Você pode especificar a localização da instalação:

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

  • Ao atualizar para uma versão posterior, você pode definir um caminho de instalação diferente. 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. Consulte Alterar a configuração básica de 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. Para obter detalhes sobre o que permanece no sistema após a desinstalação do ScreenAgent, consulte Informações pós-desinstalação.

Quando se atualiza ou reinstala o ScreenAgent, a instalação utiliza automaticamente a configuração existente, exceto se você especificar diferentes parâmetros. Consulte Use este comando:. 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 chamada durante a instalação, a gravação de tela é interrompida para essa chamada. 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 comando, navegue até o local em que você baixou o MSI e digite 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 de onde você instalou o MSI; normalmente, essa é 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 (nas versões anteriores) ou config.json (ScreenAgentversão 3.2.49 e posteriores), é automaticamente ocultado 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 possua o atributo Pode ser gravado (Tela) (em NiCE CXone, acesse Admin > Funcionários e clique no agente). Esse atributo é necessário para habilitar 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 de log ScreenAgent está localizado em: %appdata%\ScreenAgent\logs\ScreenAgent.log.

    Seus logs do ScreenAgent são enviados quando um agente efetua login, depois a cada 2 horas e quando um agente efetua logout no final de um turno. Seus logs do ScreenAgent são enviados automaticamente para a nuvem, onde a equipe de Suporte do NiCE CXone pode acessá-los, se necessário.

    Se houver algum erro, consulte Solução de problemas de gravações e perguntas frequentes.

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

Instalar o Advanced ScreenAgent

Ao instalar o ScreenAgent Advanced:

  • Você obtém atualizações automáticas e atualizações para todas as instâncias do ScreenAgent.

  • Não é necessário usar infraestrutura de terceiros (FFmpeg) para reduzir o tempo de resolução do problema.

  • São necessários menos recursos (cpu, ram) para maximizar os recursos de VDI e de desktop físico.

  • Se você utilizar o Advanced ScreenAgent com monitoramento de tela em tempo real, você pode habilitar o Screen Assist para que os supervisores possam colocar anotações contextuais nas telas dos agentes durante uma sessão de monitoramento.

Advanced ScreenAgent requer a licença Gravação de tela Advanced.

Para instalar o Advanced ScreenAgent:

  1. Certifique-se de que todos os Pré-requisitos estejam em vigor.

  2. Abra o prompt de comando como Administrador. Na linha de comando, navegue até o local 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 a partir da qual você instalou o MSI, que 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, config.json, é ocultado automaticamente 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) (em NiCE CXone, vá para Admin > Funcionários e, em seguida, clique no agente). Esse atributo é necessário para habilitar 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%\AdvancedScreenAgent\logs\AdvancedScreenAgent.log.

    Seus logs ScreenAgent são carregados quando um agente efetua login, depois a cada 2 horas e quando um agente efetua logout no final de um turno. Seus logs ScreenAgent são carregados automaticamente na nuvem, onde a equipe de Suporte NiCE CXone pode acessá-los, se necessário.

    Se houver algum erro, consulte Solução de problemas de gravações e perguntas frequentes.

Configuração de Chave de Registro Google Chrome para a Lista de Negação

Ao usar os navegadores Google Chrome na máquina do agente, se o valor UiAutomationProviderEnabled não estiver presente na Chave de Registro Chrome do Google, as URLs especificadas na lista de negação podem não ser excluídas da Recording. 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 Google Chrome:

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

Workaround potencial para aplicativos Remotos VDI

Quando os agentes estiverem usando VDI Remote Apps e o processo ScreenAgentWatchDog.exe não iniciar:

  1. Publique ScreenAgent.exe em RemoteApps. Certifique-se de que isso seja acessível somente aos administradores (não aos agentes).

  2. Crie e publique um atalho para RemoteApps. Use um script, como um dos mostrados abaixo, para abrir o navegador e executar o ScreenAgentWatchDog.exe. Os Agentes devem usar este atalho para abrir o navegador, ou o ScreenAgent não será executado.

ScreenAgent para Ambientes Engagement Hub (Multi-ACD/Open)

Engagement Hub (Multi-ACD/Open) é suportado por ScreenAgent em ambientes virtuais ou físicos. Nesses ambientes, o parâmetro RESOLVE_USER deve ser configurado com o valor oslogin. Consulte Installation command parameters para obter informações sobre o parâmetro.

Alterar a configuração básica de ScreenAgent

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

O arquivo de configuração, configFile.ini (em versões anteriores) ou config.json (ScreenAgent versão 3.2.49 e posteriores), é 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 ou config.json (ScreenAgent versão 3.2.49 e superior) na pasta de instalação do ScreenAgent, normalmente 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\n Tamanho/largura de banda do arquivo, CPU e RAM (estimado)

      5

      Padrão (máximo)

      Selecione um grupo de perguntas.

      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 é null, 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\n tamanho/largura de banda do arquivo, CPU & RAM (estimado)

      Nulo

      Padrão (resolução nativa)

      Selecione um grupo de perguntas.

      Elevado

      Resolução da tela / 1,5

      Redução de aproximadamente 20%

      Médio

      Resolução de tela / 2

      Redução de aproximadamente 40%

      Baixo

      Resolução da tela / 4

      Redução de aproximadamente 60% (recomendada somente para telas 4K e 5K)

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

    • Altere 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 ou config.json.

  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. Da pasta de instalação ScreenAgent, execute ScreenAgentWatchdog.exe.

Advanced Configuração do ScreenAgent

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

Se você estiver usando o Advanced ScreenAgent, é recomendável atualizar sua configuração usando o ScreenAgent Manager.

  1. Abra o arquivo config.json na pasta de instalação do Advancecd ScreenAgent, normalmente em C:\Program Files\NICE CXone\AdvancedScreenAgent.

  2. Edite os valores de parâmetros:

    • Altere o valor da propriedade FRAME_PER_SECOND . 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\n tamanho do arquivo/largura de banda, CPU & RAM (estimado)

      5

      Padrão (máximo)

      Selecione um grupo de perguntas.

      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%

    • Altere ou adicione o valor da propriedade RESOLUTION_LEVEL. Por padrão, esse valor é null, 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)

      Selecione um grupo de perguntas.

      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 somente para telas 4K e 5K)

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

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

      Os valores permitidos são true ou false.

  3. Salve o arquivo config.json.

  4. Para aplicar as alterações, reinicie o aplicativo Advanced 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 ScreenAgent, execute ScreenAgentWatchdog.exe.

Preservar sua configuração ao instalar Advanced ScreenAgent

Quando você instala uma nova versão do Advanced ScreenAgent ou atualiza do Basic para Advanced ScreenAgent, o instalador preserva sua configuração existente por padrão. Esse comportamento é controlado pelo parâmetro KEEP_CURRENT_CONFIG em Parâmetros do comando de instalação.

O valor padrão é true. Quando KEEP_CURRENT_CONFIG=true , o instalador usa sua configuração existente. Se KEEP_CURRENT_CONFIG=false, o instalador ignora toda a configuração existente, incluindo quaisquer dados básicos de ScreenAgent. Ele grava uma nova configuração usando somente os valores fornecidos em INSTALL_PARAMS.

Para preservar suas configurações existentes durante a atualização:

  1. Complete os passos em Instalar o Advanced ScreenAgent

  2. Adicione o parâmetro KEEP_CURRENT_CONFIG=true ao Command Prompt.

  3. Conclua as etapas restantes da instalação.

Permissões

ScreenAgent requer as seguintes permissões durante a execução:

  • Acessar Arquivo

    • Acesso de leitura/gravação a %appdata%\ScreenAgent\

    • Acesso de leitura/execução à pasta de instalação:
      Para Basic ScreenAgent - C:\Program Files\NICE-InContact\ScreenAgent) (Esse caminho é configurável.)

      Para Advanced ScreenAgent - C:\Program Files\NICE CXone\AdvancedScreenAgent (Este caminho é configurável.)

  • Acesso condicional (baseado na configuração RESOLVE_USER)

    • default

    • Se RESOLVE_USER=oslogin:

      • Ler variáveis de ambiente (necessário para Login do SO)

  • Permissões adicionais (se estiver usando uma lista de negação)

    • Recuperar informações sobre outros processos em execução visíveis

    • Interagir com elementos de janela de outros processos (para capturar URLs)

As chaves de registro são acessadas somente durante a instalação ou a desinstalação. Nenhum acesso ao registro é necessário durante a operação normal.

ScreenAgent Ferramenta de verificação de conectividade

Use a ferramenta de verificação de conectividade ScreenAgent para executar uma sequência de testes e verificar o acesso à rede, garantindo que ScreenAgent para Windows e Advanced ScreenAgent para Windows funcionem 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 de Downloads.

  • Recomenda-se usar esta ferramenta quando a configuração de rede de um agente mudou ou é diferente da configuração normal. Não é necessário executar a ferramenta para todos os agentes.

  • Você pode executar a ferramenta de verificação de conectividade Múltiplas vezes usando o mesmo comando.

  • Após a execução de cada teste, uma notificação de sucesso ou falha é exibida. Ao 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.

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

    1. Vá para NiCE CXone e faça login como um usuário com a permissão Can access support downloads.

    2. Clique no seu Nome do usuário e selecione Suporte e downloads.

    3. Baixe o arquivo EXE necessário. Observe o local onde você baixou o arquivo EXE, pois você precisará da localização 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=<subdomínio (primeiros 3 caracteres) da URL NiCE 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 é exibido. Ao final da execução, um resumo exibe se cada teste foi aprovado, falhou ou não precisou ser executado (N/D). Por exemplo, se ScreenAgent não estava sendo executado em plano de fundo quando a ferramenta de verificação de conectividade foi iniciada, os testes para fechar ScreenAgent e reiniciá-lo não precisam ser executados.

    Após concluir os testes, a ferramenta de verificação de conectividade cria um arquivo de 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

Configurar ScreenAgent em um Ambiente Multilocatário

Em um ambiente de Múltiplos locatários, cada agente tem seu próprio ACCESS_KEY e SECRET_KEY específico do locatário no qual está trabalhando. múltiplos locatários são suportados para locatários que residem na mesma região.

Este procedimento usa o Microsoft Active Directory, e a configuração pode ser diferente para outras soluções de serviço de diretório.

Para configurar o Active Directory para múltiplos locatários:

  1. Crie um arquivo JSON para cada locatário que você gerencia:

    • Cada arquivo deve incluir o ID da accessKey e o AccessKey Secreto do locatário.

      Por exemplo, se você gerencia o Locatário A e o Locatário B, você poderia nomeá-los TenantA_connection.json e TenantB_connection.json (ou quaisquer nomes que sejam significativos para suas necessidades específicas).

    • Os membros de cada locatário devem ter acesso ao arquivo relevante. Por exemplo, todos os usuários do Locatário A mencionado anteriormente devem ter acesso ao TenantA_connection.json.

    Use a seguinte estrutura para cada arquivo. Os valores dos parâmetros devem ser exclusivos para cada locatário.

    var(--codeSnippetCopyLabel)
    {
      "accessKeyId": "{{ACCESS_KEY}}",
      "accessKeySecret": "{{SECRET_KEY}}"
    }
  2. Coloque esses arquivos em algum local da sua rede onde todos os usuários do locatário possam acessá-los. Por exemplo, crie uma pasta em um servidor de arquivos (como \\\\fileserver\\compartilhado\\files\\).

    Cada locatário pode receber sua própria pasta compartilhado.

  3. Crie um grupo de Segurança para os usuários de cada locatário no Active Diretório usando as seguintes etapas:

    1. Na máquina do Controlador de Domínio, abra o console Usuários e Computadores do Diretório Ativo.

    2. Clique com o botão direito na Unidade organizacional (UO) em que deseja criar os grupos (Users por padrão) e selecione New > Group.

    3. Especificar o nome do grupo. Por exemplo, UsersGroup_TenantA.

    4. Selecione as opções Global scope e Security.

    5. Clique em OK.

    6. Clique com o botão direito no grupo de segurança recém-criado e selecione Propriedades.

    7. Na aba Membros, adicione todos os usuários correspondentes a este locatário.

    8. Clique em OK para concluir as alterações.

    9. Repetir os passos anteriores para criar um grupo de Segurança para cada locatário.

  4. Crie um Group Policy Objects (GPO) com políticas para distribuição de Arquivos que cobrirá todos os locatários:

    1. Abra o GPO Console.

    2. Clique com o botão direito no Domínio ou na OU em que os usuários estão localizados e selecione Create a GPO.

    3. Especifique um nome para o GPO (por exemplo, Tenant_Files_Distribution) e clique em OK.

    4. Clique com o botão direito no GPO que você acabou de criar e selecione Edit para abrir o Group Policy Management editor.

    5. Acesse Configuração do Usuário > Preferências > Configurações de Windows > Arquivos.

    6. Crie uma nova ação de Arquivo para cada locatário separado clicando com o botão direito em Arquivos e selecionando Novo > Arquivo.

    7. Configure as seguintes configurações de Arquivo:

      1. Em Ação, selecione Atualizar.

      2. Em Arquivo(s) de origem, insira o caminho de rede para o arquivo JSON específico criado para o locatário no início deste procedimento (por exemplo, \\fileserver\shared\files\TenantA_connection.JSON).

      3. Em Arquivo de destino, Enter: %appdata%\ScreenAgent\TenantA_connection.json

    8. Na guia Common, selecione Item-level targeting e clique em Targeting….

    9. Na janela do Targeting editor, clique em New Item e selecione Security Group.

    10. No campo Group, especifique o Grupo de Usuários criado anteriormente para o Locatário apropriado (por exemplo, UsersGroup_TenantA).

    11. Clique em OK para finalizar a configuração.

    12. Repita as etapas para criar uma ação File para cada locatário separado com seu próprio arquivo JSON.

  5. Para aplicar e atualizar a política de grupo, execute gpupdate/force no servidor ou aguarde o próximo ciclo de atualização da política de grupo.

  6. Cada usuário deve fazer log out de sua sessão atual e, em seguida, fazer login novamente em sua conta de usuário na máquina para garantir que todas as alterações entrem em vigor.

Parâmetros do comando de instalação

Parâmetro

Descrição

Exemplo

msiexec /i ScreenAgent-32bit-<MSI version>.msi

32 bits ou 64 bits

Se você estiver instalando em um computador com:

  • Windows de 32 bits instalado, digite 32bit

  • Windows de 64 bits instalado, digite 64bit

Versão MSI

Insira a versão MSI do arquivo de instalação baixado na página Suporte e Downloads. Por exemplo, 3.0.22.

msiexec /i ScreenAgent-64bit-3.0.22.msi

 

msiexec /i ScreenAgent-32bit-3.0.22.msi

KEEP_CURRENT_CONFIG

(Opcional) Inclua este parâmetro ao fazer upgrade de básico para avançado ScreenAgent, reinstalar ou instalar uma nova versão.

Quando KEEP_CURRENT_CONFIG=true (padrão), o instalador usa sua configuração existente.

Quando KEEP_CURRENT_CONFIG=false, o instalador ignora sua configuração existente e usa os valores especificados no comando de instalação. Para quaisquer parâmetros que não forem especificados, o instalador usa os valores padrão. Este comportamento também é usado para uma instalação limpa.

Para mais informações, consulte Use este comando: e Preservar sua configuração ao instalar Advanced ScreenAgent.

KEEP_CURRENT_CONFIG=true

INSTALL_PATH

(Opcional) é possível especificar o caminho da instalação. Os arquivos de instalação serão salvos na pasta \NICE-InContact\ScreenAgent no caminho de instalação especificado.

Quando você não adicionar esse parâmetro, o ScreenAgent será instalado com o caminho de instalação padrão na unidade C, mesmo quando KEEP_CURRENT_CONFIG= true.

INSTALL_PATH=d:\newdir

ACCESS_KEY_ID

Colar o ID da chave DE acesso criado na conta do Funcionário. Para gerar uma chave DE acesso, consulte Gere uma chave DE acesso para ScreenAgent.

ACCESS_KEY_ID=ABCDEF12345====

ACCESS_KEY_SECRET

Cole a chave DE acesso secreto criada na conta do Funcionário.

ACCESS_KEY_SECRET=12345ABCDEF

REGION_TYPE

Insira o subdomínio (os primeiros 3 caracteres) da sua URL do NiCE CXone (por exemplo: na1, na2, au1, eu1)

REGION_TYPE=na1

Estatisticas (Optional) By default, this value is set to true and allows the ScreenAgent to collect data on the user machines (RAM, CPU).

Se não quiser que ScreenAgent colete dados, é possível alterar esse valor para false.

Os valores permitidos são true e false.

Você pode alterar esta configuração após a instalação.

STATISTICS=true

WEB_PROXY

Inclua esse parâmetro apenas se você estiver usando um servidor proxy para se conectar à Internet.

Lembre-se de manter em mente:

  • Hospedeiro pode ser nome DO host ou IP

  • Usar http ou https de acordo com as suas configurações de proxy

  • Usar nome do usuário e senha do servidor, se estiver definido nas suas configurações de proxy

Por exemplo:

  • http://server_username:server_password@host:port

  • https://server_username:server_password@host:port

  • https: // host: porta

Quando você estiver utilizando uma URL de proxy que funciona com um arquivo pac de proxy, adicione o prefixo pac+ na frente da URL de proxy, por exemplo, se a URL de proxy for https://<proxy server>.pac, use:

WEB_PROXY=pac+https://<proxy server>.pac

WEB_PROXY=http://admin:pwd@168.63.76.32:3128

 

 

WEB_PROXY=https://proxyserver:8088

 

 

 

 

 

 

 

 

RESOLVE_USER

(Opcional) Configure RESOLVE_USER=oslogin para usar o Login do SO do agente. Nesse modo, ScreenAgent se conecta ao servidor com as informações de Login do SO do agente e pode trabalhar em configurações avançadas, como Engagement Hub (Multi-ACD/Open), ambientes multissessão e mais. Ao usar o Login do SO, ScreenAgent não usa a porta 31322.

Se você não adicionar esse parâmetro, ScreenAgent é instalado com o valor padrão, auto, e depende dos clientes NiCE CXone (MAX, Agent Workspace (Agent) e assim por diante) para se conectar ao servidor. Nesse modo, ScreenAgent usa a porta 31322 para se conectar ao cliente NiCE CXone.

O Login do SO do agente é definido na Guia geral da configuração do Funcionário no formato Domínio\nome de usuário.

  • For Engagement Hub (Multi-ACD/Open) ambientes, esse parâmetro deve ser configurado com o valor oslogin .

    Isso permitirá que o cliente Screen Agent leia o Login do SO do Agente a partir do sistema operacional.

  • Clientes que tiverem múltiplos agentes trabalhando na mesma máquina (não em paralelo) devem usar a configuração OSLogin. Se a configuração OSLogin não for possível, os agentes deverão fazer log out de Windows ao final do turno para que o ScreenAgent funcione corretamente para o próximo agente que fizer login nessa máquina.

RESOLVE_USER=oslogin

FRAME_PER_SECOND

(Opcional) Você pode definir o número de quadros gravados por segundo para o arquivo MP4 de saída. Se você não adicionar esse parâmetro, ScreenAgent é instalado com o valor padrão de 5 quadros por segundo.

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 largura de banda, a CPU e a RAM.

Você pode alterar esta configuração após a instalação.

FRAME_PER_SECOND=3

RESOLUTION_LEVEL

(Opcional) Você pode definir a resolução do arquivo MP4 gravado para otimizar o consumo de RAM e CPU. Se você não adicionar esse parâmetro, ScreenAgent é instalado com a configuração de resolução padrão, null, 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). Reduzir a resolução reduz o tamanho do arquivo, cpu e ram.

Você pode alterar esta configuração após a instalação.

RESOLUTION_LEVEL=low

LOAD_CERTIFICATES

(Opcional) Defina esse parâmetro como false se o ScreenAgent não Puder acessar e carregar certificados autoassinados do repositório de certificados do Windows.

Os valores permitidos são true ou false.

Se você não adicionar esse parâmetro, o ScreenAgent acessará os certificados autoassinados do repositório de certificados do Windows.

Você pode alterar esta configuração após a instalação.

LOAD_CERTIFICATES=false

/log install.log

Imprime os resultados da instalação no arquivo de log.

/log install.log

/quiet

(Opcional) Inclua se você deseja suprimir pop-ups durante a instalação. Você poderá visualizar os resultados da instalação no arquivo de log.

/quiet

SHOW_NOTIFICATIONS

(Opcional) Mostra aos agentes uma breve notificação de Desktop a partir do ícone na bandeja quando a gravação de tela é iniciada ou interrompida, e quando o mascaramento de tela é iniciado ou interrompido.

false

Defina como true para ativar as notificações.

Este parâmetro aplica-se somente ao Advanced ScreenAgent.

SHOW_NOTIFICATIONS=true

Informações pós-desinstalação

Quando você desinstala o ScreenAgent de uma máquina cliente, os itens no sistema:

  • Conteúdo da pasta AppData: Toda a pasta %AppData%\ScreenAgent\ é mantida, incluindo logs e arquivos de configuração.

  • Pasta de instalação: A pasta em ...\Program Files\NICE-InContact\ScreenAgent ou C:\Program Files\NICE CXone\AdvancedScreenAgent permanece, mas seu conteúdo é excluído durante o processo de desinstalação.

Estes arquivos e pastas residuais:

  • Não interfira em uma instalação nova ou atualizada do ScreenAgent.

  • Pode ser excluído manualmente, se necessário, caso seja necessário um ambiente completamente limpo.

Se desejar remover todos os vestígios de ScreenAgent, certifique-se de excluir manualmente essas pastas após a desinstalação.