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 |
|---|---|---|
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
Click the Settings cog in the sidebar navigation
Select Integrations
Click Microsoft Teams
Step 2: Enter Your Tenant ID
In the MS Teams integration page, locate the Tenant ID field
Enter your Azure AD Tenant ID
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
Click Grant Permissions to open the Azure AD consent flow
Sign in with an Azure AD administrator account
Review the requested permissions
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|---|
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
In Learn Amp, go to Settings → Integrations → Microsoft Teams → How to use tab.
Scroll down to the Install Learn Amp App in Microsoft Teams section and click Download Teams App Package.
In Microsoft Teams, navigate to Apps → Manage your apps → Upload an app → Upload a customised app.
Select the downloaded Learn Amp package and click Add.
Step 2: Install the App to the Target Teams Channel
After uploading, you’ll be prompted to choose a Teams channel.
Select the appropriate channel where you want to receive activity feed notifications.
Click Go.
Step 3: Create a New Activity Feed in Learn Amp
In Learn Amp, go to Settings → Integrations → Microsoft Teams.
Select the Activity Feeds tab.
Click Add new feed.
Choose which team’s activity to include (or select All company).
Select the notification types you want to receive.
Paste the copied channel link into the Channel URL field.
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 |
|---|---|---|
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:
Go to the Azure Portal
Open Cloud Shell (icon in the top navigation bar)
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" -GlobalStep 2: Enable Automatic Attendance on Events
Once enabled, when creating an Event with MS Teams:
In the Event session settings, locate the Attendance section
Select Automatically record attendance
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 |
|---|---|
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 |