gijsdb/mattermost-plugin-msteams-sync

Mattermost MS Teams Sync Plugin

Table of Contents

• License
• Overview
• Features
• Installation
• Setup
• Connecting to MS Teams

License

See the LICENSE file for license rights and limitations.

Overview

This plugin integrates MS Teams with Mattermost by providing automated syncing of messages from Mattermost to MS Teams and vice versa. For a stable production release, please download the latest version from the Plugin Marketplace and follow the instructions to install and configure the plugin. If you are a developer who wants to work on this plugin, please switch to the Developer docs.

Features

This plugin supports the following features:

• Connect to MS Teams account using Device Code OAuth flow.

• Link Mattermost channels with MS Teams channels and sync messages between the linked channels.

• Link Mattermost DMs and group messages with Teams chats and sync messages.

• Sync Mattermost and MS Teams messages for any changes made in any existing messages on either side.

• Deletion of MS Teams messages is synced with Mattermost but it's not vice versa.

• • Sync posts containing markdown and attachments.

    

• Sync reactions on posts.

Installation

1. Go to the releases page of this GitHub repository and download the latest release for your Mattermost server.
2. Upload this file on the Mattermost System Console > Plugins > Management page to install the plugin. To learn more about how to upload a plugin, see the documentation.
3. Enable the plugin from System Console > Plugins > MSTeams Sync.

Setup

• Microsoft Azure Setup
• Plugin Setup

Connecting to MS Teams

There are two methods by which you can connect your Mattermost account to your MS Teams account.

• Using slash command

  • Run the slash command /msteams-sync connect in any channel.
  • You will get an ephemeral message from the MS Teams bot containing a link and a code to connect your account.
  • Click on that link and enter the code. If it asks for login, enter your Microsoft credentials and click Continue to authorize and connect your account.

• Using the button in the full screen modal

  • If the setting "Enforce connected accounts" is enabled in the plugin's config settings, then a full screen modal appears that looks like this -

  

  • Click on the "Connect account" button. If it asks for login, enter your Microsoft credentials and click Continue to authorize and connect your account.

  After connecting successfully, you will get an ephemeral message from the MS Teams bot saying "Your account has been connected".

• Connecting the bot account

  • Run the slash command /msteams-sync connect-bot in any channel.
  • This command is visible and accessible by system admins only.
  • After running the slash command, you will get an ephemeral message from the MS Teams bot containing a link and a code to connect the bot account.
  • Click on that link and enter the code. If it asks for login, enter the Microsoft credentials for the dummy account and click Continue to authorize and connect the bot account.
  • Refer here for more details on connecting the bot account.

  After connecting successfully, you will get an ephemeral message from the MS Teams bot saying "The bot account has been connected".