Collaborate within Microsoft Teams (Beta)#

The Mattermost for Microsoft Teams plugin integration enables you to collaborate with Microsoft Teams users without leaving Mattermost.

Mattermost Academy Learn about integrating with Microsoft Teams

Connect your Mattermost account to your Microsoft Teams account#

To use the Microsoft Teams plugin, you must connect your Mattermost user account to your Microsoft Teams account. You only need to complete this step once.

  1. Log into Mattermost using your credentials.

  2. When you log in, you’ll be prompted to enter your Microsoft Teams user information, including your Microsoft Teams email address and your Microsoft Teams password.

Note

  • If you’re not prompted to connect your account, you can use the /msteams connect slash command to do so.

  • To change which accounts are linked, in Mattermost, disconnect the current account by running the slash command /msteams disconnect within the Mattermost message text box. Then, re-connect a new Mattermost account to a new Microsoft Teams account by running the Mattermost slash command /msteams connect.

  • If your Microsoft Teams user account is removed from Microsoft Teams, your linked Mattermost user account will also be removed the next time user accounts are synchronized across the two platforms.

Mattermost will confirm when your account is connected, and prompt you to select your primary platform.

Select your preferred platform#

Once you’ve connected your Mattermost account to your Microsoft Teams account, Mattermost prompts you to choose which platform you’ll use more often: Mattermost or Microsoft Teams. Mattermost optimizes your experience based on the platform you prefer to use.

Note

  • If you’re not prompted to connect your accounts, run the Mattermost slash command /msteams connect within the Mattermost message text box to display the prompt in a browser window. Follow the link to connect your accounts.

  • If you select Skip for now, Mattermost is selected as your primary platform. You can change this preference any time by selecting your profile picture and going to Settings > MS Teams Settings.

Mattermost is your preferred platform#

When Mattermost is preferred, you’ll receive Microsoft Teams messages and notifications in Mattermost.

We recommend that you disable notifications in Microsoft Teams. If you don’t, you’ll receive duplicate message notifications in both platforms. See the Microsoft Teams notifications documentation for details.

Microsoft Teams is your preferred platform#

When Microsoft Teams is preferred, you’ll receive messages from Mattermost in Microsoft Teams. Mattermost notifications are automatically muted for you to prevent duplicate notifications.

Setup complete#

Setup is complete! You’re ready to collaborate across your organization. Interact with colleagues in Microsoft Teams without having to leave Mattermost.

Get started#

You can start a direct or group message between Mattermost and Microsoft Teams users unless your Mattermost administrator has disabled the ability to do so in the System Console.

  • Within Mattermost, select the Open menus using the plus icon. icon next to Direct Messages in the left pane, then search for the user you want to message. Your direct or group conversation is visible in both Mattermost and Microsoft Teams.

  • Within Microsoft Teams, select Chat > New chat, and select the users you want to chat with. Your conversation is visible in both Mattermost and Microsoft Teams for all users who have connected their Mattermost user account to their Microsoft Teams user account.

An example of a Mattermost direct message (DM) that is synced with a DM on Microsoft Teams.

Mattermost Slash commands#

You can run the following Mattermost slash commands by typing the commands into the Mattermost message text box, and selecting Send:

  • /msteams connect: Connect your Mattermost account to Microsoft Teams account.

  • /msteams disconnect: Disconnect your Mattermost account from Microsoft Teams account.

  • /msteams link: Link the currently active Mattermost channel with an Microsoft Teams channel. You must be a Mattermost channel admins to use this slash command, and you must have your Mattermost account connected with Microsoft Teams. This command takes two arguments: Microsoft Teams team ID and channel ID, which you can get from command autocomplete.

  • /msteams unlink: Unlink the currently active Mattermost channel with the Microsoft Teams channel. You must be a Mattermost channel admin to run this slash command, but you don’t need to have your Mattermost account connected to Microsoft Teams.

  • /msteams show: Show the link of the currently active Mattermost channel, including the team name and channel name of Microsoft Teams to which the currently active Mattermost channel is linked.