Getting Started with CX Analytics
This document will guide you through the process of implementing CX Analytics, the new reporting framework for Zoom Contact Center
Last updated
Was this helpful?
This document will guide you through the process of implementing CX Analytics, the new reporting framework for Zoom Contact Center
Last updated
Was this helpful?
CX Analytics is a new and improved reporting framework for Zoom Contact Center that began populating with live contact center data starting with the May 2025 release of Zoom Contact Center. The purpose of this document is to guide you through the process of implementing CX Analytics.
Legacy Contact Center reporting will continue to populate with data as before. You can continue to use your current reports while you complete the implementation of CX Analytics.
The first step is to provide users with the permission to view the reports and data within CX Analytics. This configuration is performed at the Role level, where all users within a role share the same permissions. Role configuration is performed by navigating to Contact Center Management → Roles in the Zoom admin portal. Note: You must be logged in to the Zoom admin portal as a Contact Center administrator to make changes to roles.
For each role you must define the CX Analytics permissions for users within that role. When configuring a role you will find a new tab labelled CX Analytics in which you will configure view/edit permissions to Reports, Logs and Dashboards, and define the scope of the data which is visible to users within that role.
The CX Analytics tab will allow you to configure the following:
View/Edit permission to Historical Reports, Engagement Logs, and Real-time Dashboards
Data Scope and Visibility for Agents, Queues, Engagements and Flows
There are two types of roles, Default and Custom, which are pre-configured with various default permissions for CX Analytics.
There are three default roles: Admin, Supervisor and Agent.
Default roles are pre-configured with CX Analytics permissions that cannot be modified. These are detailed in the following table.
Admin
View/Edit access to Reports, Logs and Dashboards.
Full data scope and visibility.
Supervisor
View/Edit access to Reports, Logs and Dashboards.
Visibility of Agent, Queue and Engagement data within their own queues/teams.
No visibility of Flow data.
Agent
View access to Reports and Dashboards.
No data scope and visibility.
Custom roles are defined by the administrator and can be created from scratch, or you can create a duplicate of a default role. When duplicating a default role, the new role will inherit the default role's CX Analytics permissions. When creating a new role, CX Analytics permissions are disabled by default and must be enabled by the administrator.
To start using CX Analytics you must identify all roles that require access to reporting and then configure the CX Analytics permissions accordingly. Configure permissions by following the steps defined below.
Navigate to Contact Center Management → Roles.
Click on the role you wish to modify.
Click the CX Analytics tab.
Configure View/Edit permissions to Reports, Dashboards and Logs according to the capabilities required by users assigned to that role.
Configure the Data Scope and Visibility for Agents, Queues, Engagements and Flows according to the visibility required by users assigned to that role.
Scroll to the bottom of the page and click Save.
Repeat the steps above for all roles that require access to CX Analytics.
Once you have configured roles with the necessary permissions to access CX Analytics, you can navigate to the CX Analytics landing page by navigating to Analytics & Reports → CX Analytics.
Reporting is now accessed by navigating to Analytics & Reports and selecting CX Analytics from the drop-down menu. Legacy Contact Center reports and the new CX Analytics are both accessed from this menu.
The next steps will guide you through the following process:
Creating real-time dashboards.
Using default reports and creating custom reports.
Creating subscriptions for automatic distribution of historical reports.
The CX Analytics Dashboards offer contact center users the ability to monitor the performance of the contact center in real-time using customizable dashboards.
To get started you will need to create dashboards to cater for your real-time reporting requirements. This section will guide you through the process of creating a simple dashboard that you can build upon.
Navigate to Dashboards in the left-hand navigation menu. Here you'll find tabs for:
Default dashboards: Pre-defined dashboard templates that are ready to use.
My dashboards: Custom dashboards that you've created.
Shared with me: Dashboards created by others that have been shared with you.
Starred: Dashboards that you have 'starred' as favorite dashboards.
Click +New Dashboard.
Give your new dashboard and name and optional description, then click Add. You will be presented with the dashboard editor where you'll start with a blank report.
Select the Metrics card from the list. You have multiple widgets available in a real-time dashboard:
Metrics card
Gauge
Line Chart / Bar Chart / Pie Chart
Leaderboard
Tabular data table
In the Dataset drop-down select Queue Performance.
Scroll down to the Measure section and drag In-queue waiting into the Selected measure section.
Continue to add further widgets to the dashboard by clicking the +Add Widget drop-down and selecting the required widget from the panel. Configure your required measures as before.
When you've finished adding widgets to the dashboard, click Save followed by View to view your newly created dashboard.
Your custom dashboards can be quickly shared with other users in the Contact Center.
Navigate to Dashboards → My dashboards and select one of your dashboards by clicking the title.
Click the ellipsis on the top right-hand side and then click Share from the drop-down menu.
The Link access section gives you the option to select whether this dashboard is available to collaborators only (the default), or whether it is available to any contact center user.
Use the drop-down on the top left-hand side to select whether you'd like to add users, teams or queues to the list of collaborators, then use the search field on the right to search for associated contact center entities. Make a selection from your search results.
Enter an optional Invite message.
On the bottom right-hand side of the window, click the down arrow and select either Add as viewers or Add as editors depending on the required permissions.
Click the blue button to add the editors/viewers.
Return to step 4 and repeat the process for any additional collaborators.
The CX Analytics reports offer a quick and comprehensive overview of contact center performance. Within the Reports page you'll find tabs for:
Default reports: Pre-configured historical reports that are ready to use.
My reports: Custom historical reports that you've created.
Starred reports: Historical reports that you have 'starred' as favorite reports.
Default reports have been designed to closely resemble the legacy Contact Center reports, giving you the ability to view reports as soon as you begin using CX Analytics. We will explore the ability to create custom reports later in this guide.
Start by navigating to Reports → Default report.
To open a default report simply click the report title from the list. With the report open you can scroll down to view the various widgets available to you within that report.
You can also adjust the default filters that appear at the top of the report, and use the Filters button for more advanced filtering of data.
CX Analytics enables you to create customized reports that are tailored to your requirements. In this section we will guide you through the process of creating a quick example report which will get you started. To create a new report:
Navigate to Reports in the left-hand navigation menu.
Click +New report.
Give the report a name and an optional description.
Select the Queue Inbound dataset from the drop-down list.
Click the Add button. You should be presented with the newly created report ready to start building. On the right-hand side of the report editor you'll find a list of the dimensions and metrics available in your selected dataset.
Click +Add Widget.
Select the Tabular widget.
Scroll down to the General dimension section, then drag and drop the Day dimension into the Group by section.
In the Selected measure section, click +Drop measure here or click to start adding metrics to your report.
Click the check mark next to the Metric Name field to add all fields to your report.
Click Save. At this point you should see some reporting data in the newly created table.
Click the date field in the section labelled Queue enter time to display a date picker. Select the option Month to Date to display all data within the current month, grouped by day.
Click +Add Widget.
Select the Line chart widget.
Scroll down to the General dimension section, then drag and drop the Hour dimension into the X-axis (Dimension) section.
Scroll down to the Measure section, then drag and drop the Queue offered measure into the Y-axis (Measure) section.
Repeat the above steps for any further widgets you'd like to add to the report.
Click Save followed by View to view your new report.
If you would like to make any changes to a default report you can duplicate the report to make a copy, and then edit the copy.
Navigate to Reports in the left-hand navigation menu.
Open a default report that you'd like to customize.
Click the ellipsis on the top right-hand side of the report, then select Duplicate and edit from the drop-down menu.
Enter a name and optional description for the report, then click Confirm.
Click the Edit button.
At this point you can add/remove/edit widgets as needed to customize the report.
When finished, click Save followed by View to view the customized version of the default report. Once the report has been saved it can be found by navigating to Reports → My reports.
Subscriptions provide a way to have an historical report automatically sent to one or more email addresses on a regular basis. To subscribe to a report:
Navigate to Reports in the left-hand navigation menu.
Open the report you'd like to subscribe to. You will find your reports in either the Default report or My reports section.
Click the ellipsis on the top right-hand side of the report, then select Subscription from the drop-down menu.
Complete the form by providing a subscription name, time zone, frequency and delivery format (CSV or XLSX).
In the Email recipients field, enter one or more email addresses separated by commas.
Check the box asking you to confirm that your email addresses are correct.
Click Add to complete the subscription.
Subscriptions can be managed by navigating to CX Analytics → Subscription. You can also delete, duplicate and pause subscriptions if needed.
This document provides you with a foundational knowledge of CX Analytics, how it is configured, and how to create and view real-time and historical reports to monitor the performance of your contact center.
Further information about CX Analytics can be found by visiting the Zoom help center. Links to CX Analytics articles are shown below:
If you have users assigned to default roles and you would like to modify their permissions you must first create a new role or duplicate the default role. Further information about managing Contact Center roles can be found by visiting this .
For more detailed information about creating and managing CX Analytics dashboards please visit our support article which is available at this .
For further information about datasets please visit the section entitled How to view the Zoom Contact Center CX Analytics reports in the support article which is available at this .
