Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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 (plus) New registration


Enter Application Registration Details using the following table.

Application Registration Table

FieldValue
NameEnter the name you want to give to your application
Supported Account TypeChoose Accounts in this organizational directory only (Virsae Group Limited only - Single tenant)
Redirect URILeave 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 (plus) 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 (plus) New client secret


Enter Client Secret Information using the following table.

Client Secret Table

FieldValue
DescriptionEnter 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

FieldValue
VendorMicrosoft
ServiceTeams Cloud Service
Friendly NameFriendly 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 SecretThe value under Client Secret


When you have completed the form click 'Add'.