ScreenAgent for ChromeOS

ScreenAgent NICE ScreenAgent is a service that runs on agent desktops that require screen recording. for ChromeOS is available if you have CXone MpowerRecordingAdvanced and a screen recording license.

You need to add and configure screen recording and real-time screen monitoring IWAs (Isolated Web Applications) in your Google Admin Console. ScreenAgent then automatically records activity on your agents' Chromebox or Chromebook during an interaction according to the recording policies. Supervisors and evaluators can also monitor an agent’s activity during an interaction.

Prerequisites

Before setting up ScreenAgent:

1. Check the Connectivity Requirements.

2. Make sure the user setting up ScreenAgent for ChromeOS has Chrome Admin privileges for the Chrome Admin Console.

3. Make sure the user setting up ScreenAgent for ChromeOS (for example, the admin) has these CXone Mpower permissions:

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

4. In CXone Mpower, generate an access key for ScreenAgent.

   The access key receives all the permissions of the CXone Mpower 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 Mpower 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 Security > Roles 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, except Access Key and My Access Key.

      6. Click Save & Activate.

   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. Click Create. You can generate access keys only after you create the account.

   3. Open the ScreenAgent employee again and go to the Security tab. Click Add access key to 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.

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

5. In CXone Mpower, go to Admin > Employees and make sure that the following is defined for each agent in the General tab:

   • OS login for ChromeOS is defined from the agent's email. For example, the OS login for the email, john@company.com, should be entered as company.com\john.

     The OS Login value for each employee profile must be unique. The OS Login value cannot be used for multiple employee profiles, even if some of the duplicate employee profiles are inactive. If multiple employee profiles have the same OS Login value, ScreenAgent will not run for any agent using that OS Login value.

   • The agent has the attribute Can be Recorded (Screen). This attribute is necessary for enabling screen recording, screen monitoring, or both.

Set up ScreenAgent for ChromeOS

Before you begin to set up ScreenAgent for ChromeOS make sure all prerequisites are in place.

Set up ScreenAgent in the Chrome Admin Console in the order given.

Add the screen recording and screen monitoring IWAs:

1. In the Chrome Admin Console, go to Devices > Chrome.

2. Select Apps & extensions.

3. Select the Users & browsers tab.

4. To add the screen recording IWA, hover over the plus + icon and select Add an Isolated Web App.

5. Set the following:

   • Web Bundle ID: 5qpj5uu6nmdigeqdkrlmfo5uqwpedb3ps6skhe6276wciir5h6yaaaic

   • Update Manifest URL: <CXone host domain>/screen-agent-iwa-recording/update.json (The host domain is different for each region, for example: https://na1.nice-incontact.com/screen-agent-iwa-recording/update.json)

   View image

   

6. Click Save.

7. To add the monitoring IWA, hover over the plus + icon and select Add an Isolated Web App.

8. Set the following:

   • Web Bundle ID: alxuw6tyvg7ri6eekczt3magynxwwqeoyndxjmiwuz33dlz6jnjr2aacai

   • Update Manifest URL: <CXone host domain>/screen-agent-iwa-rtm/update.json (The host domain is different for each region, for example: https://na1.nice-incontact.com/screen-agent-iwa-rtm/update.json)

9. Click Save.

 

Configure the screen recording and screen monitoring IWAs:

1. In the Users & browsers tab, click the recording app name and configure the following:

   • Installation policy: Force install + pin to ChromeOS taskbar

   • Launch on login: Force launch and prevent closing

   • Managed configuration: Add CXone Mpower access keys and host domain in the following JSON format:

     {"accessKeyId": "ACCESS_KEY", "accessKeySecret": "SECRET_KEY", "baseUrl": "HOST_DOMAIN"}

     Pay attention to spaces and so on. If the JSON format is not correct, the configuration will not be applied.

     Use a JSON formatter to format the JSON object, then copy and paste it into Managed configuration.

2. Click Save.

3. Click the monitoring app name and configure the same settings as for the recording app.

4. Click Save.

 

The ScreenAgent screen recording and monitoring application windows open automatically when the user logs in.

Recording and monitoring close only when the user logs out.

Add and configure the Chrome ScreenAgent extension for the account:

This Chrome extension brings the user's OS login to their Chromebox or Chromebook.

1. In the Users & browsers tab, hover over the + icon and select Add from Chrome Web Store.

2. Search for NICE CXone ScreenAgent Extension and select it.

3. Click the extension name and set the following:

   Installation policy: Force install + pin to browser toolbar

4. Click Save.

Enable Developer Tools for troubleshooting:

1. Go to Devices > Chrome.

2. Select Settings.

3. Select the User & browser settings tab.

4. Search for Developer tools.

5. In the list of results, click Developer tools settings and select Always allow use of built-in developer tools.

6. Click Save.

Disable End Process in the Task Manager:

1. Go to Devices > Chrome.

2. Select Settings.

3. Select the User & browser settings tab.

4. Search for Task Manager.

5. In the list of results, click Task Manager settings and select Block users from ending processes with the Chrome task manager.

6. Click Save.

Enable screen recording and real-time screen monitoring for the account:

1. Go to Devices > Chrome.

2. Select Web capabilities.

3. To enable screen recording, in the Origin-specific permissions section, select Add origin.

4. Set the following:

   • Origin/site pattern: isolated-app://5qpj5uu6nmdigeqdkrlmfo5uqwpedb3ps6skhe6276wciir5h6yaaaic

   • Screen recording: Allowed

   • Window management: Allowed

5. Click Save.

6. To enable real-time screen monitoring, in the Origin-specific permissions section, select Add origin.

7. Set the following:

   • Origin/site pattern: isolated-app://alxuw6tyvg7ri6eekczt3magynxwwqeoyndxjmiwuz33dlz6jnjr2aacai

   • Screen recording: Allowed

   • Window management: Allowed

8. Click Save.

Troubleshoot ScreenAgent for ChromeOS

To access the ScreenAgentlog file for troubleshooting:

1. On the ChromeOS desktop, click the CXone Mpower ScreenAgent icon .

   The ScreenAgent application window opens.

2. Press Ctrl-Shift-C.

   The DevTools window opens.

3. Select the Console tab. From the right mouse button menu, select Save As.

4. Save the log file and send to the CXone Mpower support team, if required.

ScreenAgent for ChromeOS FAQs