Skip to main content
Skip table of contents

Webex CC Native Recording Integration

Cisco Webex Contact Center infrastructure provides own audio convenience recording feature, where WXCC agents can be enabled for on-demand or always-on recording.

Recorded conversations are stored in Cisco WXCC Cloud for a limited period of time, with a limited access available to administrators and single users.

That’s why Imagicle proposes the import of such WXCC Recorder conversations from Cisco Cloud to Imagicle Cloud, supporting unlimited retention and multiple permission levels for standard users, group supervisors and administrators.

Moreover, Imagicle Call Recording provides an enhanced web portal and Agent Desktop gadget to browse and listen to recorded conversations, with search features and call tagging for Legal Hold.

Integration Requirements

  • Imagicle UCX Cloud Suite must be in place, with Call Recording Essentials (or greater) license activated.

  • A Webex Full Admin account, to apply configurations on Control Hub

  • Agents to be enabled for WXCC/Imagicle Call Recording must have a Webex Professional license at least.

Limitations

As per Cisco documentation, Calls on Webex can't be recorded because they are not Webex Calling calls. These are the calls made using webex client, selecting "Call on webex" and not the user's phone number. Please note that a recording solution for this kind of calls doesn't currently exist.

Check for Webex Contact Center Recorder enablement

Please access to Webex Contact Center Management Portal with admin credentials and click on Recording Management from left panel. The following page appears:

image-20250523-064754.png

If the native WXCC Recorder is enabled, here you can find some recorded conversations performed by agents. If that’s the case, you can proceed with next steps.

Configurations from Webex Control Hub

Please access to Cisco Webex Control Hub with Full Admin credentials and go to Account from left panel and, within "Info" tab, take note of Organization ID. It is required later on in this procedure:

Now click on Users menu item from left panel:

image-20250523-072111.png

Please locate a local user within customer’s domain which should be elected to “Compliance Officer”, to allow the required integrations. Click on selected user to access the Summary page:

image-20250523-072536.png

Click on Administrator roles and make sure that user has Organizational Read-only admin permissions; moreover, the user must have Compliance officer and Webex Calling Detailed Call History API access roles. See below sample:

image-20250523-072925.png

Save new roles setting.

Now click on Contact Center menu item from left panel:

image-20250523-065619.png

From Contact Center main page, select General left menu item and collect the “Country of operation”. This is required later on in this procedure:

image-20250523-070137.png

Now select Call Recording Schedules left menu item to access to global recording settings applied to all agents or for a specific team of agents. Within this page, you can create a new schedule or amend an existing one. See below sample, where “always-on” schedule is created:

image-20250523-075109.png

From Recording Schedule you can tweak several parameters like:

  • Date/time intervals where calls are recorded

  • Enable pause/resume

  • Define the percentage of calls to be recorded. If a value below 100% is selected, the “on-demand” buttons to start/stop recording are enabled on Agent Desktop client.

  • Apply filters by Sites, Teams, Agents, etc.

Multiple Call Recording Schedules can be created, for different agents' teams.

Configurations from Webex Developers Portal

Please access to Cisco Webex Developers Portal by using the Compliance Officer account credentials, click on top-right account icon and select My Webex Apps from pull-down menu:

image-20250523-081251.png

A list of existing apps appears. Just click on Create a New App button:

image-20250523-081522.png

The portal invites you to select the app type among different options. Please click on Create an Integration:

image-20250523-081759.png

The following page appears:

image-20250523-082017.png

Enter the following data: 

  • Integration use a mobile SDK : No 

  • Integration name : the name you prefer (like Imagicle Recorder)

  • Select an icon or upload the one you prefer

  • App Hub Description: a description of the app (like “Imagicle Integration to retrieve Webex Contact Center Recordings”)

Scroll down for more parameters:

image-20250523-085024.png

Enter two Redirect URI(s)

and select the following Scopes:

  • spark-admin:people_read

  • spark-admin:telephony_config_read

  • spark-admin:organizations_read

Once done, validate by clicking on Add Integration. See below resulting web page sample:

image-20250523-103703.png

Please copy now the Client ID and Client Secret. They are required later on in this procedure.

Configurations from Webex CC Developers Portal

Please access to Cisco Webex CC Developers Portal by using the Compliance Officer account credentials, click on top-right account icon and select My Webex Apps from pull-down menu:

image-20250523-104057.png

Please click on previously created integration, to display its data and add a new Scope: cjp:config_read

image-20250523-105037.png

Hit Save and refresh the web page.

Now you can collect the OAuth Authorization URL available on top of the page, making sure it includes the last added Scope:

image-20250523-105735.png

Authorize the Integration

Copy above OAuth Authorization URL into an incognito/private web browser panel and hit enter.

Login with admin credentials to display the authorize page:

image-20250523-135311.png

When you click Accept button, you are redirected to the following web form:

image-20250523-135846.png

Please insert the Client ID and Client Secret you collected earlier and hit Request Access Token button. Copy both Access and Refresh Token.

Configurations from Imagicle UCX Cloud Platform web portal

Imagicle team creates a local service user account with username=wxccrecorder. This account is used to retrieve recording audio files from Webex CC cloud.

Please make sure you are not deleting or changing the password for that user without notifying Imagicle

Make sure that the all recording-enabled users on the Imagicle UCX Suite web portal have set "PBX username" field with user’s UPN (same as "email" field). More details here.

Final Stage

Please send to Imagicle Support the following details:

  • Webex Org ID

  • Country of operation (region)

  • Integration’s Client ID

  • Integration’s Client Secret

  • Access Token

  • Refresh Token

Imagicle applies required authorizations to retrieve recordings from Cisco Webex CC Cloud, so you can safely access them from Imagicle UCX Cloud Suite web portal.

Call Recording Gadget for Agent Desktop clients

Please be aware that you can enable an Imagicle Call Recording custom tab for your Webex CC users. The procedure is highlighted in this KB.

If the Imagicle gadget displays own buttons to start/stop & pause/resume recording, please ignore them. In a Webex CC environment, recording-related softkeys are already embedded in the native Webex CC Agent Desktop GUI and they appear when required.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.