ScreenAgent para Mac

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 o ScreenAgentClosed NiCE ScreenAgent é um serviço executado nos desktops de agentes que exigem gravação de tela. nos computadores para gravar ou monitorar a atividade na tela do agente durante uma interação. ScreenAgent é executado em segundo plano e grava automaticamente de acordo com as políticas de gravação. Supervisores e avaliadores também podemmonitorar a atividade de um agente durante uma interação.

Você pode instalar o ScreenAgent nos computadores dos agentes com sistema operacional Mac. Se você estiver usando o ScreenAgent básico para Mac, use a versão 3.0.1 ou posterior. As versões do Mac OS com suporte são 10.15 macOS Catalina, 11 macOS Big Sur e posteriores.

Para Advanced ScreenAgent para Mac, use a versão 5.0.39 e acima.

Você pode encontrar a versão mais recente de ScreenAgent na página Suporte e Downloads.

Mantenha em mente:

  • ScreenAgent no SO Mac (básico e avançado) oferece suporte a gravações de até três telas.

  • ScreenAgent no Mac OS (básico e avançado) oferece suporte ao monitoramento de tela de forma diferente para desktops e laptops.

    • Desktops Mac—Suporta até três telas.

    • Laptops Mac—Suporta até três telas se a tela do laptop estiver fechada. Quando a tela do laptop está aberta e não é a tela principal, o ScreenAgent captura todas as telas externas (até três). A tela do laptop não será capturada.

  • Após a instalação bem-sucedida, você precisa conceder permissão manualmente para gravar a tela.

Para locatários configurados com 100% de gravação de tela, a gravação de tela é iniciada até 25 segundos depois que o agente efetua login. A Gravação de tela não funciona corretamente durante esses 25 segundos.

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

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

Pré-requisitos

Antes de iniciar a instalação do ScreenAgent Advanced, certifique-se de:

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

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

  3. Verifique se o usuário que está instalando o Advanced ScreenAgent (por exemplo, o administrador) tem privilégios de Admin no computador do agente.

  4. Certifique-se de que o usuário que está instalando o Advanced ScreenAgent (por exemplo, o admin) tenha estas NiCE CXone permissões:

    • Pode acessar downloads de suporte: On—Isso permite que você acesse a página Supports & Downloads.

    • Chave DE acesso:Crio—Isso é para gerenciar as chaves DE acesso para sua organização.

  5. Siga as etapas abaixo, na ordem apresentada, para gerar uma chave DE acesso para o Advanced ScreenAgent. Você pode usar a mesma chave DE acesso para instalar o Advanced ScreenAgent nos computadores de todos os agentes do 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 Avançado e, em seguida, gere a chave com o usuário ScreenAgent.

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

      1. Clique no seletor de aplicativos icon of app selector 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 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 novamente o funcionário ScreenAgent 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 o Chave DE acesso Secreto 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 este ID da chave DE acesso e chave DE acesso Secreto 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.

  6. Baixar o ScreenAgent:

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

    2. Clique em Nome do usuário e selecione Suporte & Downloads.

    3. Baixe o DMG ScreenAgent avançado. Observe para onde você baixa o DMG, você precisará do local do arquivo mais tarde.

Instalar Advanced ScreenAgent para Mac

Advanced ScreenAgent para Mac pode ser usado com Screen Recording Basic license ou Screen Recording Advanced license. No entanto, determinadas funcionalidades são suportadas somente para clientes com uma licença Screen Recording Advanced. Consulte Cumulative Updates for ScreenAgent para mais detalhes.

Quando você instalar o Advanced ScreenAgent para Mac:

  • Você obtém atualizações automáticas e atualizações para todas as instâncias do Advanced 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ê usar o Advanced ScreenAgent com uma licença Screen Recording Advanced e monitoramento de tela em tempo real, você pode habilitar o Screen Assist para que os supervisores possam colocar notas contextuais nas telas dos agentes durante uma sessão de monitoramento.

Para instalar o Advanced ScreenAgent:

Se você já tem o ScreenAgent, pode instalar o Advanced ScreenAgent sobre a versão básica sem desinstalar a versão básica primeiro. Para preservar suas configurações existentes durante a atualização, consulte Preservar sua configuração ao instalar o Advanced ScreenAgent.

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

  2. Extraia o AdvancedScreenAgent-darwin-universal-x.x.x.dmg pelo terminal ou manualmente:

    Para extrair o arquivo via terminal:

    1. No aplicativo terminal em seu Mac, digite o nome do caminho completo onde você baixou o arquivo DMG.

    2. Para extrair o arquivo, digite sudo hdiutil attach AdvancedScreenAgent-darwin-universal-<enter DMG version, such as 5.0.39>.dmg e pressione Enter.

    3. Para mover o arquivo para a pasta Aplicativos, digite sudo cp -R /Volumes/AdvancedScreenAgent/AdvancedScreenAgent.app /Applications e pressione Enter.

    4. Digite sudo hdiutil unmount /Volumes/AdvancedScreenAgent/ e pressione Enter.

    Para extrair o arquivo DMG manualmente:

    1. Vá até a localização onde você baixou o arquivo DMG e dê um duplo clique no arquivo AdvancedScreenAgent-darwin-universal-x.x.x.dmg.

    2. Copie a pasta Advanced ScreenAgent e cole-a no diretório Aplicativos.

  3. Instruções passo a passo para instalar:

    1. Vá para o aplicativo terminal no seu Mac.

    2. Copie e cole o comando no terminal e edite os parâmetros de acordo com a tabela Parâmetros do comando de instalação.

      var(--codeSnippetCopyLabel)
      sh /Applications/AdvancedScreenAgent.app/Contents/Resources/install-advanced-screen-agent.sh 'INSTALL_PARAMS=[ACCESS_KEY_ID=<paste the access key ID>,ACCESS_KEY_SECRET=<paste the secret access key>,BASE_URL=https://na1.nice-incontact.com,SHOW_NOTIFICATIONS=<optional: true|false>]'
      • Certifique-se de ter a senha Admin sudo. Este comando pode solicitar que você insira a senha.

      • Observação: as configurações LOAD_CERTIFICATES e WEB_PROXY não são necessárias para o Advanced ScreenAgent. Isso ocorre porque o Advanced ScreenAgent não faz chamadas diretas de saída e toda a comunicação é gerenciada pelos aplicativos da web, que não exigem essa configuração.

    3. O parâmetro SHOW_NOTIFICATIONS aplica-se ao computador em que você instala o ScreenAgent do Advanced. Os Agentes não podem ativar ou desativar as Notificações. Para alterar a configuração após a instalação, altere o valor de true para false.
    4. Para preservar suas configurações existentes durante uma atualização, consulte Preservar sua configuração ao instalar o Advanced ScreenAgent.

  4. O log do progresso da instalação é exibido no terminal e salvo no arquivo de log de instalação, InstallationLog.txt. O caminho completo é /Applications/AdvancedScreenAgent.app/Contents/Resources/InstallationLog.txt.

  5. Quando a instalação for concluída e você for solicitado a abrir o Advanced ScreenAgent, clique em Open.

  6. Quando for solicitado a conceder permissão de gravação de tela no aplicativo Advanced ScreenAgent, clique em Configurações.

  7. Na página Configurações , selecione a caixa de seleção Advanced ScreenAgent. Um prompt é exibido informando para encerrar o Advanced ScreenAgent para permitir que ele grave a tela. CliqueSaia agora.

  8. Reinicie o computador ou acesse o aplicativo terminal em seu Mac e execute o comando:

    Abra /Applications/AdvancedScreenAgent.app

  9. Certifique-se de que o agente tenha o atributo Pode ser gravado (Tela) (em NiCE CXone, acesse 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.

  10. Grave uma chamada e verifique o arquivo de log Advanced ScreenAgent. O caminho completo para o arquivo AdvancedScreenAgent.log é ~/Library/Application Support/AdvancedScreenAgent/logs/AdvancedScreenAgent.log. Se houver algum erro, consulte Solução de problemas de gravações e perguntas frequentes.

Alterar a configuração do Advanced ScreenAgent

After installation, you can change some Advanced ScreenAgent configurações.

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

  1. Abra o arquivo config.json na pasta de instalação do Advanced ScreenAgent, normalmente em ~/Library/Application Support/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\r\n tamanho do arquivo/largura de banda, 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%

    • 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\r\n Tamanho do Arquivo/largura de Banda, CPU & 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% (recomendada somente para telas 4K e 5K)

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

  3. Salve o arquivo config.json.

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

Atualizando seu Advanced ScreenAgent para a versão Mac

Se você estiver atualizando de uma versão do Advanced ScreenAgent para Mac para uma versão mais recente do Advanced ScreenAgent para Mac, você precisa habilitar sua máquina para permitir atualizações.

Antes de fazer a atualização:

  1. No menu principal, navegue até Privacidade & Security>App Management.

  2. Ative o alternador de terminal para ATIVADO (permita que os aplicativos abaixo atualizem ou excluam outros aplicativos).

  3. Agora você pode fazer upgrade da sua versão do Advanced ScreenAgent para Mac.

Preservar sua configuração ao instalar o Advanced ScreenAgent

Quando você atualiza para uma nova versão do Advanced ScreenAgent ou atualiza de 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 Advanced ScreenAgent para Mac

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

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

ScreenAgent Ferramenta de verificação de Conectividade

Use a ferramenta de verificação de Conectividade ScreenAgent para executar uma sequência de testes para verificar o acesso à rede e garantir que AdvancedScreenAgent para Mac funcione corretamente.

  • Você pode usar a ferramenta antes ou depois de instalar o AdvancedScreenAgent.

  • 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. 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. Baixar o arquivo DMG da ferramenta de verificação de Conectividade:

    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 arquivo DMG necessário ScreenAgentConnectivityTool-<version>-mac.dmg. Observe o local onde você baixa o arquivo DMG, pois você precisará da localização DE arquivo posteriormente.

  2. Mount the DMG file. 
    1. Dê duplo clique no arquivo DMG no Finder para montá-lo.

      Alternativamente, execute o seguinte comando no terminal:

      hdiutil attach /path/to/ScreenAgentConnectivityTool-<version>-mac.dmg
    2. A ferramenta estará disponível em:

      /Volumes/ScreenAgentConnectivityTool/ScreenAgentConnectivityTool-<versão>-mac-universal

  3. Run the Connectivity Check Tool
    1. Abra o terminal e execute o seguinte comando como Administrador. Você precisará da senha do sudo .

      sudo "/Volumes/ScreenAgentConnectivityTool/ScreenAgentConnectivityTool-<version>-mac-universal" ACCESS_KEY_ID=<access key ID> ACCESS_KEY_SECRET=<secret access key> REGION_TYPE=<region>

      Exemplo de comando:

      sudo "/Volumes/ScreenAgentConnectivityTool/ScreenAgentConnectivityTool-1.27.0-mac-universal" ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1

  4. 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 passou, falhou ou não precisou ser executado (N/D).

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

Testes de conectividade

  • Os testes de Fechar/iniciar ScreenAgent exibirão N/A se o Advanced ScreenAgent não estava em execução quando a ferramenta foi iniciada.

  • O teste de handshake TLS pode mostrar N/A se a região não tiver um terminal turns:443 configurado.

Usando uma lista de negação com ScreenAgent avançado para Mac

Para usar a lista de negação com Advanced ScreenAgent, você deve habilitar as seguintes permissões:

Configurações>Privacidade & Segurança>Accessibility> Advanced ScreenAgent

Configurações>Privacidade & Segurança>Gravação de Tela & Gravação de áudio do Sistema> Advanced ScreenAgent

Em ambos os casos, ative o toggle Advanced ScreenAgent para habilitar essas permissões.

Para mais informações sobre o uso de uma lista de recusa, consulte Gerenciar uma lista de recusa de gravação de tela.