==== Microsoft Teams Room ====

To use Microsoft's APIs to monitor your **MTR (Microsoft Teams Rooms)**, you need to:  
  * Create an **Azure AD application** and assign the appropriate permissions.  
  * Declare an **external service** of type **Ms Graph** in **Zebrix Control**.  
  * Create and configure your **devices**.  

Start by creating the Azure AD application and the external service by following this guide:  
[[en:guide:microsoft:ms_graph|Ms Graph External Service]] \\  

Then, add the devices by configuring their **MTR drivers**:  
  - **Device ID**: The device ID from Microsoft  
  - **Zebrix Control External service name** compatible with **MS Graph**  



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

You can use one of the following methods:  

== Using Microsoft Graph API ==  
Use **PowerShell** or another language to call the endpoint (in beta):  

`https://graph.microsoft.com/beta/teamwork/devices`  

Example in **PowerShell**:  
<code>
$token = "YOUR_ACCESS_TOKEN"
$headers = @{ Authorization = "Bearer $token" }
$devices = Invoke-RestMethod -Method Get -Uri "https://graph.microsoft.com/beta/teamwork/devices" -Headers $headers
$devices | ConvertTo-Json
</code>



== Using Graph Explorer ==  

  * Log in to [[https://developer.microsoft.com/en-us/graph/graph-explorer|Graph Explorer]]  
  * Go to API Explorer  
  * Enable beta APIs  
  * Perform a **GET** request on the **teamwork/devices** API  
  * Find your device in the list and note its **ID**  





{{ :fr:guide:microsoft:pasted:20250226-114557.png }}

Using these methods, you can easily retrieve your Microsoft Teams ID.

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