ScreenAgent para Windows

ScreenAgent está disponible si cuenta con las siguientes licencias:

  • CXone ACD (voice) o Third Party Telephony Providers

  • Screen Recording Basic o Advanced

Instale ScreenAgent en los equipos para grabar o supervisar la actividad en la pantalla de un agente durante una interacción. ScreenAgent se ejecuta en segundo plano y grabar automáticamente de acuerdo con las políticas de recording (consulte Recording Management (CXone)). Los Supervisores y evaluadores también pueden supervisar la actividad de un agente durante una interacción.

Puede instalar ScreenAgent en las computadoras de los agentes o en un entorno de infraestructura de escritorio virtual (VDI).

Para garantizar que Recording Management (CXone) ofrezca una experiencia del cliente fluida que utilice la tecnología más actualizada, asegúrese de estar utilizando las versiones de ScreenAgent compatibles:

  • ScreenAgent para Windows versión 3.0.22 o posterior

  • ScreenAgent para MAC versión 3.0.1 o posterior

Si utiliza versiones anteriores de ScreenAgent, deberá actualizar todos sus usuarios a la versión ScreenAgent 3.0.x. Las versiones anteriores no SOn compatibles y podrían no registrar las pantallas de sus agentes.

Puede encontrar la última versión de ScreenAgent en la página Soporte y descargas.

Puede usar la ScreenAgent Herramienta de comprobación de conectividad antes o después de la instalación.

Para los abonados configurados con grabación de pantalla al 100%, la grabación de pantalla se inicia hasta 25 segundos después de que el agente inicia sesión. La grabación de pantalla no funciona correctamente durante estos 25 segundos.

Puede ver un video que ofrece una perspectiva general de la instalación básica de ScreenAgent en la computadora de un agente. El video incluye los requisitos previos y los pasos de instalación.

Para obtener más información, consulte Preguntas frecuentes para ScreenAgent.

Para obtener una lista de las funciones agregadas en versiones anteriores de ScreenAgent, consulte ScreenAgent: Notas acumuladas de lanzamiento.

Los VDI compatibles

Para el entorno de infraestructura de escritorio virtual (VDI), las VDI compatibles incluyen:

  • VMware Horizon

  • Citrix Virtual Desktops (anteriormente, XenDesktop)

  • Citrix Virtual Apps (anteriormente XenApp): Compatible únicamente en entornos locales

  • Entornos VDI no persistentes

  • Entornos multisesión

  • Entornos VDI de tipo servidor de terminal

  • Aplicaciones remotas AVD (requiere la solución alternativa de aplicaciones remotas de VDI)

VMware Horizon no requiere ninguna configuración especial. Para otros entornos VDI, consulte los requisitos previos.

Consideraciones de Zscaler

Aunque NiCE CXone no está diseñado para interactuar con servicios de proxy de inspección de tráfico como Zscaler y Netscape, algunos usuarios han logrado configurar la grabación de pantalla correctamente con estos servicios.

Si su organización utiliza Zscaler, verifique que las políticas de Zscaler no bloqueen la comunicación del agente o del supervisor con los servidores CoTurn (TURN) de NiCE CXone, que SOn necesarios para la conectividad de grabación y monitoreo de pantalla. La Prueba ha demostrado que ciertas configuraciones de ZPA (Zscaler Private Access) pueden impedir que los agentes remotos sean grabados o monitoreados incluso cuando la grabación o el monitoreo funcionan para los usuarios locales.

Si la grabación de pantalla o la supervisión fallan para usuarios remoto:

  • Asegúrese de que las últimas actualizaciones de políticas de Zscaler se hayan aplicado tanto a los dispositivos del agente como a los del supervisor.

  • Verificar que las políticas de routing y acceso de ZPA permitan la comunicación con los servidores CoTurn de NiCE CXone.

  • Recopile e informe los registros lo antes posible. Los registros de solución de problemas de NiCE CXone se sobrescriben a lo largo del tiempo, lo que puede limitar el análisis de causa raíz si los problemas se informan más adelante.

NiCE CXone Screen Recording requiere que tanto los dispositivos del agente como del supervisor establezcan conectividad WebRTC. Es posible que un supervisor pueda conectarse a servidores CoTurn mientras que un agente no pueda hacerlo. Siempre valide la conectividad desde los extremos tanto del agente como del supervisor al solucionar problemas de grabación o monitoreo.

Prerrequisitos

Antes de instalar ScreenAgent, verifique lo siguiente:

  1. Verifique los requisitos de conectividad para su región con el Asistente de Requisitos de Conectividad.

  2. Si su sitio utiliza VDI, asegúrese de:

    • Está utilizando ScreenAgent V3.x.x o superior.

      • Para el modo de aplicaciones virtuales de Citrix:

        Citrix no es compatible con la configuración del bucle de retorno de IP virtual en máquinas alojadas en la nube. Esta función es esencial para la operación de ScreenAgent como aplicación Remota, por lo que solo se admite cuando Citrix está operando en una máquina local.

        Para más información, consulte la documentación de Citrix.

        • Habilite una política de bucle de retorno de IP virtual. Añadir ScreenAgent.exe y Chrome.exe a la lista de programas de bucle virtual de IP virtual. Tenga en cuenta que cada programa debe aparecer en una línea separada.

        • Instale ScreenAgent en el servidor de Citrix Virtual Apps.

    • En un entorno de VDI no persistente:

      • Use ScreenAgent versión 3.0.22 o superior.

      • Instale ScreenAgent en la imagen base de la VDI.

      • Tome una instantánea de la imagen base.

      • Distribuir a todas las instancias VDI.

    • Para entornos multisesión y entornos VDI de tipo servidor de terminal:

      • Use ScreenAgent versión 3.0.22 o superior.

      • Configure ScreenAgent para trabajar en modo de Inicio de sesión en sistema operativo.

      • Los usuarios deben iniciar sesión en ScreenAgent con las credenciales de Inicio de sesión en sistema operativo.

      El valor de Inicio de sesión en sistema operativo para cada perfil de empleado debe ser único por abonado. El valor de Inicio de sesión en sistema operativo no puede utilizarse para múltiples perfiles de empleado dentro del mismo abonado, incluso si algunos de los perfiles de empleado duplicados están inactivos. Si múltiples perfiles de empleado tienen el mismo valor de Inicio de sesión en sistema operativo, ScreenAgent no se ejecutará para ningún agente que utilice ese valor de Inicio de sesión en sistema operativo.

    Si trabaja en entornos VDI multisesión o no persistentes y tiene problemas, póngase en contacto con NiCE soporte para comprobar si su entorno específico es compatible.

    El modo de escritorio virtual VMware Horizon y Citrix no requiere ninguna configuración especial.

  3. Verifique la configuración de la computadora del agente.

  4. Asegúrese de que el usuario que está instalando ScreenAgent (por ejemplo, el administrador) tenga privilegios de Admin en la computadora del agente.

  5. Asegúrese de que el usuario que está instalando ScreenAgent (por ejemplo, el administrador) tenga estos NiCE CXone permisos:

    • Puede acceder a descargas de soporte: Activado, esto le permite acceder a la página Soportes - Descargas.

    • Access Key: Create, this is to manage access keys for your organization.

  6. Genere una clave DE acceso para ScreenAgent.

    Puede usar la misma clave DE acceso para instalar ScreenAgent en las computadoras de todos sus abonados.

    La clave DE acceso recibe todos los permisos del NiCE CXone usuario que lo genera. Si este usuario es un administrador, cualquier persona que tenga la clave DE acceso tendrá privilegios de administrador. Por lo tanto, por motivos de seguridad, primero cree un usuario y un rol de NiCE CXone para ScreenAgent, y luego genere la clave con el usuario de ScreenAgent.

    1. Cree un rol para el servicio de ScreenAgent:

      1. Haga clic en el selector de aplicaciones icon of app selector y seleccioneAdmin.
      2. Vaya a Seguridad > Roles and Permissions.

      3. Haga clic en Nuevo rol.

      4. Dé un nombre para el rol, como ScreenAgent clave DE acceso.

      5. Elimine todos los permisos para el rol, excepto Access Key y My Access Key.

      6. Haga clic en Guardar y Activar el perfil.

    2. Cree un empleado para el servicio de ScreenAgent:

      1. Haga clic en el selector de aplicaciones icon of app selector y seleccioneAdmin.
      2. Haga clic enEmpleados.

      3. Haga clic en Nuevo empleado.

      4. Dé un nombre para el empleado, como ScreenAgent.

      5. Desde la lista desplegable Rol principal, seleccione el Rol de clave DE acceso ScreenAgent que acaba de crear.

      6. En la Pestaña general, borre todos los atributos.

      7. Cree el ScreenAgent empleado. solo puede generar las claves DE acceso después de crear la cuenta.

    3. Abra de nuevo el empleado ScreenAgent y vaya a la pestaña Seguridad. Haga clic en Agregar clave DE acceso para generar una clave DE acceso.

    4. Copie tanto el ID DE Clave DE acceso como la clave secreta DE ACCESO y guárdelos en un lugar seguro. Si no copia el Clave DE acceso secreta o si lo pierde, deberá crear uno nuevo. Use este ID de Clave DE acceso y la clave DE acceso secreta al instalar ScreenAgent en las computadoras de todos los agentes.

    5. Active la cuenta de empleado de ScreenAgent haciendo clic en el botón Activate Account en el correo electrónico de activación.

  7. Descargue el MSI de ScreenAgent:

    1. Vaya a NiCE CXone e inicie sesión como un usuario con el permiso Puede acceder a descargas de soporte.

    2. Haga clic en su Nombre DE usuario y seleccione Soporte y descargas.

    3. Descargue el MSI requerido. Tenga en cuenta dónde descarga el MSI, necesitará la ubicación del archivo más adelante.

  8. ScreenAgent admite cinco métodos de autenticación de proxy para la grabación de pantalla: Basic, Digest, Kerberos, NTLM y Negotiate. Cuando se utiliza el método de autenticación de proxy:

    • Asegúrese de configurar el proxy a nivel del sistema operativo en la configuración de Proxy.

    • Para el método de autenticación Basic y Digest, debe establecer las credenciales en el administrador de La credencial de Windows.

    • No hay cambios en la instalación. Sin embargo, si desea utilizar el proxy para ScreenAgent sin cambiar el proxy en el sistema operativo, puede utilizar el proxy directo en la instalación de ScreenAgent.

    • Tenga en cuenta que estos métodos de autenticación SOn solo para la grabación de pantalla y no para el monitoreo de pantalla.

Instalar ScreenAgent para Windows

Puede instalar ScreenAgent mediante una herramienta de implementación o instalarlo manualmente en la computadora de cada agente.

Si utiliza una herramienta de implementación, configure la instalación con una de las siguientes opciones:

  • Ejecutar con los derechos del usuario (modo de usuario/contexto de usuario): no es necesario reiniciar la computadora del agente.

  • Ejecutar con derechos administrativos: Debe reiniciar las computadoras de todos los agentes.

Puede especificar la ubicación de instalación:

  • Por defecto, ScreenAgent se instala en la unidad C, en la carpeta \NICE-InContact\ScreenAgent. Puede especificar una ruta de instalación diferente en el comando de instalación.

  • Al actualizar a una versión posterior, puede definir una ruta de instalación diferente. La versión anterior se elimina y la versión más reciente se instala en la ubicación especificada.

  • La reinstalación de la misma versión de ScreenAgent sustituye a la instalación existente en la misma ubicación. Para cambiar la ruta de instalación, desinstale la instancia existente y especifique la ubicación necesaria en la reinstalación.

Algunos parámetros de ScreenAgent pueden quedar modificados después de la instalación. Consulte Cambiar la configuración de Basic ScreenAgent. Para actualizar otros parámetros de instalación, reinstale el cliente ScreenAgent.

Para actualizar ScreenAgent a una versión posterior, instale el cliente ScreenAgent. No es necesario desinstalar la versión anterior. Para obtener detalles sobre lo que permanece en el sistema después de desinstalar ScreenAgent, consulte Información posterior a la desinstalación.

Cuando actualiza o reinstala ScreenAgent, la instalación utiliza automáticamente la configuración existente a menos que especifique parámetros diferentes. Consulte Use this command: . Al desinstalar ScreenAgent, la configuración no se guarda y es necesario especificar los parámetros de instalación al actualizar o reinstalar.

Actualice o reinstale ScreenAgent cuando los agentes no se estén registrando. Si un agente está en medio de una llamada durante la actualización, la grabación de pantalla se detendrá para esa llamada. Una vez finalizada la instalación, las llamadas se grabarán de acuerdo con las políticas de grabación y los scripts de Studio.

Para instalar ScreenAgent:

  1. Asegúrese de que se cumplan todos los requisitos previos.

  2. Abra el símbolo del sistema como Administrador. En la línea de comandos, navegue hasta donde descargó el MSI e ingrese el comando de instalación con los parámetros importantes:

  3. Verifique el éxito de la instalación desde el archivo de registro. El archivo install.log se encuentra en la carpeta desde la que instaló el MSI; esta suele ser la carpeta %UserProfile%\downloads.

    • Compruebe que el instalador tiene privilegios de administrador.

    • Si la computadora del agente no tiene Microsoft .NET Framework 4.0 o superior, instálelo.

    El archivo de Config,configFile.ini (en versiones anteriores) o config.json (ScreenAgentversión 3.2.49 y posteriores), se oculta automáticamente después de la instalación. Para ver y abrir el archivo, active elementos ocultos en el explorador de archivos de Windows.

  4. Asegúrese de que el agente tenga el atributo Se puede grabar (pantalla) (en NiCE CXone, vaya a Admin > Empleados, y luego haga clic en el agente). Este atributo es necesario para habilitar la grabación de pantalla, el monitoreo en pantalla, o ambos.

  5. Grabe una llamada y verifique el archivo de registro de ScreenAgent. El archivo de registro ScreenAgent.log se encuentra en:%appdata%\ScreenAgent\logs\ScreenAgent.log.

    Sus registros de ScreenAgent se cargan cuando un agente inicia sesión, luego cada 2 horas y cuando un agente cierra sesión al final de un turno. Sus registros de ScreenAgent se cargan automáticamente a la nube, donde el equipo de Soporte de NiCE CXone puede acceder a ellos, si es necesario.

    Si hay algún error, consulte Solución de problemas de grabaciones y preguntas frecuentes.

Puede ver un video que ofrece una perspectiva general de cómo mejorar las interacciones de los agentes con el monitoreo en pantalla en tiempo real utilizando ScreenAgent básico.

Instalar Advanced ScreenAgent

Al instalar el Advanced ScreenAgent:

  • Obtiene actualizaciones automáticas y actualizaciones a todas las instancias de ScreenAgent.

  • No es necesario utilizar infraestructura de terceros (FFmpeg) para reducir el tiempo de resolución de la incidencia.

  • Se requieren menos recursos (cpu, ram) para maximizar los recursos del equipo de escritorio virtual (VDI) y del equipo de escritorio físico.

  • Si utiliza Advanced ScreenAgent con monitoreo en pantalla en tiempo real, puede habilitar Screen Assist para que los supervisores puedan colocar notas contextuales en las pantallas de los agentes durante una sesión de monitoreo.

Advanced ScreenAgent requiere la licencia Screen Recording Advanced.

Para instalar Advanced ScreenAgent:

  1. Asegúrese de que se cumplan todos los Prerrequisitos.

  2. Abra el símbolo del sistema como Administrador. En la línea de comandos, navegue hasta donde descargó el archivo MSI e ingrese el comando de instalación con los parámetros importantes:

  3. Verifique el éxito de la instalación desde el archivo de registro. El archivo install.log se encuentra en la carpeta desde la que instaló el MSI; normalmente es la carpeta %UserProfile%\downloads.

    • Compruebe que el instalador tiene privilegios de administrador.

    • Si la computadora del agente no tiene Microsoft .NET Framework 4.0 o superior, instálelo.

    El archivo de configuración, config.json, se oculta automáticamente después de la instalación. Para ver y abrir el archivo, active elementos ocultos en el explorador de archivos de Windows.

  4. Asegúrese de que el agente tenga el atributo Se puede grabar (Pantalla) (en NiCE CXone, vaya a Admin > Empleados y, a continuación, haga clic en el agente). Este atributo es necesario para habilitar la grabación de pantalla, el monitoreo en pantalla, o ambos.

  5. Grabe una llamada y verifique el archivo de registro de ScreenAgent. El archivo ScreenAgent.log se encuentra en: %appdata%\AdvancedScreenAgent\logs\AdvancedScreenAgent.log.

    Sus registros de ScreenAgent se cargan cuando un agente inicia sesión, luego cada 2 horas y cuando un agente cierra sesión al final de un turno. Sus registros de ScreenAgent se cargan automáticamente a la nube, donde el equipo de Soporte de NiCE CXone puede acceder a ellos, si es necesario.

    Si hay algún error, consulte Solución de problemas de grabaciones y preguntas frecuentes.

Configuración de la Clave de registro Google Chrome para la Lista de denegación

Cuando se utilizan los navegadores Google Chrome en la máquina del agente, si el valor UiAutomationProviderEnabled no está presente en la Clave de registro de Google Chrome, es posible que las URL especificadas en la lista de denegación no se excluyan de la grabación. Consulte Administrar una lista de denegación de Grabación de pantalla.

Para agregar el valor a la clave de registro:

  1. Asegúrese de que la máquina del agente esté usando el navegador Chrome 126 o posterior.

  2. Verifique que tiene privilegios de Administrador de Windows.

  3. Verifique que existe la ruta de registro HKLM:\SOFTWARE\Policies\Google\Chrome.

  4. Ejecute la siguiente línea de script de Powershell para agregar el valor al registro de Google Chrome:

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

Solución alternativa potencial para VDI Remote Apps

Cuando los agentes utilizan VDI Remote Apps y el proceso ScreenAgentWatchDog.exe no se inicia:

  1. Publique ScreenAgent.exe en RemoteApps. Verifique que sea accesible solo para los administradores (no para los agentes).

  2. Cree y publique un atajo a RemoteApps. Utilice un script, como uno de los que se muestran a continuación, para abrir el navegador y ejecutar ScreenAgentWatchDog.exe. Los Agentes deben usar este acceso directo para abrir el navegador, o ScreenAgent no se ejecutará.

Para Engagement Hub (Multi-ACD/Open) Entornos de ScreenAgent

Engagement Hub (Multi-ACD/Open) es compatible con ScreenAgent en entornos virtuales o físicos. En estos entornos, el parámetro RESOLVE_USER se debe configurar con el valor oslogin. Consulte parámetros del comando de instalación para obtener información sobre el parámetro.

Cambiar la configuración de Basic ScreenAgent

Después de la instalación, puede cambiar algunas configuraciones de ScreenAgent.

El archivo de configuración, configFile.ini (en versiones anteriores) o config.json (versión ScreenAgent 3.2.49 y posteriores), se oculta automáticamente después de la instalación. Para ver y abrir el archivo, active elementos ocultos en el explorador de archivos de Windows.

  1. Abra el archivo configFile.ini o config.json (ScreenAgent versión 3.2.49 y posteriores) en la carpeta de instalación de ScreenAgent, generalmente en C:\Program Files\NICE-InContact\ScreenAgent.

  2. Editar los valores de parámetros:

    • Cambie el valor framePerSecond en la sección [recordingParameters]. Por defecto, este valor es 5.

      Los valores permitidos SOn 1, 2, 3, 4 o5.

      Disminuir el número de cuadros por segundo reduce el tamaño del archivo, la cpu y la ram.

      Recuadros por segundo Reducción de cuadros Impact en\n tamaño de archivo/ancho de banda, cpu y ram (estimado)

      5

      Predeterminado (máximo)

      Ninguno

      4

      20% menos

      ~15% de reducción

      3

      40% menos

      ~30% de reducción

      2

      60% menos

      ~45% de reducción

      1

      80 % menos

      ~60% de reducción

    • Cambie el valor resolutionLevelen la sección [recordingParameters]. Por defecto, este valor es null, la resolución de pantalla actual.

      Los valores permitidos SOn nulo, bajo, medio o alto (insensible a mayúsculas y minúsculas).

      Disminuir la resolución reduce el tamaño del archivo, la CPU y la RAM.

      Nivel de resolución Reducción de Resolución Impact en el tamaño de archivo/ancho de banda, CPU & RAM (estimado)

      Null

      Por defecto (resolución nativa)

      Ninguno

      Alta

      Resolución de pantalla / 1.5

      ~20% de reducción

      Media

      Resolución de pantalla / 2

      ~40% de reducción

      Baja

      Resolución de pantalla / 4

      ~60% de reducción (recomendado solo para pantallas de 4K y 5K)

      Para restablecer la resolución de la pantalla, cambie el valor de resolutionLevel a null.

    • Cambie el valor de loadCertificates en la sección [others]. Por defecto este valor es verdadero.

      Los valores aceptables SOn verdadero o falso.

  3. Guarde el archivo configFile.ini o config.json.

  4. Para aplicar los cambios, reinicie la aplicación ScreenAgent:

    1. En el administrador de tareas de Windows, finalice la tarea ScreenAgentWatchDog.exe actual y luego finalice los procesos ScreenAgent.exe.

    2. Desde la carpeta de instalación de ScreenAgent, ejecute ScreenAgentWatchdog.exe.

Cambiar la configuración de Advanced ScreenAgent

After installation, puede cambiar algunas configuraciones avanzadas de ScreenAgent.

Si está utilizando Advanced ScreenAgent, se recomienda actualizar su configuración usando el ScreenAgent Manager.

  1. Abra el archivo config.json en la carpeta de instalación de Advancecd ScreenAgent, que generalmente se encuentra en C:\Program Files\NICE CXone\AdvancedScreenAgent.

  2. Editar los valores de parámetros:

    • Cambie el valor de la propiedad FRAME_PER_SECOND . Por defecto, este valor es 5.

      Los valores permitidos SOn 1, 2, 3, 4 o5.

      Disminuir el número de cuadros por segundo reduce el tamaño del archivo, la cpu y la ram.

      Recuadros por segundo Reducción de cuadros Impact en\n el tamaño de archivo/ancho de banda, CPU, & RAM (Estimado)

      5

      Predeterminado (máximo)

      Ninguno

      4

      20% menos

      ~15% de reducción

      3

      40% menos

      ~30% de reducción

      2

      60% menos

      ~45% de reducción

      1

      80 % menos

      ~60% de reducción

    • Cambie o agregue el valor de la propiedad RESOLUTION_LEVEL. De forma predeterminada, este valor es null, la Resolución de pantalla actual.

      Los valores permitidos SOn nulo, bajo, medio o alto (insensible a mayúsculas y minúsculas).

      Disminuir la resolución reduce el tamaño del archivo, la CPU y la RAM.

      Nivel de resolución Reducción de Resolución Impacto en el tamaño de archivo/ancho de banda, cpu y ram (estimado)

      Null

      Predeterminada (resolución de pantalla actual)

      Ninguno

      Alta

      Resolución de pantalla / 1.5

      ~20% de reducción

      Media

      Resolución de pantalla / 2

      ~40% de reducción

      Baja

      Resolución de pantalla / 4

      ~60% de reducción (recomendado solo para pantallas 4K y 5K)

      Para restablecer a la resolución de la pantalla, cambie el valor de RESOLUTION_LEVEL a null.

    • Cambie el valor de loadCertificates en la sección [others]. Por defecto este valor es verdadero.

      Los valores aceptables SOn verdadero o falso.

  3. Guarde el archivo config.json.

  4. Para aplicar los cambios, reinicie la aplicación Advanced ScreenAgent:

    1. En el administrador de tareas de Windows, finalice la tarea ScreenAgentWatchDog.exe actual y luego finalice los procesos ScreenAgent.exe.

    2. Desde la carpeta de instalación de ScreenAgent, ejecute ScreenAgentWatchdog.exe.

Conserve su configuración al instalar Advanced ScreenAgent

Cuando instala una nueva versión de Advanced ScreenAgent o actualiza de Basic a Advanced ScreenAgent, el instalador conserva su configuración existente de manera predeterminada. Este comportamiento se controla mediante el parámetro KEEP_CURRENT_CONFIG en Parámetros del comando de instalación.

El valor predeterminado es true. Cuando KEEP_CURRENT_CONFIG=true , el instalador usa su configuración existente. Si KEEP_CURRENT_CONFIG=false, el instalador ignora toda la configuración existente, incluidos los datos básicos de ScreenAgent. Escribe una nueva configuración utilizando únicamente los valores que usted proporciona en INSTALL_PARAMS.

Para conservar sus configuraciones existentes durante la actualización:

  1. Complete los pasos en Instalar Advanced ScreenAgent

  2. Agregue el parámetro KEEP_CURRENT_CONFIG=true al Símbolo del sistema.

  3. Complete los pasos de instalación restantes.

Permisos

ScreenAgent requiere los siguientes permisos mientras se ejecuta:

  • Acceso a archivos

    • Acceso de lectura y escritura a %appdata%\ScreenAgent\

    • Acceso de lectura/escritura a la carpeta de instalación:
      Para Basic ScreenAgent - C:\Program Files\NICE-InContact\ScreenAgent) (Esta ruta es configurable.)

      Para Advanced ScreenAgent - C:\Program Files\NICE CXone\AdvancedScreenAgent (Esta ruta es configurable.)

  • Acceso condicional (según la configuración de RESOLVE_USER)

    • If RESOLVE_USER=auto (default):

    • Si RESOLVE_USER=oslogin:

      • Leer variables de entorno (requerido para Inicio de sesión en sistema operativo)

  • Permisos adicionales (si se utiliza una lista de denegación)

    • Recuperar información sobre otros procesos visibles que se están ejecutando

    • Interactuar con elementos de ventana de otros procesos (para capturar URL)

Las claves de registro se acceden solo durante la instalación o la desinstalación. No se requiere acceso al registro durante la operación normal.

ScreenAgent Herramienta de comprobación de conectividad

Utilice la herramienta de verificación de conectividad ScreenAgent para ejecutar una secuencia de pruebas y comprobar el acceso a la red, y asegurarse de que ScreenAgent para Windows y Advanced ScreenAgent para Windows funcionen correctamente.

  • Puede usar la herramienta antes o después de instalar ScreenAgent.

  • Puede descargar la última versión de la herramienta de comprobación de conectividad desde la página de descargas.

  • Es recomendable usar esta herramienta cuando la configuración de red de los agentes se ha modificado o difiere de la configuración habitual. No es necesario ejecutar la herramienta para cada agente.

  • Puede ejecutar la herramienta de comprobación de conectividad de forma múltiple utilizando el mismo comando.

  • Después de cada ejecución de prueba, aparece una notificación de éxito o fracaso. Al final de la ejecución, se muestra un resumen con el estado de cada prueba.

  • Una vez finalizadas las pruebas, la herramienta de comprobación de conectividad crea un archivo de registro.

  1. Descargue el archivo EXE de la herramienta de comprobación de conectividad:

    1. Vaya a NiCE CXone e inicie sesión como usuario con el permiso Puede acceder a descargas de soporte.

    2. Haga clic en su Nombre DE usuario y seleccione Soporte y descargas.

    3. Descargue el archivo EXE requerido. Tenga en cuenta el lugar donde descarga el archivo EXE, ya que necesitará la ubicación del archivo más adelante.

  2. Ejecute la herramienta Connectivity Check.

    1. Ejecute el símbolo del sistema como Administrador.

    2. Copie y pegue el comando en el símbolo del sistema y edite los parámetros enumerados en la tabla.

      <Ruta al archivo exe> ACCESS_KEY_ID=<ID de clave DE acceso> ACCESS_KEY_SECRET=<clave DE acceso secreta> REGION_TYPE=<subdominio (los primeros 3 caracteres) de la URL de NiCE CXone> WEB_PROXY=<opcional: URL del servidor proxy>

    Comando de ejemplo:

    C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088
  3. La herramienta de verificación de conectividad comienza a ejecutar las pruebas. Después de cada ejecución de prueba, aparece una notificación de éxito o fracaso. Si una prueba falla, se muestra el motivo del fallo. Al finalizar la ejecución, se muestra un resumen que indica si cada prueba se aprobó, falló o no necesitó ejecutarse (N/A). Por ejemplo, si ScreenAgent no se estaba ejecutando en segundo plano cuando la herramienta de verificación de conectividad se inició, las pruebas para cerrar ScreenAgent y reiniciarlo no necesitan ejecutarse.

    Después de completar las pruebas, la herramienta de verificación de conectividad crea un archivo de registro (SA_Connectivity_tool_log_<runUniqueUUID>) en la misma carpeta que el archivo de instalación de la herramienta de verificación de conectividad. El archivo de registro contiene toda la información que aparecía en el símbolo del sistema.

Pruebas de conectividad

Configurar ScreenAgent en un Entorno de Abonado múltiple

En un entorno con Múltiples abonados, cada agente tiene su propia ACCESS_KEY y SECRET_KEY específica del abonado con el que está trabajando. Se admiten múltiples abonados para aquellos que residen en la misma región.

Este procedimiento utiliza Microsoft Directorio Activo, y la configuración puede ser diferente para otras soluciones de servicios de directorio.

Para configurar Active Directory para múltiples abonados:

  1. Cree un archivo JSON para cada abonado que administre:

    • Cada archivo debe incluir el ID de accessKey y AccessKey Secret del abonado.

      Por ejemplo, si administra el Abonado A y el Abonado B, podría nombrarlos TenantA_connection.json y TenantB_connection.json (o cualquier nombre que sea significativo para sus necesidades específicas).

    • Los miembros de cada abonado deben tener acceso al archivo importante. Por ejemplo, todos los usuarios del Abonado A mencionado anteriormente deben tener acceso al TenantA_connection.json.

    Utilice la siguiente estructura para cada archivo. Los valores de los parámetros deben ser únicos para cada abonado.

    var(--codeSnippetCopyLabel)
    {
      "accessKeyId": "{{ACCESS_KEY}}",
      "accessKeySecret": "{{SECRET_KEY}}"
    }
  2. Coloque estos archivos en algún lugar de su red donde todos los usuarios del abonado puedan acceder a ellos. Por ejemplo, cree una carpeta en un servidor de archivos (como \\\\fileserver\\compartido\\files\\).

    Cada abonado puede contar con su propia carpeta compartida.

  3. Cree un grupo de Seguridad para los usuarios de cada abonado en Active Directory siguiendo los pasos a continuación:

    1. En la máquina del controlador de Dominio, abra la consola Usuarios y equipos de Active Directorio.

    2. Haga clic con el botón derecho en la Unidad organizativa (OU) donde desea crear los grupos (Users de forma predeterminada) y seleccione New > Group.

    3. Especificar el nombre de grupo. Por ejemplo, UsersGroup_TenantA.

    4. Seleccione las opciones global scope y Security.

    5. Haga clic en Aceptar.

    6. Haga clic con el botón derecho en el grupo de seguridad recién creado y seleccione Properties.

    7. En la pestaña Miembros, agregue todos los usuarios correspondientes a este abonado.

    8. Haga clic en Aceptar para completar los cambios.

    9. Repetir los pasos anteriores para crear un grupo de Seguridad para cada abonado.

  4. Cree un Objeto de política de grupo (GPO) con políticas para la distribución de Archivos que cubra todos los abonados:

    1. Abra el GPO Console.

    2. Haga clic con el botón derecho en el Dominio o en la OU donde se encuentran los usuarios y seleccione Create a GPO.

    3. Especificar un nombre para el GPO (por ejemplo, Tenant_Files_Distribution) y haga clic en Aceptar.

    4. Haga clic con el botón derecho en la GPO que acaba de crear y seleccione Editar para abrir el editor de Gestión de políticas de grupo.

    5. Vaya a User Configuration > Preferencias > Configuración de Windows > Archivos.

    6. Cree una nueva acción de Archivo para cada abonado independiente haciendo clic derecho en Archivos y seleccione Nuevo > Archivo.

    7. A continuación, configure los siguientes ajustes de File:

      1. En Acción, seleccione Actualizar.

      2. En Archivo(s) de origen, ingrese la ruta de red al archivo JSON específico creado para el abonado al principio de este procedimiento (por ejemplo, \\fileserver\shared\files\TenantA_connection.JSON).

      3. Debajo de Archivo de destino, ingrese: %appdata%\ScreenAgent\TenantA_connection.json

    8. En la pestaña Común, seleccione Targeting de nivel de Elemento y haga clic en Targeting….

    9. En la ventana Targeting editor, haga clic en Elemento nuevo y seleccione Grupo de Seguridad.

    10. En el campo Group, especifique el Users Group creado anteriormente para el Abonado correspondiente (por ejemplo, UsersGroup_TenantA).

    11. Haga clic en Aceptar para completar la configuración.

    12. Repita los pasos para crear una acción de File para cada abonado distinto con su propio archivo JSON.

  5. Para aplicar y actualizar la política de grupo, ejecute gpupdate/force en el servidor o espere al siguiente ciclo de actualización de la política de grupo.

  6. Cada usuario debe desconectarse de su sesión actual y luego volver a iniciar sesión en su cuenta de usuario en su máquina para asegurarse de que todos los cambios surtan efecto.

Parámetros del comando de instalación

El parámetro

Descripción

Ejemplo

msiexec /i ScreenAgent-32bit-<versión de MSI>.msi

32 bits o 64 bits

Si está instalando en una computadora con:

  • Windows de 32 bits instalado, ingrese 32 bits

  • Windows de 64 bits instalado, ingrese 64 bits

Versión MSI

Introduzca la versión MSI del archivo de instalación que descargó desde la página Soporte y descargas. Por ejemplo, 3.0.22.

msiexec /i ScreenAgent-64bit-3.0.22.msi

 

msiexec /i ScreenAgent-32bit-3.0.22.msi

KEEP_CURRENT_CONFIG

(Opcional) Incluya este parámetro al actualizar de ScreenAgent básico a avanzado, al reinstalar o al instalar una versión nueva.

Cuando KEEP_CURRENT_CONFIG=true (valor predeterminado), el instalador utiliza su configuración existente.

Cuando KEEP_CURRENT_CONFIG=false, el instalador ignora su configuración existente y utiliza los valores especificados en el comando de instalación. Para cualquier parámetro que no se especifique, el instalador utiliza los valores predeterminados. Este comportamiento también se utiliza para una instalación limpia.

Para más información, consulte Use this command: y Conserve su configuración al instalar Advanced ScreenAgent.

KEEP_CURRENT_CONFIG=true

INSTALL_PATH

(Opcional) Puede especificar la ruta de instalación. Los archivos de instalación se guardarán en la carpeta \NICE-InContact\ScreenAgent dentro de la ruta de instalación especificada.

Si no agrega este parámetro, ScreenAgent se instalará con la ruta de instalación predeterminada en la unidad C, incluso cuando KEEP_CURRENT_CONFIG= true.

INSTALL_PATH=d:\newdir

ACCESS_KEY_ID

Pegar el ID de clave DE acceso creado en la cuenta de Empleado. Para generar una clave DE acceso, consulte Genere una clave DE acceso para ScreenAgent.

ACCESS_KEY_ID=ABCDEF12345====

Secreto_Clave_DE_ACCESO

Pegue la clave DE acceso secreta creada en la cuenta de Empleado.

En un entorno multiabonado, si más que un agente está usando la misma máquina, siga las instrucciones para Configurar ScreenAgent en un Entorno de Abonado múltiple. Para ser terminado, completado para el sprint 167 - CXREC-65707

ACCESS_KEY_SECRET=12345ABCDEF

REGION_TYPE

Ingrese el subdominio (los primeros 3 caracteres) de su URL de NiCE CXone (por ejemplo: na1, na2, au1, eu1)

REGION_TYPE=na1

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

Si no quiere que ScreenAgent recopile datos, es posible cambiar este valor a false.

Los valores permitidos SOn true y false.

Puede cambiar esta configuración después de la instalación.

STATISTICS=true

WEB_PROXY

Solo incluya este parámetro si está utilizando un servidor proxy para conectarse a Internet.

Mantenga en cuenta:

  • Anfitrión puede ser nombre de host o IP

  • Use http o https de acuerdo con su configuración de proxy

  • Utilice nombre DE usuario y contraseña del servidor si está configurado en la configuración de proxy

Por ejemplo:

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

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

  • https: // host: puerto

Cuando esté utilizando una URL de proxy que funcione con un archivo pac de proxy, agregue el prefijo pac+ delante de la URL de proxy; por ejemplo, si la URL de proxy es https://<proxy server>.pac, utilice:

WEB_PROXY=pac+https://<servidor proxy>.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 el Inicio de sesión en sistema operativo del agente. En este modo, ScreenAgent se conecta al servidor con la información de Inicio de sesión en sistema operativo del agente y puede trabajar en configuraciones avanzadas, como Engagement Hub (Multi-ACD/Open), entornos de sesiones múltiples y más. Cuando se usa el Inicio de sesión en sistema operativo, ScreenAgent no usa el puerto 31322.

Si no agrega este parámetro, ScreenAgent se instala con el valor predeterminado, auto, y depende de los clientes NiCE CXone (MAX, Agent Workspace (Agent), y así sucesivamente) para conectarse al servidor. En este modo, ScreenAgent usa el puerto 31322 para conectarse al cliente NiCE CXone.

El Inicio de sesión en sistema operativo del agente se define en la Pestaña general de la configuración del Empleado en el formato Domain\Username.

  • For Engagement Hub (Multi-ACD/Open) environments, este parámetro debe configurarse con el valor oslogin .

    Esto permitirá que el cliente Screen Agent lea el Inicio de sesión en sistema operativo del Agente desde el sistema operativo.

  • Los clientes que tienen múltiples agentes trabajando en la misma máquina (no en paralelo) deben usar la configuración de OSLogin. Si la configuración de OSLogin no es posible, los agentes deben desconectarse de Windows al final de su turno para que ScreenAgent funcione correctamente para el siguiente agente que inicie sesión en esa máquina.

RESOLVE_USER=oslogin

FRAME_PER_SECOND

(Opcional) Puede establecer la cantidad de fotogramas grabados por segundo para el archivo MP4 de salida. Si no agrega este parámetro, ScreenAgent se instala con el valor predeterminado, 5 fotogramas por segundo.

Los valores permitidos SOn 1, 2, 3, 4 o5. Disminuir el número de cuadros por segundo reduce el tamaño del archivo, el ancho de banda, la CPU y la RAM.

Puede cambiar esta configuración después de la instalación.

FRAME_PER_SECOND=3

RESOLUTION_LEVEL

(Opcional) Puede configurar la resolución del archivo MP4 grabado para optimizar el consumo de RAM y CPU. Si no agrega este parámetro, ScreenAgent se instala con la configuración de resolución predeterminada, null, la resolución de pantalla actual.

Los valores permitidos SOn nulo, bajo, medio o alto (insensible a mayúsculas y minúsculas). Reducir la resolución disminuye el tamaño del archivo, cpu y ram.

Puede cambiar esta configuración después de la instalación.

RESOLUTION_LEVEL=low

LOAD_CERTIFICATES

(Opcional) Defina este parámetro como falso si ScreenAgent no debe acceder y cargar certificados autofirmados de la tienda de certificados de Windows.

Los valores aceptables SOn verdadero o falso.

Si no agrega este parámetro, ScreenAgent accede a los certificados autofirmados de la tienda de certificados de Windows.

Puede cambiar esta configuración después de la instalación.

LOAD_CERTIFICATES=false

/log install.log

Imprime los resultados de la instalación en el archivo de registro.

/log install.log

/quiet

(Opcional) Incluir si desea suprimir ventanas emergentes durante la instalación. Podrá ver los resultados de la instalación en el archivo de registro.

/quiet

SHOW_NOTIFICATIONS

(Opcional) Muestra a los agentes una breve notificación de escritorio desde el icono de la bandeja cuando se inicia o se detiene la grabación de pantalla, y cuando se inicia o se detiene el enmascaramiento de pantalla.

Predeterminado: falso

Configúrelo como true para activar las notificaciones.

Este parámetro se aplica solo a Advanced ScreenAgent.

SHOW_NOTIFICATIONS=true

Información posterior a la desinstalación

Cuando desinstala ScreenAgent de una máquina cliente, los elementos en el sistema:

  • Contenido de la carpeta AppData: Se conserva la totalidad de la carpeta %AppData%\ScreenAgent\, incluidos los registros y los archivos de configuración.

  • Carpeta de instalación: La carpeta ubicada en ...\Program Files\NICE-InContact\ScreenAgent o C:\Program Files\NICE CXone\AdvancedScreenAgent permanece, pero su contenido se elimina durante el proceso de desinstalación.

Estos archivos y carpetas residuales:

  • No interfiera con una instalación nueva o actualizada de ScreenAgent.

  • Se puede eliminar manualmente si es necesario, si se requiere un entorno completamente limpio.

Si desea eliminar todo rastro de ScreenAgent, asegúrese de que estas carpetas se eliminen manualmente después de la desinstalación.