Setting Up the MS Teams Integration

Setting Up the MS Teams Integration

Overview

Setting up the MS Teams integration connects your Learn Amp platform with Microsoft Teams, enabling you to schedule meetings and send activity notifications. This guide walks you through the complete setup process.

The setup involves configuring your Azure AD tenant, granting the necessary permissions and access policy, and optionally setting up activity feed webhooks.


Functionality Breakdown

During setup, you'll configure:

  • Azure AD Connection – Link your organisation's Azure AD tenant to Learn Amp

  • Meeting Permissions – Grant Learn Amp permission to create and manage MS Teams meetings

  • Activity Feed Webhooks – Optionally configure channels to receive Learn Amp notifications

Once configured, Event creators can select MS Teams as a meeting location, and administrators can set up activity feeds to keep teams informed.


Pre-requisites

Before starting the setup, ensure you have:

  • Administrator access to your Azure AD account

  • Your Azure AD Tenant ID

  • Owner or Admin role in Learn Amp

  • Access to the MS Teams admin centre (for webhook configuration)

Role Requirements

Platform

Required Role

Purpose

Platform

Required Role

Purpose

Learn Amp

Owner or Admin

Configure integration settings

Azure AD

Administrator

Grant application permissions

MS Teams

Team Owner

Create incoming webhooks (for activity feeds)

💡 Tip: Have your Azure AD administrator available during setup to approve the required permissions.


Quick Start Guide

Step 1: Access Integration Settings

  1. Click the Settings cog in the sidebar navigation

  2. Select Integrations

  3. Click Microsoft Teams

Step 2: Enter Your Tenant ID

  1. In the MS Teams integration page, locate the Tenant ID field

  2. Enter your Azure AD Tenant ID

  3. Click Save

To find your Tenant ID:

  • Go to the Azure Portal

  • Navigate to Azure Active Directory

  • Your Tenant ID is displayed on the Overview page

Step 3: Grant Permissions

  1. Click Grant Permissions to open the Azure AD consent flow

  2. Sign in with an Azure AD administrator account

  3. Review the requested permissions

  4. Click Accept to grant Learn Amp access

Step 4: Verify Connection

Once permissions are granted:

  • The integration status should show as Connected

  • Event creators will see MS Teams as a location option when creating Events


Permissions Required

Learn Amp requests the following Microsoft Graph API permissions:

Core Permissions (Required)

Permission

Purpose

Permission

Purpose

OnlineMeetings.ReadWrite.All

Schedule MS Teams meetings and retrieve meeting URLs

OnlineMeetingArtifact.Read.All

Fetch meeting details for Events

OnlineMeetingRecording.Read.All

Access meeting recordings (beta feature)

OnlineMeetingTranscript.Read.All

Access meeting transcripts (beta feature)

ChannelMessage.Send

Send notifications to MS Teams channels

GroupMember.Read.All

Verify user membership in security groups

Optional Permissions (If Using Azure AD User Provisioning)

Permission

Purpose

Permission

Purpose

User.Read.All

Read user profiles for provisioning

User.ReadWrite.All

Update user profiles

Group.Read.All

Read group memberships

Directory.Read.All

Read directory data

Beta Feature Permissions

Permission

Purpose

Permission

Purpose

Chat.ReadWrite.All

Manage chat messages (beta)

TeamsAppInstallation.ReadWriteForChat.All

Install apps in chats (beta)

TeamsAppInstallation.ReadWriteForUser.All

Install Learn Amp app for users (beta)

TeamsTab.ReadWrite.All

Manage Teams tab integration (beta)


Setting Up Activity Feed

Pre-requisites for Activity Feed

Before enabling Activity Feed, you'll need:

  • The MS Teams integration connected and working

Role Requirements

Platform

Required Role

Purpose

Platform

Required Role

Purpose

Learn Amp

Owner or Admin

Download the app from the Microsoft Teams Integrations page and setting up an activity feed

Microsoft Teams

Administrator

Add the app to the channel where Activity feed notifications need to be received

Setup Steps

Step 1: Upload the Learn Amp App to Microsoft Teams

  1. In Learn Amp, go to Settings → Integrations → Microsoft Teams → How to use tab.

  2. Scroll down to the Install Learn Amp App in Microsoft Teams section and click Download Teams App Package.

  3. In Microsoft Teams, navigate to Apps → Manage your apps → Upload an app → Upload a customised app.

  4. Select the downloaded Learn Amp package and click Add.

Step 2: Install the App to the Target Teams Channel

  1. After uploading, you’ll be prompted to choose a Teams channel.

  2. Select the appropriate channel where you want to receive activity feed notifications.

  3. Click Go.

Step 3: Create a New Activity Feed in Learn Amp

  1. In Learn Amp, go to Settings → Integrations → Microsoft Teams.

  2. Select the Activity Feeds tab.

  3. Click Add new feed.

  4. Choose which team’s activity to include (or select All company).

  5. Select the notification types you want to receive.

  6. Paste the copied channel link into the Channel URL field.

  7. Click Save.

Video resources:


Setting Up Automatic Attendance (Beta)

Automatic attendance marking allows Learn Amp to sync attendance data directly from MS Teams meetings, removing the need for manual attendance tracking after Events.

⚠️ Note: This feature is currently in beta. Check the Beta feature section to enable it.

How It Works

When automatic attendance is enabled:

  • Learn Amp retrieves attendance data from MS Teams

  • Event attendance is automatically marked in Learn Amp within one hour after the meeting ends

Pre-requisites for Automatic Attendance

Before enabling automatic attendance, you'll need:

  • The MS Teams integration connected and working

  • An Azure AD administrator to run PowerShell commands

  • Access to Azure Cloud Shell

Role Requirements

Platform

Required Role

Purpose

Platform

Required Role

Purpose

Learn Amp

Owner or Admin

Enable automatic attendance in Event settings

Azure AD

Administrator

Run Teams Application Access Policy commands

Setup Steps

Step 1: Configure Azure Teams Application Access Policy

Your Azure AD administrator must run the following commands in Azure Cloud Shell:

  1. Go to the Azure Portal

  2. Open Cloud Shell (icon in the top navigation bar)

  3. Run the following commands:

# Install the Microsoft Teams module Install-Module MicrosoftTeams -Force # Connect to Microsoft Teams PowerShell Connect-MicrosoftTeams # Create the application access policy New-CsApplicationAccessPolicy -Identity "LearnampTeamsApiAccess" -AppIds "3c5baded-7e6c-4901-9ee7-809fb1b56b05" # Apply the policy globally Grant-CsApplicationAccessPolicy -PolicyName "LearnampTeamsApiAccess" -Global

Step 2: Enable Automatic Attendance on Events

Once enabled, when creating an Event with MS Teams:

  1. In the Event session settings, locate the Attendance section

  2. Select Automatically record attendance

  3. Complete and publish your Event

Attendance will be synced automatically after the meeting concludes, and an in-app notification will be received by the host once this happens.

💡 Tip: Allow 60 minutes after a meeting ends for attendance data to sync from MS Teams to Learn Amp.


FAQs

Q: Where do I find my Azure AD Tenant ID?
In the Azure Portal, go to Azure Active Directory. Your Tenant ID is displayed on the Overview page, or you can find it under Properties.

Q: Who needs to grant permissions?
An Azure AD administrator must grant the application permissions. This is typically someone with Global Administrator or Application Administrator role in Azure AD.

Q: Can I test the integration before going live?
Yes, create a test Event with MS Teams as the location and verify the meeting link is generated correctly. For activity feeds, you can send a test notification from the integration settings.

Q: What if the consent flow fails?
Ensure you're signed in with an administrator account that has permission to consent to applications. Check with your IT team if additional approval workflows are required.

Q: Can I revoke permissions later?
Yes, you can revoke Learn Amp's permissions from the Azure Portal under Enterprise Applications. Note that this will disable the integration.

Q: How do I enable automatic attendance?
Automatic attendance is a beta feature. Enable this from the Beta Features page (“Microsoft Integration Enhancements”, then follow the setup steps in this guide.


Troubleshooting

Issue

Solution

Issue

Solution

Consent flow shows error

Ensure you're using an Azure AD administrator account with consent permissions

Tenant ID not accepted

Verify the Tenant ID is correct (GUID format) and matches your Azure AD

Integration shows disconnected

Re-grant permissions; the token may have expired

Permission request shows unexpected scopes

Some scopes are for beta features; these can be reviewed but won't affect core functionality

Users can't see MS Teams option

Ensure the integration is connected and the user has permission to create Events

Automatic attendance not syncing

Verify the Azure Application Access Policy was applied; allow 60 minutes after meeting ends