Microsoft Teams Virtual Meeting Integration within Absorb provides Admins a way of managing all virtual meeting creations, updates, and deletions for Instructor-Led Course (ILC) sessions from within the LMS, without having to enter or adjust anything within Microsoft Teams. Learners can launch and participate in the virtual instructor lead courses within the LMS or from their calendar invitation, even as guests on the Teams tenant.
Before authenticating the Microsoft Teams Integration, confirm you have set up a shared/corporate account with the correct permissions. Configuring this integration with a singular or private User account may cause permissions issues as it relates to editing items such as Teams Sessions. This is because all Teams Meetings created via our integration are created on behalf of (and thus owned by) the User who authenticated the integration.
Getting Started
You can easily enable the Microsoft Teams Virtual Meeting Integration within your Absorb LMS portal by adjusting the Portal Settings. Once enabled, a Venue can be created and attached to Instructor-Led Course (ILC) Sessions.
Step 1 - Setting up Microsoft Teams
You will need to work with your Microsoft Teams Tenant Administrator to register and configure an App in your Azure portal.
- Begin by going to your Microsoft Teams' account https://portal.azure.com/#home to add a Registered App via Manager.
- When adding the LMS URL, you will need to include the extension "/Admin/VirtualMeetingsOAuth/Callback".
- Punctuation and case (i.e. the capitalization of letters) is important and must look the same as written here. For example, the full path would look something like this, https://routename.myabsorb.com/Admin/VirtualMeetingsOAuth/Callback.
Important Note:
When setting up your Microsoft Teams integration with Azure, you MUST setup "Redirect URL's".
How to create an app registration in Azure Portal
- Begin by going to your Microsoft Teams' account https://portal.azure.com/#home to add a Registered App via Manager. Click App registrations
-
Click new registration.
- Setup the Registration.
- Set the Name to: Absorb LMS Integration
- Select the supported account types: "Accounts in this organizational directory only"
-
Add in the Redirect URI
- A Redirect URI must be added here for each Route that is setup in the LMS. If you have more than one portal route setup, please reach out to your CSM or Absorb Support to obtain a list of active routes.
-
Add one of the Redirect URI’s now in the Redirect URI field in Azure.
- Select the Web in the dropdown:
-
-
- Create the Redirect URI text (Replace the {domain-name} in the following text with the LMS Route: https://{domain-name}/Admin/VirtualMeetingsOAuth/Callback
- Press the Register button at the bottom of the page:
-
If you have any additional Routes setup in the LMS:
Navigate back to the new App Registration:
Add all the additional Redirect URI's here (from the LMS Routes table):
4. Copy application ID and Directory (tenant) ID, which will be used when enabling Microsoft Teams Virtual meeting in the LMS.
5. Click Certificates & Secrets in the sidebar, click add new client secret. Enter a description and default expiry should be fine.
6. Copy the client secret value, this will be required for configuring the LMS. Note: Make sure to copy and paste the Client Secret Value (not the ID) and do so before leaving the page. Once you leave the page, the Value will be hidden.
Leave https://portal.azure.com/#home open until you complete Step 2.
Note: For more details, visit the Microsoft Documentation Article
Step 2 - Setting up the LMS
The Microsoft Teams Integration is available to add to an Organization's LMS, by going to Portal Settings > Info Tab and turning the Enable Microsoft Teams toggle to On under the Virtual Classroom Integrations section.
If you wish to use the Teams co-organizer functionality, it’s recommended that you select the following Portal Settings toggle and save the Portal Settings page, prior to enabling the Teams Integration.
Turning the Enable Microsoft Teams toggle on will display the following options:
- App ID: Enter the Application (Client) ID value for this field, which was found in item #4 above
- Tenant ID: Enter the Directory (Tenant) ID value for this field, which was found in item #4 above
- Client Secret: Enter the client secret value, which was found in item #6 above.
Once all the required IDs and Values are entered, select Enable and then Save. You may be prompted to accept permissions from Microsoft to complete the setup.
Important Note
- During the Setup process, please ensure a System Admin has logged in to the portal and proceeds through the integration process. When attempting to log in to the portal, the System Admin must also not log in via SSO; they must log in manually.
- A Blatant Admin cannot enable, disable or authenticate the integration. If a Blatant Admin attempts to enable it, the Teams Integration will give you an error.
Step 3 - Create your Venue
- Navigate to the Venues administration page by clicking the Courses button from the Admin Menu and choosing Venues from the sub-menu. You will be routed to the Venues administration page.
- From the Venues administration page, click the Add Venue button from the right-hand action menu. You will be routed to the Add Venue form.
-
Name: Enter the Venue's Name. The Name identifies the Venue to Learners and Admins. ◦This is visible in both the Admin and Learner experiences.
-
Description: Enter a description to provide details of the Venue in this field. ◦This is visible in the Admin experience only.
-
Max Class Size: Enter a number to set the maximum class capacity for the facility. ◦This is a required field.
-
The Max Class Size will be the default value when creating an ILC Session but can be adjusted on the ILC Session if needed.
-
-
Type: Click the Type drop-down menu and select Teams Meeting.
-
Department: If you would like to restrict this Venue to specific Department Admins, click the Select Department button to search and find the Department the Venue belongs to.
-
Adding a Department will restrict the Venue to the Admin(s) who manage the identified Department(s). Administrators of other Departments will not see the Venue as an option when selecting locations for ILC Sessions.
-
-
- Select Save.
Once the Teams Meeting venue is created, Admins and/or Instructors can add it to the Instructor-Led Course Session. When the Admin and/or Instructor select the Teams Meeting venue, a meeting will be created in Microsoft Teams and the URL will auto-populate within the Session upon selecting Publish.
Step 4 - Using the Co-Organizer Functionality
Using the Co-Organizer Functionality in the Microsoft Teams Integration ensures that there is more than one person that can manage important settings like the meeting options, breakout rooms, and other capabilities in a meeting.
Enable Co-Organizer
If you wish to use the Teams Co-Organizer Functionality, you may enable this using the following Portal Settings page toggle:
It’s important to note that to use this functionality, you must re-enable your Teams Integration after turning on the toggle above.
If you’re setting up your integration for the first time, set this toggle before you enable your integration, save your Portal Settings, and then return to enable the Teams Integration.
If you already have a working integration, you will need to disable the Teams Integration, set the Co-Organizer toggle to on, save your Portal Settings, return to the Portal Settings page and then re-enable your Teams Integration following the instructions in Step 2 above.
Using ILC Sessions With Instructors as Co-Organizers
For the system to recognize your Instructor as a Co-Organizer, please ensure that the Instructor’s email address is a registered Email Address within your Teams organization account.
When configuring your ILC Session, select the Venue and Instructors as above. So long as the Instructors are within your Teams organization, they will be automatically set as Co-Organizers on the meeting. There are no process changes required to use this functionality other than the setup mentioned above.
If your Instructors are not present in your Teams organization, you will receive an error message when adding Instructors.
Co-Organizers have the ability to manage some meeting settings, while they can not manage others. The following table compares the differences:
Co-Organizer Can Manage Setting | Co-Organizer Can Not Manage Setting |
|
|
Troubleshooting
Troubleshooting the Microsoft Teams Virtual Meeting Integration often requires action by the System Admin whom authenticated the integration at the time of setup.
Can't Edit Teams Session
This issue may affect another component of the Microsoft Teams Integration beyond just Sessions. The most common cause of an issue where you cannot edit a Teams Session or similar, relates to the System Admin account which authenticated the integration. The account which authenticated the integration has ownership over Sessions.
The System Admin account which is used to authenticate and setup the Microsoft Teams Integration has greater access to the integration than other accounts. Accordingly, it is advisable to authenticate the Microsoft Teams Integration with a group/shared/corporate account instead of a singular or private User account.
This is important because in the background all Teams Meetings created via our integration are created on behalf of (and thus owned by) the User who authenticated the Microsoft Teams Integration.
Domain Name in Azure
Error
This error can occur while enabling the Microsoft Teams integration in the Client Portal:
This error can occur while creating the virtual meeting:
Cause
The most common problem with Teams Integration relates to the domain name:
This exact name must be set up in two locations:
- In the list of Routes in the LMS Portal Settings
- In Azure
How it works:
- The LMS looks at the URL you are using in your browser's address bar.
- It then uses that domain name to look up the Route in the LMS's Routes table.
- It then sends this domain name to Microsoft when you are connecting to Teams.
- Microsoft then looks it up to see if it has been setup within the list of Redirect URI's. If not, it fails. Quite often more than one Route is setup in the LMS, ensure you add them all to Azure.
Solution: Add this domain name to the list in Azure.
- See Step 3 in the above setup guide, and return to the App Registration in Azure and add the proper Redirect URI for each LMS route.
Roles & Permissions
System Admins are the only Admins who can adjust settings within the Portal Settings. Once the Microsoft Teams Integration options have been toggled on, all other Admins will need the following permissions.
Required Role Permissions
Keep in mind that you may need to adjust Course level Course Administrator permissions.
Role: Section Access | Permission(s) Needed |
---|---|
Courses > Venues | View or Modify permission |
Courses > Instructor-Led Courses > Sessions | Add, View or Modify permission |
Suggested Role Permissions
Role: Section Access | Permission(s) Needed |
---|---|
Users |
View or Modify permission |