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

To use the YMCS APIs to monitor your **Yealink devices**, you need to:  
  * Have access to YMCS ([[https://eu.ymcs.yealink.com/manager/login]])
  * Enable the APIs in YMCS
  * Declare an external service of type "Yealink YMCS" in Zebrix Control
  * Create and configure your devices  

=== Enable the APIs in YMCS? ?  ===

Go to the YMCS login interface and log in

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

Then choose "Device Management"

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

Then go to **System > Integration > API** 

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

You will be able to store the **AccessKey ID (Client ID)** and **AccessKey Secret (Client Secret)** to configure the driver in Zebrix Control. 

=== How to retrieve the device ID?  ===

Go to YMCS device list **Room Device > Device List**

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

When you click on a device, the equipment ID appears in the URL (below XXXXXXXXX), for example:
https://eu.ymcs.yealink.com/manager/mvc-product/device/mvcDetail?type=0&id=XXXXXXXXX&mac=YYYYYYYYY

With this method, you can easily retrieve the ID of your Yealink YMCS equipment to integrate it into your monitoring.

=== Declare an external service of type "Yealink YMCS" in Zebrix Control === 

Let's configure the external service within the Zebrix Control administration interface:

  * **Driver** : Yealink YMCS
  * **Client ID** : Use the **AccessKey ID (Client ID)** previously obtained.
  * **Client Secret**: Use the **AccessKey Secret (Client Secret)** previously obtained.
  * **API Region**: Based on the region where your YMCS tenant is hosted (e.g., eu-api, au-api, or us-api).
{{.:pasted:20260223-112510.png}}

=== Driver Configuration in Zebrix Control === 
Let's configure the driver within the Zebrix Control administration interface:

{{.:pasted:20260223-112156.png}}
Your videoconferencing equipment has now been added as equipment within Zebrix Control.

=== Port Opening ===
The probe must be able to establish outbound connections (https, 443) to 'https://API_REGION.ymcs.yealink.com/v2' where API_REGION is the region of the Yealink device.



Contact Zebrix Support for further information.