==== Yealink Management Cloud Service (YMCS) ====

Pour pouvoir utiliser les API de YMCS pour surveiller vos **équipements Yealink**, vous devez :  
  * Avoir un accès à YMCS ([[https://eu.ymcs.yealink.com/manager/login]])
  * Activer les APIs dans YMCS
  * Déclarer dans **Zebrix Control** un **service externe** de type **Yealink YMCS**.  
  * Créer et configurer vos **équipements**.  

=== Activer les APIs dans YMCS ?  ===

Aller sur l'interface de login YMCS et se logger

{{:fr:guide:yealink:pasted:20250324-123748.png?400}}

Puis choisir "Device Management"

{{:fr:guide:yealink:pasted:20250324-124000.png?400}}

Enfin aller dans **System > Integration > API** 

{{.:pasted:20260223-111315.png?800}}

Vous pourrez stocker l'**AccessKey ID (Client ID)** et l'**AccessKey Secret (Client Secret)** pour configurer le driver dans Zebrix Control. 

=== Comment récupérer l'ID de l'équipement ?  ===

Aller dans la liste des équipements **Room Device > Device List**

{{:fr:guide:yealink:pasted:20250324-124802.png?800}}

Lorsque vous cliquez sur un équipement, l'ID de l'équipement apparait dans l'url (ci-dessous XXXXXXXXX), par exemple : 
https://eu.ymcs.yealink.com/manager/mvc-product/device/mvcDetail?type=0&id=XXXXXXXXX&mac=YYYYYYYYY

Avec cette méthode, vous pouvez facilement récupérer l’ID de vos équipement Yealink YMCS pour les intégrer à votre monitoring.

=== Déclarer dans Zebrix Control un service externe de type Yealink YMCS  ===

Configurons le service externe dans l'interface d'administration Zebrix Control :

  * **Driver** : Yealink YMCS
  * **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.
  * **API Region** : En fonction de la région sur laquelle votre tenant YMCS (**eu-api** ou **au-api** ou **us-api**)
{{.:pasted:20260223-112617.png}}

=== Configuration du driver dans Zebrix Control  ===

Configurons le driver dans l'interface d'administration Zebrix Control :
  * L'**ID (XXXXXXXXX)** relevé plus haut dans l'URL YMCS de la page équipement
  * Le **service externe** correspondant

{{.:pasted:20260223-111854.png}}

Votre équipement de visioconférence est maintenant ajouté comme un équipement dans Zebrix Control.

=== Ouverture des ports ===
La sonde doit pouvoir établir une connexion sortante ( HTTPS 443 ) vers l'URL "https://API_REGION.ymcs.yealink.com/v2" où API_REGION est la région de l'appareil Yealink.


Contactez le support Zebrix pour plus d'informations.