ScreenAgent for Windows

ScreenAgentClosed NICE ScreenAgent is a service that runs on agent desktops that require screen recording. is available if you have CXone Recording Advanced and a screen recording license.

Install ScreenAgent on computers to record or monitor activity on an agent's screen during an interaction. ScreenAgent runs in the background and automatically records according to the recording policies (see CXone Recording). Supervisors and evaluators can also monitor an agent’s activity during an interaction (see Manage Agents).

You can either install ScreenAgent on agents' computers, or in a virtual desktop infrastructure (VDI) environment. Supported VDIs include VMware Horizon and Citrix Virtual Apps and Desktops (formerly XenApp and XenDesktop). VMware Horizon doesn’t require any special configuration. For Citrix instructions, see Install ScreenAgent.

Install ScreenAgent

You can either install ScreenAgent using a deployment tool or manually on each agent's computer.

If you're using a deployment tool, configure the installation to either:

  • Run with user's rights (user mode/user context)—you don't have to restart the agent's computer.

  • Run with administrative rights—you must restart all agents' computers.

To update installation parameters or upgrade ScreenAgent to a newer version, reinstall the ScreenAgent client. Keep in mind, you should update when agents aren't being recorded. If an agent is on a call during the update, screen recording will stop for that call. After the update, calls will record according to the recording policies/Studio scripts.

To install ScreenAgent:

  1. Check the Port, Domain, Voice, and IP Address Requirements. Keep in mind, ScreenAgent doesn't record if your firewall generates self-signed certificates or strips request headers from HTTPS packets.

  2. If your site uses VDIs, make sure:

    • You're using ScreenAgent V2.1 and up.

    • For Citrix virtual apps mode:

      • Enable a Virtual IP Loopback policy. Add ScreenAgent.exe and Chrome.exe to the Virtual IP virtual loopback programs list. Keep in mind that each program must be listed on a separate line.

      • Install ScreenAgent on the Citrix Virtual Apps server.

    • VMware Horizon and Citrix virtual desktop mode don't require any special configuration.

  3. Check the agent's computer configuration.

  4. Make sure the user who is installing ScreenAgent (for example, the admin) has Admin privileges on the agent's computer.

  5. Make sure the user who is installing ScreenAgent (for example, the admin) has these CXone permissions:

    • Can access support downloadsOn, this allows you to access the Supports - Downloads page.

    • Access KeyCreate, this is to manage access keys for your organization.

  6. Generate an access key for ScreenAgent. You can use the same access key for installing ScreenAgent on all agents' computers in your tenant.

    The access key receives all of the permissions of the CXone user who generates it. If this user is an administrator, then anyone with the access key would have administrator privileges. So for security reasons, first create a CXone user and role for ScreenAgent, and then generate the key with the ScreenAgent user.

    1. Create a role for the ScreenAgent service:

      1. Click the app selector and select Admin.
      2. Go to SecurityRoles and Permissions.

      3. Click New Role.

      4. Give a name for the role, such as ScreenAgent access key.

      5. Remove all permissions for the role.

      6. Save & Activate the profile.

    2. Create an employee for the ScreenAgent service:

      1. Click the app selector and select Admin.
      2. Click Employees.

      3. Click New Employee.

      4. Give a name for the employee, such as ScreenAgent.

      5. From the Primary Role drop-down list, select the ScreenAgent access key role you just created.

      6. On the General tab, clear all the attributes.

      7. Create the ScreenAgent employee (the Access Keys tab only shows after you create the account).

    3. Open the ScreenAgent employee again, then go to the Access Keys tab and generate an access key.

    4. Copy both the Access Key ID and Secret Access Key and save them somewhere safe. If you don't copy the Secret Access Key or if you lose it, you'll need to create a new one. Use this access key ID and secret access key when installing ScreenAgent on all agents' computers.

    5. Activate the ScreenAgent employee account by clicking the Activate Account button in the activation email.

  7. Download the ScreenAgent MSI:

    1. Go to CXone, and log in as a user with the Can access support downloads permission.

    2. Click your Username and select Support and Downloads.

    3. Download the ScreenAgent MSI. Note where you download the MSI to, you'll need the file location later.

  8. Open the command prompt as Administrator. In the command line, navigate to where you downloaded the MSI and enter the installation command with the relevant parameters:

  9. Verify installation success from the log file. The install.log file is in the folder you installed the MSI from, this is typically the %UserProfile%\downloads folder.

    • Verify that the installer has admin privileges.

    • If the agent's computer doesn't have Microsoft .NET Framework 4.0 or higher, then install it.

  10. Record a call and check the ScreenAgent log file. The ScreenAgent.log file is located in the %appdata%\Roaming\ScreenAgent folder. If there were any errors, see Troubleshoot Recordings.