Microsoft Teams

Microsoft Teams is an enterprise communication tool that enables collaboration across teams. This integration lets you:

  • Look up xMatters groups, see who's on call, and invite on-call members to a conversation in Teams, which they can join simply by responding to a notification on their preferred device. Learn more
  • Associate xMatters incidents with a group chat or a meeting in Teams Meetings, so you can reference incident details while working to resolve the issue. Learn more
  • Initiate xMatters incidents within a chat or Teams channel, so you can collaborate with your team without interruption. Learn more
  • Manage xMatters incidents within a chat, Teams channel, or Teams meeting, so you can reference incident details while working to resolve the issue. Learn more
  • Register your Microsoft Teams account as an xMatters device, which enables you to receive and respond to incident notifications and other alerts right in your Teams account. Learn more

Do more with this integration

Incorporate this integration into your orchestrated incident resolution workflows with Flow Designer. After you create a configuration, the Flow Designer tab appears. From there, you can build your flows — add new response options, connect to other apps, or even create new xMatters alerts based on activities in the flow — enriching the information injected by this integration along the way.

Are you looking to integrate Teams into your automated toolchain using steps in Flow Designer? Check out these instructions instead.

Are you interested in a live walkthrough of the Teams integration? Take a live, online workshop led by one of our xPerts.

Get started with Teams

Connecting xMatters to Microsoft Teams

Before you get started with integrating your xMatters account to Microsoft Teams, it's helpful to know the difference between the two types of xMatters connections that are available in Teams: global connection and personal connection.

  • A global connection to an xMatters instance enables all users in your Microsoft Teams organization to use the xMatters bot commands. To sign into a global connection, start a private chat with the xMatters bot and use the signin command.
  • A personal connection to your individual xMatters account enables you to initiate incidents from within Teams. Teams will prompt you to log in with your xMatters credentials when you initiate an incident or when you open a new incident tab in your chat, channel, or meeting. You can also sign in from the xMatters bot Home tab.

How to install the Microsoft Teams built-in integration

The installation process for the Teams integration is a bit different from our other built-in integrations. For this integration, you install it right from the Microsoft Teams app catalog. xMatters prompts you install the integration directly from Teams.

The setup and authentication process automatically adds a configuration for the integration to your xMatters instance.

The Microsoft Teams integration settings in xMatters

When you add the xMatters app in Teams, the configuration is automatically added to xMatters with default settings.

Look up on-call information and invite people to join the conversation

The integration uses the xMatters bot, which you can call into any channel in a team to look up groups in xMatters, see who's on call, and instantly invite the on-call members of a group to the conversation.

Initiate an incident from Microsoft Teams

The xMatters app enables you to initiate an incident right in your chat or Teams channel. This streamlines your team's collaboration process so you no longer have to switch back and forth between xMatters and Microsoft Teams to manage incidents.

Add an incident to a group chat or Teams meeting Manage an incident from Microsoft Teams

The xMatters app has been optimized for meetings in Microsoft Teams, letting you view incident information right in the meeting. You can also add the incident to a chat or Teams channel.

To add an incident tab, add the app to the meeting or chat and connect it to xMatters, then use the search to find the incidents you have access to. After you add the tab, it keeps you updated on the incident's progress without leaving the meeting or chat — and you can update incident details right from Teams. Other people in the meeting or group chat can see the tab, and if they have access to the incident, then can connect to xMatters to view the details.

For more information on working with incidents in xMatters, see Incident Management.

Microsoft Teams as an xMatters device

When you register your Microsoft Teams account as an xMatters device, you can receive incident notifications and other alerts directly in your Teams instance. Notifications come in the form of a direct message in your private chat with the xMatters bot. You can respond to these notifications right in your Teams chat, whether you want to simply acknowledge the alert, escalate an incident, create a Teams meeting for discussion, or other response actions you can customize to your organization's needs.