==== Cisco Webex Control Hub avec Workspace Integration ====

Pour pouvoir utiliser les API de Cisco Webex pour surveiller vos **équipements Cisco Webex**, vous devez :  
  * Avoir un accès à Control Hub en tant qu'administrateur ([[https://admin.webex.com]])
  * Activer l'integration Zebrix Control dans Control Hub > Workspace > Integration
  * Déclarer dans **Zebrix Control** un **service externe** de type **Cisco Control Hub with Workspace Integration**.  
  * Créer et configurer vos **équipements**.  


=== Activer l'intégration Zebrix Control dans Control Hub  ===

Commencez par télécharger le fichier d'integration Zebrix : [[https://control.zebrix.net/download/webex/manifest_webex_workspace_zebrix_control.json|Manifest Workspace Integration]]

Une fois authentifié sur le [[https://admin.webex.com|Control Hub]], aller dans Workspace > Integrations

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.18.56.png?400|}}

Puis en cliquant sur le bouton **Add Integration**, choisir **Upload Integration**

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.19.57.png?400|}}

Deposez le fichier d'integration Zebrix (telechargé au debut de cette section (manifest_webex_workspace_zebrix_control.json)

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.20.30.png?400|}}

Cliquez sur **Upload**

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.22.05.png?400|}}

Vous devez **récupérer et stocker dans un endroit sur les Client ID et Secret Oauth** pour l'authentification au service Webex.

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.22.57.png?400|}}

Puis activez l'integration en cliquant sur **Actions > Activate**

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.25.40.png?400|}}

Enfin, vous devrez récupérer l'activation code (JWT)

{{:fr:guide:cisco:control_hub:screenshot_2025-04-01_at_15.26.21.png?400|}}

=== Extraire les données de l'activation code (JWT) ===

Comme expliqué dans [[https://github.com/cisco-ce/workspace-integrations-nodejs?tab=readme-ov-file#prelude-adding-and-activating-an-integration|la documentation Cisco]], pour extraire les champs necessaire pour la configuration du drivers, vous pouvez soit utiliser : 
  * via JWT.io
  * Via un script NodeJS (voir documentation)

Pour la configuration dans Zebrix Control, il vous faudra récuperer les champs suivants : 
  * **oauthUrl**
  * **appUrl**
  * **webexapisBaseUrl**
  * **refreshToken** 


Par exemple, en utilisant JWT.io : 

{{:fr:guide:cisco:control_hub:screenshot_2025-04-07_at_09.21.54.png?400|}}


=== Configuration de le Service Externe (Cisco Control Hub with Workspace Integration) dans Zebrix Control  ===

Configurons le __ Service Externe (Cisco Control Hub with Workspace Integration)__ dans l'interface d'administration Zebrix Control :

  * **Client ID** : Utilisez l'**AccessKey ID (Client ID)** récupéré précédemment.
  * **Client Secret** : Utilisez l'**AccessKey Secret (Client Secret)** récupéré précédemment.
  * **oauthUrl** : Utilisez l'**oauthUrl** récupéré précédemment.
  * **appUrl** : Utilisez l'**appUrl** récupéré précédemment.
  * **webexapisBaseUrl** : Utilisez l'**webexapisBaseUrl** récupéré précédemment.
  * **refreshToken** : Utilisez l'**refreshToken** récupéré précédemment.


Votre Service Externe est maintenant ajouté dans Zebrix Control.


=== Comment récupérer l'ID de l'équipement (configuration du Driver) ? ===

Il existe plusieurs méthode pour récupérer l'ID de l'équipement Webex. 

== Requête API ==

Vous pouvez la récupérer sur la page [[https://developer.webex.com/docs/api/v1/devices/list-devices|List Webex device API]]

== Script PowerShell ==
Nous mettons également à votre disposition un script Powershell permettant de récupérer la liste des équipements et les exporter dans un 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 ==
Connectez vous sur le control Hub et rendez vous sur la page du périphérique concerné.

Cliquez sur **Afficher** tous les statuts
{{ .:pasted:20250619-104634.png }}

Aller dans la section **Webex**
{{ .:pasted:20250619-104820.png }}
L'ID recherché est le **Webex DeveloperId**

**Attention**: le Webex DeveloperId changera à chaque factory reset.


=== Ouverture des ports ===
La sonde doit pouvoir établir une connexion sortante vers les différentes URL configurées : **oauthUrl**, **appUrl** et **webexapisBaseUrl**.

=== Configuration des équipements === 
Afin de permettre la remontée complète des métriques Room Analytics dans Zebrix Control, plusieurs paramètres doivent être activés sur les terminaux Cisco. Ces paramètres garantissent notamment la détection de présence, le comptage de personnes et l’analyse acoustique, même lorsque le terminal n’est pas en appel.
{{.:pasted:20251226-191835.png}}


Contactez le support Zebrix pour plus d'informations.