Overview
The Microsoft Teams Virtual Meeting plugin allows trainers to create an ad hoc room that will automatically generate a Microsoft Teams Online Meeting for any seminar session with which it is associated. The meeting URL is available to admins and trainers at any time, along with options/settings for the meeting. The URL is revealed to booked learners beginning 15 minutes before the session starts.
...
To enable the plugin, you will need to register a new app in Microsoft Azure (or update an existing one), and set the App ID and Client Secret in the MS Teams Virtualmeeting plugin settings.
Requirements
You will require the following:
- A Microsoft Teams licence
- A Microsoft Azure account
- Your Totara site must be available via https:// URL
Info | ||
---|---|---|
| ||
For testing purposes in non-production environments only, Totara includes a PowerShell script that can be used to automate the creation and configuration of a new Microsoft Teams virtualmeeting plugin app on Azure. The script requires familiarity with PowerShell and a Windows computer, but your non-production Totara instance can be deployed in any environment. The script is available at dev/integrations/virtualmeeting/msteams/msteams.ps1 and includes information and examples in the header. |
Registering a new app
If you already have a Totara app on Azure and are planning on reusing it, please skip these tasks and go to the Updating an existing app section.
- Log in to Microsoft Azure Portal.
- Navigate to App registrations or search for it if it isn't available on the dashboard.
- Click New Registration.
- Enter the Name for your app e.g. 'Totara virtual meeting integration'.
- Select Accounts in any organizational directory (Any Azure AD directory - Multitenant).
- Click Register.
- Go to the Setting up your Azure app section.
Updating an existing app
It is possible to extend an existing Totara app, for example, Microsoft Teams integration for Totara Engage, to add virtual meeting integration.
...
Info |
---|
If your app doesn't exist in the Owned applicaitons tab, switch to the All applications tab and look it up. |
Setting up your Azure app
- Continue from Registering a new app or Updating an existing app.
- Go to the Overview blade.
- Copy the Application (client) ID onto a Notepad app.
- Go to the Authentication blade.
- Click Add a platform.
- Select Web.
- Set a Redirect URI that points to https://(your.totara.site)/integrations/virtualmeeting/auth_callback.php/msteams.
- Click Configure.
- Click Save.
- Go to the API permissions blade.
- Click Add a permission.
- Select Microsoft Graph.
- Select Delegated permissions.
- Select the following permissions:
- OnlineMeetings.ReadWrite
- User.Read
- offline_access
- openid
- profile
- Click Add permissions.
- Click Grant admin consent for (your tenant) if you do not want each user to confirm your app.
- Go to the Certificates & secrets blade.
- Click New client secret.
- Select the desired expiration time.
- Click Add.
- Copy the Value field of the client secret onto a Notepad app.
Note |
---|
Before proceeding ensure that you have a note of your App ID (Application ID) from step 3 and your Client secret from step 21. |
Enabling the Integration
- Log in to your Totara site.
- Go to the virtual meeting plugin setting under Quick-access menu > Plugins > Virtual meetings > Microsoft Teams.
- Enter your App ID.
- Enter your Client secret.
- Click Save changes.
Testing the integration setup in Totara Learn
Warning |
---|
The maximum meeting duration may vary based on factors such as your account plan or your country. For more information, please see plans and pricing on Microsoft's website. |
...