Introduction
The Vantage platform provides robust monitoring and management for AV equipment in meeting rooms. One of its unique features is the ability to integrate with various manufacturer platforms, including Microsoft Teams Rooms through the Microsoft Graph API. This document will guide you on how to integrate Vantage with your Microsoft Teams Rooms.
Pre-requisites
Before you begin, ensure that:
- You have an active Vantage account and licenses for the rooms you wish to monitor.
- Your Microsoft Teams Rooms devices are networked and operational.
- You have administrative access to both your Vantage account and Microsoft Teams admin center.
Steps to Integrate Vantage with Microsoft Teams Rooms
Step 1: Enable Microsoft Teams Integration
- Log in to your Vantage account.
- Click on the profile dropdown and select 'Organisation Settings'
- Navigate to 'Integrations'.
- Find 'Microsoft Teams' and click on 'Add Integration'.
- Click 'Connect Microsoft Teams' begin consent process.
Step 2: Grant Vantage Consent to Access Microsoft 365
- A prompt will appear asking for consent to access your Microsoft 365 data.
- Review the data Vantage requests access to, which will include Teams Rooms devices' health status.
- If you agree, click 'Grant Consent'.
Data collected by integration
| Label | Key | Description | Data Type | Health | Optional | Usage | Options |
|---|---|---|---|---|---|---|---|
| Alias | alias | The sign in address used. | string | ||||
| Activity State | activityState | The activity state of the device. | string | ✔ | |||
| Display Name | displayName | The display name of the device. | string | ||||
| Sign-in Status | signInStatus | The sign-in status of the Teams account. | enum | ✔ | unknown, connected, disconnected | ||
| Camera Status | cameraStatus | The connection status of the room camera. | enum | ✔ | unknown, connected, disconnected | ||
| Network Status | networkStatus | The connection status of the network. | enum | ✔ | unknown, connected, disconnected | ||
| Exchange Status | exchangeStatus | The connection status of the Exchange server. | enum | ✔ | unknown, connected, disconnected | ||
| Display 1 Status | display1Status | The connection status of display 1. | enum | ✔ | unknown, connected, disconnected | ||
| Display 2 Status | display2Status | The connection status of display 2. | enum | ✔ | unknown, connected, disconnected | ||
| Touch Controller Status | touchControllerStatus | The connection status of the touch controller. | enum | ✔ | unknown, connected, disconnected | ||
| Content Camera Status | contentCameraStatus | The connection status of the content camera. | enum | ✔ | unknown, connected, disconnected | ||
| Speaker Status | speakerStatus | The connection status of the speaker. | enum | ✔ | unknown, connected, disconnected | ||
| Conference Speaker Status | conferenceSpeakerStatus | The connection status of the conference speaker. | enum | ✔ | unknown, connected, disconnected | ||
| Microphone Status | microphoneStatus | The connection status of the microphone. | enum | ✔ | unknown, connected, disconnected | ||
| Firmware Version | firmwareVersion | The current firmware version of the device. | string | ||||
| Firmware Available Update | firmwareAvailableUpdate | The available firmware update for the device. | string | ||||
| Teams Client Version | teamsClientVersion | The current Teams client version of the device. | string | ||||
| Teams Client Available Update | teamsClientAvailableUpdate | The available Teams client update for the device. | string | ||||
| Partner Agent Version | partnerAgentVersion | The current version of the partner agent software. | string | ||||
| Partner Agent Available Update | partnerAgentAvailableUpdate | The available update for the partner agent software. | string | ||||
| Company Portal Version | companyPortalVersion | The current version of the Company Portal software. | string | ||||
| Company Portal Available Update | companyPortalAvailableUpdate | The available update for the Company Portal software. | string | ||||
| Operating System Version | operatingSystemVersion | The current version of the operating system. | string | ||||
| Operating System Available Update | operatingSystemAvailableUpdate | The available update for the operating system. | string |