Installation and Configuration

Installation

The Mattermost MS Teams Meetings plugin is provided in the Mattermost Plugin Marketplace. Once enabled, clicking the video icon in a Mattermost channel invites team members to join an MS Teams meeting, hosted using the credentials of the user who initiated the call.

Requirements

  • Mattermost Server v5.26+ is required.

Marketplace Installation

  1. 1.
    In Mattermost, go to Main Menu > Plugin Marketplace.
  2. 2.
    Search for "MS Teams" or manually find the plugin from the list and click Install.
  3. 3.
    After the plugin is downloaded and installed, select Configure.

Manual Installation

If your server doesn't have access to the internet, you can download the latest plugin binary release and upload it to your server via System Console > Plugin Management. The releases on this page are the same versions available on the Plugin Marketplace.

Configuration

Step 1: Create a Mattermost App in Azure

  1. 1.
    Sign in to the Azure portal using an admin Azure account.
  2. 2.
    Navigate to App Registrations.
  3. 3.
    Select New registration at the top of the page.
  1. 4.
    Fill out the form with the following values:
    • Name: Mattermost MS Teams Meetings Plugin
    • Supported account types: Default value (Single tenant)
    • Redirect URI: https://(MM_SITE_URL)/plugins/com.mattermost.msteamsmeetings/oauth2/complete. Replace (MM_SITE_URL) with your Mattermost server's URL.
  2. 5.
    Select Register to submit the form.
  1. 6.
    Navigate to Certificates & secrets in the left pane.
  1. 7.
    Select New client secret > Add, then copy the new secret in the bottom right corner of the screen. We'll use this value later in the Mattermost System Console.
  1. 8.
    Navigate to API permissions in the left pane.
  1. 9.
    Select Add a permission and choose Microsoft Graph in the right pane.
  1. 10.
    Select Delegated permissions, and scroll down to select the OnlineMeetings.ReadWrite permissions.
  1. 11.
    Select Add permissions to submit the form.
  1. 12.
    Select Grant admin consent for... to grant the permissions for the application.
You're all set for configuration inside of the Azure portal.

Step 2: Configure Plugin Settings

  1. 1.
    Copy the Client ID and Tenant ID from the Azure portal.
  1. 2.
    Go to System Console > Plugins > MS Teams Meetings.
  2. 3.
    Enter the following values in the fields provided:
    • tenantID - Copy from the Azure portal
    • clientID - Copy from the Azure portal
    • Client Secret - Copy from the Azure portal (generated in Certificates & secrets earlier in these instructions)
  3. 4.
    Choose Save to apply the configuration.

Onboarding users

When you’ve tested the plugin and confirmed it’s working, notify your team so they can get started. Copy and paste the text below, edit it to suit your requirements, and send it out.
Hi team,
The MS Teams Meetings plugin has been configured so you can use it for calls from within Mattermost. To get started, run the /mstmeetings connect slash command from any channel within Mattermost. Visit the documentation for more information.