Table of Contents |
---|
Pre-Requisites
For VSM to receive data from Microsoft Teams you will need an VSM Virtual Collector Administered. Details on adding a VSM Virtual Collector can be found here
Azure Active Directory Configuration
VSM uses Graph API to collect data from Microsoft Teams, the following information is required to add Microsoft Teams to VSM:
- Tenant ID
- Application ID
- Shared Secret
In order to obtain the required fields the following steps need to be executed on the Tenant Azure AD
- New APP Registration
- Assign right API Permission to the new APP
- Generate Shared secret Key
Note |
---|
All steps from this point forward require the AAD (Azure Active Directory) user permissions |
New App Registration
Browse to Azure Portal AD https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade
Navigate to and click on 'App Registrations'
Click New registration
Enter Application Registration Details using the following table.
Application Registration Table
Field | Value |
---|---|
Name | Enter the name you want to give to your application |
Supported Account Type | Choose Accounts in this organizational directory only (Virsae Group Limited only - Single tenant) |
Redirect URI | Leave Blank |
After creating the Application take note of Application (Client) ID and Directory (tenant) ID
Assign API Permission to the New APP
Navigate to and click on 'API Permissions'
Click Add a permission
Click on Microsoft Graph
Choose Application Permissions
Choose Call Records >CallRecords.Read.All permission
The following page will appear
Click on the 'Grant admin consent' tab to grant permission for newly created Application
Once Granted the following will be displayed
Generate Shared Secret
Navigate to and click on 'Certificates & secrets'
Click New client secret
Enter Client Secret Information using the following table.
Client Secret Table
Field | Value |
---|---|
Description | Enter description for the client secret |
Expires | The maximum length is 24 months , make sure to renew the cient secret when it expires otherwise VSM won't be able to retrieve MS Teams Calls information |
Take note of Secret Value and Secret ID as it will disappear when you navigate away from the page , The value in the field Value is the value that is going to be added to VSM in Shared Secret Field
Web Portal Configuration
Add Microsoft Teams
Log in to the VSM web portal using your VSM credentials and password.
For your customer, select Service Desk > Equipment Locations Right-click on the Equipment Location (Virtual Collector) and select Manage Cloud Services
At the bottom of Manage Cloud Services click 'Add Services'
A form will open which you can populate the Microsoft Teams details collected earlier in this document as per the table below
Select the Vendor Microsoft and Service Teams Cloud Service
Web Portal - Add Microsoft Teams Field Description
Field | Value |
---|---|
Vendor | Microsoft |
Service | Teams Cloud Service |
Friendly Name | Friendly Name for MS Teams |
Tenant Id | Directory (Tenant)ID displayed under the created Application |
Application Id | Application (client) ID displayed under the created Application |
Shared Secret | The value under Client Secret |
When you have completed the form click 'Add'.