Set up for Microsoft Teams with Admin Portal

The connection between Vyopta and Microsoft Teams is cloud to cloud and will not require any configuration to be made to the infrastructure data collector. Vyopta uses OAuth method to Authenticate and collect data from Microsoft Teams.

Required Authorization level:

The Authorizing User needs to have Global Administrator access within their 
Microsoft Teams tenant to authorize Vyopta data collection.

Required Scopes:

• CallRecords.Read.All
• User.Read.All
• TeamworkDevice.Read.All

Steps:

1. Navigate to my.vyopta.com and login with your Vyopta account.
2. From the top right corner navigate to the admin portal
3. Select infrastructure and select Microsoft Teams.
   
4. Add name and description for the Microsoft Teams integration. These are user friendly fields. Note: the Graph API Url is pre-populated and cannot be modified.
   
5. After clicking save, you will see the MS Teams Authorization section below. Once you expand the section and click on 'Click to Authorize' you will be prompted to log into your Microsoft account. Note: You need to ensure that you are using either Google Chrome or Safari before clicking on Click to Authorize.
   
6. Read the permissions needed for the Vyopta account and accept.
   
   
7. After accepting, you will be brought back to the Vyopta infrastructure page with MSTEAMS Authorization populated. Select the button that says CLICK TO AUTHORIZE and then save the configuration.
   

Once the Microsoft teams has been setup, data will be available the following day in the CPM Analytics dashboards.

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 and validate and enable once again after 2 hours,  at which time you should have a successful validation for your Microsoft Teams collection.