Microsoft Teams Rooms
| Syncs | Teams Rooms devices & peripheral health |
| Authentication | OAuth 2.0 (Microsoft Entra ID) |
| Direction | Inbound — imports devices into Connect+ |
Syncs Microsoft Teams Rooms via the Teams admin / Pro Management surface so MTR systems and their peripherals appear alongside every other room.
DeprecatedMicrosoft has deprecated the direct Microsoft Teams Rooms (MTR) cloud-to-cloud integration. See the deprecation alternatives for details.
Permissions
The approving user must have administrative privileges on the Microsoft account and perform an OAuth2 flow
The integration only requires basic scopes and collects data only about Microsoft Rooms, no access to users, calendars or other data is required or requested by the integrations.
The following scopes are required to enable the integration:
The first 5 scopes are required for the OAuth2 flow and provide minimal data only about the user performing the flow.
The only permissions required for normal Xyte's operations are
teamworkdevice.read.allwhich only allows access to Team Room Devices and only in Read Only mode.The data does not contain meeting, user or other PII or content information - only hardware device state related information such as "microphone connection state".
Delegate Access
The method by which OAuth2 is setup, is the "Delegate Access" (https://learn.microsoft.com/en-us/entra/identity-platform/v2-oauth2-on-behalf-of-flow).
The user authorizing the connection must be and Administrators, where the authorization flow requests limited scope (as defined above) to "act in the name of" the user.
The user will require an Office365 license during the authorization process (can be removed afterwards).
Collected Information
Not all device types provide all data points.
The collected information might change as Microsoft Teams Rooms APIs are extended.
Health & Connection Status
- General
- Health Status
- Activity State
- Connection Status
- HDMI Ingest Health
- Connection: Connection Status
- Compute Health
- Connection: Connection Status, Last Modified Date & Time
- Login Status
- Skype Connection: Status, Connection Status
- Exchange Connection: Status
Peripheral Status
- Communication Speaker Status
- Content Camera Status
- Display Statuses
- First Display, Second Display, Third Display, Fourth Display
- Microphone Status
- Room Camera Status
- Speaker Status
Software Update Status
- Admin Agent Software Update
- Available Version, Current Version, Software Freshness
- Company Portal Software Update
- Available Version, Current Version, Software Freshness
- Firmware Software Update
- Available Version, Current Version, Software Freshness
- Operating System Software Update
- Available Version, Current Version, Software Freshness
- Partner Agent Software Update
- Available Version, Current Version, Software Freshness
- Teams Client Software Update
- Available Version, Current Version, Software Freshness
Monitored events
- Camera: Connection status
- Exchange: Connection status
- Teams Room: Connection status
- Speaker: Connection status
- Teams: Connection status
- Microphone: Connection status
- Room Status: Issue level
- Skype: Connection status
After you submit, you'll see a confirmation that your credentials were submitted. Authorizing the integration and syncing devices can take up to 72 hours — you'll be notified when it's done.
Having trouble with the Microsoft Teams Rooms connector? Open the Microsoft Teams Rooms troubleshooting guide
Updated 6 days ago
