Integration Summary
Learn Amp’s integration with MS Teams has two key functions:
Set up online Teams meetings as the location of an Event in Learn Amp.
Receive notifications in your Microsoft Teams channels about activities occurring in Learn Amp.
Main Features
Create MS Teams meetings automatically when creating an event in Learn Amp.
Send meeting invitations to users in Outlook (or other email applications) with the MS Teams Meeting URL as the location.
Launch MS Teams meetings from Learn Amp.
Receive notifications in your MS Teams channels about activities occurring in Learn Amp.
Create custom activity feeds from Learn Amp, choosing what updates you want to post in your MS Teams channels.
Known Limitations/ Considerations
Calendar events: This integration provides a 1-way sync between Learn Amp events and email applications like Outlook. Any changes to the Learn Amp event (e.g. event is cancelled or date is changed) will update the email invitation. However, if a user declines the meeting invitation they will not be unenrolled from the event in Learn Amp.
Event attendance: Event attendance in Learn Amp is not automatically marked via this integration. Event attendance should be marked in Learn Amp after the event.
How the Platforms Connect
Learn Amp connects to MS Teams using the Graph API. You will need to provide Learn Amp with your Tenant ID and grant meeting permissions for your tenant. Administators will then be able to create MS Teams events in Learn Amp. To set up an activity feed in MS Teams you will configure an incoming webhook on your MS Teams channel and then create an activity feed from the MS Teams Integration page in Learn Amp.
Permissions/Scopes Required
For our integration with MS Teams to work effectively, the following permissions scopes are requested from Learn Amp.
OnlineMeetings.Read
This scope is used to fetch attendance of a specific MS Teams meeting that correspond to an Event on the Learn Amp platform.
OnlineMeetings.Read.All
This scope is used to fetch messing details of any MS Teams meetings that correspond to an Event on the Learn Amp platform.
OnlineMeetings.ReadWrite
This scope is used to schedule an MS Teams meeting and retrieve the URL link, to store with an Event on Learn Amp.
OnlineMeetings.ReadWrite.All
This scope is used to schedule an MS Teams meeting and retrieve the URL link, to store with an Event on Learn Amp.
GroupMember.Read.All
This scope is users to check whether a given user is a member of the specified group. We do NOT fetch user details to any user who is not within the specified security group.
Read and write connector configurations
This scope is used to setup a Notification channel into MS Teams.
webhook.readwrite.all
This scope is only used if Azure AD User Provisioning is enabled.
Group.Read.All
This scope is only used if Azure AD User Provisioning is enabled.
User.Read
This scope is only used if Azure AD User Provisioning is enabled.
User.Read.All
This scope is only used if Azure AD User Provisioning is enabled.
Required Stakeholders
To set up our integration with MS Teams you will need somebody with administrator level access to your Azure AD account in order to provide the Azure AD Tenant ID and approve meeting permissions. This person will also need administrator level access to your Learn Amp Live account for the period of time in which the Integration is being set up.
Set up Instructions
Full instructions on how to set up the MS Teams integration can be found within your Learn Amp account. Please go to yourdomain.learnamp.com/en/integrations/ms_teams
Instructions for creating events and activity feeds is available in our knowledge base.
Other Frequently Asked Questions
What API does Learn Amp use to connect to MS Teams?
Learn Amp uses the AzureAD Graph API to permit the scheduling of MS Teams Meetings and activity feeds.
What information from Azure AD is stored within Learn Amp to setup the MS Teams integration?
We store the Tenant ID of your Azure AD. This is stored in an encrypted field (not in plain text) within our production database. The tenant ID is not kept in any file or other shareable/downloadable format.
We have multiple Azure AD tenants. Can we integrate with more than one?
Learn Amp’s integration with MS Teams connects to a single Tenant ID.
What happens if an event is cancelled or changed in Learn Amp?
Enrolled users will receive an updated meeting invitation in their email application. They will also have the option of viewing the event in Learn Amp.
What happens if a user declines an email invitation?
Users will remain enrolled on the event in Learn Amp, but the event will not display in the calendar of their chosen email application.
How does a user launch an MS Teams meeting scheduled in Learn Amp?
Users can launch the meeting from the event page in Learn Amp. 15 minutes before the Event is due to begin, users will see a Launch button. Users can also launch the meeting from their email invitation or calendar using the location URL provided.
What activity in Learn Amp will I be notified about in MS Teams?
When creating an activity feed you can choose which notifications you would like to receive for each channel you have configured in MS Teams. You can choose to receive activity for all users or a selected teams. You can then choose to be notified about activities completed (e.g. items, learnlists, channels), tasks assigned, platform engagement (e.g. reviews, discussion posts and Q&A questions) or event activity (e.g. approved enrollments and completions).