Microsoft Teams steps

Flow Designer has built-in steps to help you integrate Microsoft Teams into your event management and incident response flows.

The following steps are available:

  • Create Channel: create a new channel in Teams, using the inputs to construct the channel name and description, and to determine the team to create the channel in.
  • Delete Channel: delete an xMatters generated channel in Teams, using the inputs to determine the channel to delete.
  • Post Message: post a simple message to a channel, using HTML to format plain text, outputs from previous steps, or a combination of both.
  • Post to Channel (Connector): post a message to a channel using a webhook connector you configure in Microsoft Teams. This allows you to post to the channel using a card format.
  • Create Online Meeting: create a new instant meeting in Teams, using inputs to construct the meeting subject.

In the example above, the flow creates a ServiceNow incident based on a person's response to the alert notification. It then creates a Jira Cloud issue with information from the alert and the ServiceNow incident. A message is posted to a Teams channel, including information from the source system, the ServiceNow incident, and the Jira Cloud issue.

To use the Create Channel and Post Message steps, you need to create a Microsoft Graph API endpoint.

To use the Post to channel (Connector) step, you need to set up an incoming webhook connector in your Microsoft Teams channel, then create an endpoint that uses the unique URL generated when you set up the webhook connector. You can find details on setting up a webhook in the Microsoft Teams help.

Create Channel

Use the Create Channel step to automatically create a new channel in a team, using text, constants, and the outputs from previous steps to populate the inputs.

Delete Channel

Use the Delete Channel step to automatically delete a channel created by xMatters in Teams, using text, constants, and the outputs from previous steps to populate the inputs.

Deleted channels in Microsoft Teams can be restored within 30 days. During this period, deleted channels continue to count toward your Microsoft Teams channel limits. For more information, see Limits and specifications for Microsoft Teams.

Post Message

Use the Post Message step to send a message to a channel in a team, using text, constants, and the outputs from previous steps to populate the inputs.

Post to Channel (Connector)

Use the Post to Channel step to automatically post a message to a channel in Microsoft Teams, using the input to populate the message.

To use this step, you need to set up an incoming webhook connector in your Microsoft Teams channel. You can find details in the Microsoft Teams help. Use the unique URL generated when you set up the connector as the Base URL when you configure an endpoint in xMatters.

Create Online Meeting

Use the Create Online Meeting step to automatically create a new instant meeting, using text, constants, and the outputs from previous steps to populate the inputs. Outputs of this step include a URL users can click to join the meeting (instant meetings are not automatically added to the calendar), as well as dial-in information if audio conferencing is available for the meeting.