Overview
NovoEd's Microsoft Teams Meeting Integration for Live Events allows a course builder to authenticate their Microsoft 365 Business user account and automatically schedule a Microsoft Teams online meeting as a Live Event on a NovoEd lesson page. With this integration, NovoEd retrieves attendance from the Microsoft Teams meeting when the data is made available by Microsoft.
Permissions
- Org Admins must enable the Microsoft Teams Meeting Integration for Live Events for the NovoEd institution
- Course Admins with the Course Builder permission set can create Microsoft Teams-integrated Live Events after authenticating their Microsoft 365 Business user account
Data Retrieval
After a Microsoft Teams-integrated Live Event, data is retrieved by NovoEd once the data has been made available by Microsoft. Typically, the data is made available to NovoEd within 24 hours. If a meeting’s data is not reflected in NovoEd within 24 hours, please contact the NovoEd Support Team (hello@novoed.com).
Currently, only Attendance records are made available by Microsoft. Retrieving meeting recordings is not a capability made available by Microsoft.
Directions
How to enable the Microsoft Teams Meeting Integration (Org Admin)
- Log into NovoEd as an Org Admin.
- On the left-hand navigation panel, select the Admin Tools gear icon.
- Select ADVANCED SETTINGS from the Organization Admin Tools menu.
- In the INTEGRATIONS tab, you will find Microsoft Teams Meeting Integration for Live Events. Select the blue ENABLE button. Once the integration is enabled by an Org Admin, Course Builders can authenticate their Microsoft 365 Business account and begin creating Microsoft Teams-integrated Live Events.
How to authenticate your Microsoft Teams account (Course Builder)
- Log into NovoEd as a course admin with the Course Builder permission set.
- On a lesson page, select the gear icon in the top-right corner.
- Select EDIT CONTENT from the menu.
- Hover over the middle of the lesson page and select the blue (+) Add link.
- From the Components menu, scroll down to the Third Party Links & Tools section.
- Select LIVE VIDEO EVENTS.
- Select MICROSOFT TEAMS MEETING.
- Select the blue NEXT button.
- Select the blue AUTHENTICATE MICROSOFT TEAMS button. You will be directed to a Microsoft 365 page to review and accept permissions of the integration.
- Select the blue ACCEPT button.
How to create a Microsoft Teams-integrated Live Event (Course Builder)
- Log into NovoEd as a course admin with the Course Builder permission set.
- On a lesson page, select the gear icon in the top-right corner.
- Select EDIT CONTENT from the menu.
- Hover over the middle of the lesson page and select the blue (+) Add link.
- From the Components menu, scroll down to the Third Party Links & Tools section.
- Select LIVE VIDEO EVENTS.
- On the Add Live Video Events pop-up, select MICROSOFT TEAMS MEETING.
- Select the blue NEXT button.
- Enter the email address of the meeting owner/host.
- Select the blue SUBMIT button.
- Provide details about the meeting: Topic, Description (optional), Start Time, Time Zone (defaulted to your account's time zone preference), Duration, Lobby ByPass.
- Select the blue ADD button.
How to change the authenticated user
In the event a course builder wishes to change the user that is used to authenticate the integration they will need to first uninstall the MS Teams Integration. Follow the steps below.
-
Go to https://portal.office.com/account/?ref=MeControl. Make sure to be logged in as the user that originally authenticated the integration.
-
Select APP PERMISSIONS.
- Select REVOKE for the NovoEd Teams Meeting Integration for Live Events app.
- To Add a New Authenticated User: Wait at least one hour. Then, follow the steps above to authenticate a Microsoft 365 Business account.
App Approval
Some organizations may require approval of the use of enterprise applications within Microsoft 365. Organizations can restrict the ability for users to consent to third-party multi-tenant applications and their accessing of user profile data in Microsoft Azure. Typically, there are one of two Microsoft Admin Approval Flows, which are detailed below:
Approval Flow 1:
When attempting to authenticate the integration, the user receives a message that they need admin approval.
If you receive the error message above, do not log in with a Microsoft Admin Account. You will need to get your Microsoft Organization administrator to grant admin access to our application prior to the NovoEd admin trying to install the application.
Instruct your Microsoft Admin to go to:
They will need to replace the {tenant-id} in the URL above with the MS tenant-id of the organization. Once landing on that page, they can provide global admin consent for all users to use the application within the organization.
The Microsoft Admin will see the following approval request:
Approval Flow 2:
In approval flow 2, the IT organization sets up the approval process during the installation of the NovoEd App.
When the NovoEd admin attempts to install the NovoEd app they are asked to initiate an approval request, by entering a justification and clicking on the REQUEST APPROVAL button.
Once completed, the IT organization will be alerted for approval. After IT has reviewed the request, the requestor will get an email with the request disposition. Once approved, the requestor can proceed with enabling the integration for the NovoEd institution.
Notes
- Lobby ByPass: When creating an event, Microsoft Teams allows you to enable "Lobby ByPass." This means anyone who is permitted to skip the lobby will be able to automatically join the meeting.
- Organizer: The creator of the Live Event will be the organizer of the Teams Meeting. It is not possible to set a different owner with this user-level integration.
- Recordings: As mentioned above, meeting records are not retrieved through this integration. If you wish to have meeting recordings added to lesson pages, it will need to be manually downloaded from the organizer's Microsoft Teams account and uploaded to the lesson page.
- API Permissions: To ensure attendance is automatically uploaded from Teams, please ensure the permissions listed are granted for NovoEd:
- OnlineMeetingArtifact.Read.All
- OnlineMeetings.Read
- OnlineMeetings.ReadWrite