==== Cisco Control Hub ====

=== Configuration Service App ===

== Creation of the application ==
To create an application you must be logged in to developer.webex.com with admin rights.
  * Go to [[https://developer.webex.com/my-apps/new/service-app|Create a Service App]]
{{ :fr:guide:cisco:pasted:20250311-143208.png?600 }}
  * Fill all mandatory fields
  * Select the 3 //scopes//
    * spark-admin:devices_read
    * spark:xapi_statuses
    * spark:xapi_commands
  * Click on **Add Service App** at the bottom of the page

== Autorization of the application ==
  * Generate an authorization request to the application by clicking on Request admin authorization
{{ :fr:guide:cisco:pasted:20250311-154103.png?600 }}

{{ :fr:guide:cisco:pasted:20250311-153925.png?600 }}

  * Copy Client ID and Client Secret
{{ :fr:guide:cisco:pasted:20250311-154140.png?600 }}

  * Ask a Webex domain administrator to authorize the app from the control hub
Clic on App > Services App
Clic on the app created
{{ :fr:guide:cisco:pasted:20250311-155438.png?600 }}

  * Select Autorization
{{ :fr:guide:cisco:pasted:20250311-155620.png?600 }}



== Token generation ==
Once the application is autorized, generate a token.
  * Connecte to :  https://developer.webex.com/my-apps
{{ :fr:guide:cisco:pasted:20250311-152346.png }}
  * Clic on the app created
  * In the Org Authorizations section, select the organization,
  * Enter the **Client Secret** initially copied, then click **Generate tokens**
{{ :en:guide:cisco:pasted:20250311-164109.png }}

  * Keep the **Access Token** and **Refresh Token**
{{ :fr:guide:cisco:pasted:20250311-161923.png }}

=== Configure the Service App in Zebrix Control ===
  * Go to Configuration > External Services
  * Add an external service
  * Select Cisco ControlHub type
  * Enter Client ID, Client Secret and Refresh token
{{ :fr:guide:cisco:pasted:20250311-162504.png }}

Setup is complete

=== How to retrieve the device ID (Driver configuration) ? ===

There are several methods to retrieve the Webex device ID.

== API Request ==

You can retrieve it on [[https://developer.webex.com/docs/api/v1/devices/list-devices|List Webex device API]]

== PowerShell script ==

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

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

== Control Hub ==

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

Click on **View all statuses**
{{ .:pasted:20250619-111050.png }}
Go to **Webex** section
{{ .:pasted:20250619-111332.png }}
The ID you are looking for is the **Webex DeveloperId**.



=== Port Opening ===
The probe must be able to establish outbound connections (https, 443) to 'https://webexapis.com/v1/'.

==== Equipments Configuration ====

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.
{{ .:pasted:20251226-134016.png }}

Contact Zebrix Control support for more informations