To be able to use the Cisco Webex APIs to monitor your Cisco Webex devices, you need to:

• Have administrator access to Control Hub (https://admin.webex.com)
• Enable the Zebrix Control integration in Control Hub > Workspace > Integration
• Declare an external service of type Cisco Control Hub with Workspace Integration in Zebrix Control.
• Create and configure your devices.

Beginning by downloading the Zebrix integration file:Manifest Workspace Integration

Once logged in to Control Hub, go to Workspace > Integrations

Then, click the Add Integration button and choose Upload Integration

Drop the Zebrix integration file (downloaded at the beginning of this section manifest_webex_workspace_zebrix_control.json)

Click Upload

You need to retrieve and securely store the OAuth Client ID and Secret for Webex service authentication.

Then activate the integration by clicking Actions > Activate

Finally, you will need to retrieve the activation code (JWT)

As explained in the Cisco documentation, to extract the necessary fields for the driver configuration, you can either use:

• via JWT.io
• Via a NodeJS script (see documentation)

For the configuration in Zebrix Control, you will need to retrieve the following fields:

• oauthUrl
• appUrl
• webexapisBaseUrl
• refreshToken

For example, by using JWT.io :

Let's configure the External Service (Cisco Control Hub with Workspace Integration) driver in the Zebrix Control administration interface:

• Client ID : Use the AccessKey ID (Client ID) retrieved previously.
• Client Secret : Use the AccessKey Secret (Client Secret) retrieved previously.
• oauthUrl : Use the oauthUrl retrieved previously.
• appUrl : Use the appUrl retrieved previously.
• webexapisBaseUrl : Use the webexapisBaseUrl retrieved previously.
• refreshToken : Use the refreshToken retrieved previously.

Your External Service is now added in Zebrix Control.

There are several methods to retrieve the Webex device ID.

You can retrieve it on List Webex device API

We also provide a Powershell script allowing you to retrieve the list of devices and export them into a CSV.

Invoke-WebRequest -Uri "https://control.zebrix.net/download/webex/Get-Devices.ps1" -OutFile "Get-Devices.ps1"
./Get-Devices.ps1 -UseImplicitFlow -AutoExport

Log on to the Control Hub and go to the device page.

Click on View all statuses Go to Webex section The ID you are looking for is the Webex DeveloperId.

The probe must be able to establish outbound connections to the configured URLs: oauthUrl, appUrl, and webexapisBaseUrl.

To enable the full collection of Room Analytics metrics in Zebrix Control, several settings must be activated on Cisco endpoints. These settings ensure features such as presence detection, people counting, and acoustic analysis, even when the endpoint is not in a call.

Contact Zebrix support for more informations.