Microsoft Teams Integration

  • Updated on Jan 23, 2026
  • Published on Dec 3, 2025
  • 3 minute(s) read
  • j
  • s
  • s
 Prev Next

NEW: Teams Integration Procedure

Prerequisite

You must have Global Administrator role credentials for authorization purposes.

Note: Due to the recent Microsoft API retirements, WXP Collaboration now leverages Microsoft InTune (Microsoft’s official device management platform) and its APIs to provide necessary details required to maintain your Microsoft Teams Rooms(MTR) inventory and accurately report call and meeting utilization for each device. If some of your MTRs are NOT managed within InTune, we recommend an additional secondary integration that leverages Microsoft CQD to complete your MTR catalogue.

Scope

WXP Collaboration utilizes Microsoft Graph APIs provided by Microsoft to gather call data and Teams Room data:

Scope Type Permission Microsoft Reference
CallRecords.Read.All Application Allows WXP Collaboration to read call records for all calls and online meetings Link
DeviceManagementManagedDevices.Read.All Application Allows WXP Collaboration to read the Intune data for Teams devices. Link
User.Read Delegated Allows WXP Collaboration to sign-in to the app and allows the app to read the profile of the signed-in user. Link
User.Read.All Application Allows WXP Collaboration to read users profiles. Link
TeamworkDevice.Read.All Deprecated by Microsoft as of Dec 2025 Application Allows WXP Collaboration to read the management data for Teams devices. Link

Authorization of Teams Integration

  1. On the WXP Collaboration Admin portal, go to Microsoft Teams Integration page and open the MSTEAMS Authorization dropdown.
  2. Select CLICK TO AUTHORIZE and enter your credentials. You must have a Global Administrator role to authorize.

Picture2.png

  1. In the Permissions window, click Accept. A new window opens. Close the window and refresh the MSTEAMS Authorization page.
  2. After refresh, the MSTEAMS Authorization section displays the Tenant ID and Authorization Token.

Picture2.png

PowerBI Setup and CQD Integration (Optional)

Note: Please perform the following integration if some of your Microsoft Teams Rooms are NOT part of your Intune environment as having additional PowerBI and CQD Integration will ensure all Microsoft Teams Rooms in your environment are catalogued.

Additional Scope

If the PowerBI and CQD integration is done, WXP Collaboration also utilizes PowerBI REST APIs provided by Microsoft to gather Teams Room data.

Scope Type Permission Microsoft Reference
User.Read Delegated Allows WXP Collaboration to sign-in to the app and allows the app to read the profile of the signed-in user. Link
Dataset.Read.All Delegated Allows WXP Collaboration to access the list of datasets from the Workspace defined in PowerBI as per the below procedure Link
Workspace.Read.All Delegated Allows WXP Collaboration to access the shared Workspaces data defined in PowerBI as per the below procedure Link

Part 1 : PowerBI CQD Dataset Workspace Creation and Integration

  1. In app.powerbi.com, create a shared workspace. Suggested name: CQD-API.
  • From the URL, note the workspace (group) ID.
  • Ensure the workspace name includes “CQD.”

Picture3.png

  1. Download MicrosoftCallQuality.pqx to your computer.
    MicrosoftCallQuality.pqx

  2. Install the Power BI Desktop application.

  • Go to [Documents]\Power BI Desktop\Custom Connectors on the computer.
  • Create the folder if it does not exist.
  • Copy the downloaded MicrosoftCallQuality.pqx file into this folder.
    Image
  1. Open Power BI Desktop and sign in to your Power BI account.
  • You must be a Global Administrator to complete the next steps.
  • Use the user profile icon to sign in, sign out, or change the account.
  1. Download cqd-basic.pbix to your computer.

cqd-basic.pbix

Double-click the file to open it in Power BI Desktop. Click OK on the warning message.
Image

  1. On the File menu, select Options and settings, and then select Data source settings.
  • Select Microsoft Call Quality, and select Edit Permissions.

Image

  • Review the Privacy Level. The default value is None. Make a note of the value.
  1. On the Home menu, select Publish.

Image

  1. On the publish prompt, select the CQD-API workspace and continue to Publish.
  • Select Save if prompted.
  • Select Replace if a report or dataset already exists.
    You will get a success notification:

Image

  1. After a successful publish, open the CQD-API workspace in app.powerbi.com.
  • The cqd-basic semantic model displays.
  • Hover over the item name, select the ellipsis (…), and select Settings.

Image

  1. In Data source credentials, select Edit credentials.
  • Ensure the Privacy Level matches the Privacy Level noted earlier.

Image

  1. Select Sign In and use Global Administrator credentials.

Image

  1. A confirmation notification appears on the right top corner. The Failed to test connection message no longer appears in Data source credentials.

Part 2: Power BI CQD Integration with the WXP Collaboration Admin Portal

  1. Go to Admin Portal > Infrastructure > MS Teams Integration.
  2. Open the PowerBI CQD Authorization dropdown, select CLICK TO AUTHORIZE, and enter your credentials. A new page opens.
  3. Return to the MS Teams Integration page.
  4. Confirm that all fields are populated.

Image

  1. Validate that the Workspace ID matches the workspace ID captured earlier when creating the CQD-API workspace.

Contact Us

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

Related articles