TABLE OF CONTENTS

• MS Teams App Creation in Azure AD
  • Prerequisites
  • Register an application
• MS Teams Instance Creation in TRP

MS Teams App Creation in Azure AD

Prerequisites

• An Azure account

• The Azure account must have permission to manage applications in Azure Active Directory (Azure AD). Any of the following Azure AD roles include the required permissions:

  • Application administrator

  • Application developer

  • Cloud application administrator

Register an application

1. Sign in to the Azure portal.

2. If you have access to multiple tenants, use the Directories + subscriptions filter  in the top menu to switch to the tenant in which you want to register the application.

3. Search for and select Azure Active Directory.

4. On the left sidebar under Manage, select App registrations then click on New registration.

5. Enter a display Name for your application and select “Accounts in this organizational directory only (<tenant name> only - Single tenant)”. We don’t need to set a Redirect URI. Select Register to complete the initial app registration.

6. When registration finishes, the Azure portal displays the app registration's Overview pane. Make sure to copy the “Application (client) ID” and the “Directory (tenant) ID”. You’ll need those later to finish the integration with TRP.

7. Next, in the app registration’s Overview pane, click on Add a certificate or secret.

8. Select Client secrets > New client secret. Add a description for your client secret. Select an expiration for the secret or specify a custom lifetime. Then, click Add.

9. Copy the Client Secret Value. This is also needed later to finish the integration with TRP.

10. After that, we need to assign permissions for the app.

Under the application's API permissions page, choose Add a permission.

11. Select Microsoft Graph.

12. Select Application permissions. In the Select Permissions dialog, type “call” and choose the “CallRecords.Read.All” permission. Then, click Add permissions.

13. Click on “Grant admin consent for <tenant name>” and then confirm.

14. That’s it. Next, we need to enter the credentials collected during the process into TRP, so that TRP can get call records data from the Microsoft Graph API. Make sure you have the client ID, client secret and tenant ID before moving to the next step.

If any of the above steps do not match what can be seen in the Azure portal UI, please refer to the original links for registering an application and adding permissions to update this documentation.

MS Teams Instance Creation in TRP

1. Log in to TRP.

2. Go to "Imports and Integrations" and click on the MS Teams Instance card.

3. Click on Add new MS Teams Instance.

4. Enter a Name. Then, paste the Client ID, Client Secret and Tenant ID into the corresponding fields. You can also click on Test Connection to make sure the credentials are valid.

5. That’s it. Now, the integration between TRP and MS Graph API is set up. TRP will automatically fetch meeting information once it receives a notification from MS Graph API that the meeting ended. Still, please note that the average latency for receiving these notifications is 15 minutes and can reach up to 1 hour.