Microsoft Teams Integration

  • Published on Oct 31, 2025
  • 2 minute(s) read
  • s
  • s
 Prev Next

The Teams connector is a cloud-to-cloud connector that allows WXP collaboration to retrieve MS Teams data and call record information. WXP Collaboration uses the OAuth protocol to authenticate and collect data from Microsoft Teams.

Prerequisite

Global administrator Access is required - The authorizing user must have Global Administrator access within the Microsoft Teams tenant to authorize WXP Collaboration data collection.

Required Scopes

WXP Collaboration uses the Microsoft Graph API to retrieve data related to:

  • Calls made using Microsoft Teams.
  • Microsoft Teams Rooms data.

During authorization, WXP Collaboration requests the following scopes:

Scope Permission Microsoft Reference
User.Read.All Allows WXP Collaboration to read users profiles.
User.Read Allows WXP Collaboration to sign-in to the app and allows the app to read the profile of the signed-in users. It also allows the app to read basic company information of sign-in users. Link
TeamworkDevice.Read.All Allows WXP Collaboration to read the management data for Teams devices. Link
CallRecords.Read.All Allows WXP Collaboration to read call records for all calls and online meetings Link

Creating the Teams Infrastructure

To integrate Microsoft Teams with WXP Collaboration, follow these steps:

  1. Log in to WXP Collaboration using an account with Admin privileges.
  2. From the Product Selection menu, select Admin Portal.

image.png

  1. In the Admin Portal, go to Infrastructure > New Infrastructure.
  2. Select Microsoft Teams.

image.png

  1. In the Name and Description, enter values.
Note

The Graph API URL field is pre-populated and cannot be modified.

image.png

  1. Click Save to create the infrastructure.

Authorizing Microsoft Teams

Once the infrastructure is created, follow the steps below to authorize access using OAuth:

  1. Scroll down to the MSTEAMS Authorization section and expand it.
    image.png

  2. Click CLICK TO AUTHORIZE.

  3. On the Microsoft login prompt, enter the credentials of a user with the Global Administrator role.

  4. After a successful login, a confirmation screen is displayed.
    image.png

  5. Click Accept for the permissions.

  6. You will be redirected back to the WXP Collaboration Infrastructure page. The MSTEAMS Authorization field will now be populated.
    The Microsoft Teams integration will be automatically enabled.
    image.png

Note

When you try to validate immediately after a successful authorization, there is a chance you may hit the following validation error. “com.vyopta.msteams.master.MsTeamsDataCollector: java.io.IOException: REST API call failed: https://graph.microsoft.com/v1.0/users returned 403: Forbidden”. This is expected as Microsoft takes anywhere between 10 mins to 2 hrs to enable the API integration within their application systems. In the event of this failed validation, you may still be able to enable the system after accepting a warning message to continue enabling the system. If not, please try to validate and enable once again after 2 hours, at which time you should have a successful validation for your Microsoft Teams collection.

Contact Us

For any assistance, create a support case or email support@wxp.hp.com.

Related articles