Configuring Microsoft Teams to receive alerts via webhooks

General Information

In order to receive alerts via Microsoft Teams (MS Teams), you need to set up two configurations:

• create an Incoming Webhook Connector for your channel in Microsoft Teams

• setup a Custom Webhook in Email This Issue administration

If you can't add a connection in your MS Teams desktop application, try doing it via the web version of Microsoft Teams. The steps are going to be the same for both platforms.

Creating the Incoming Webhook Connector

In order to add the Incoming Webhook Connector, follow the below steps:

Open the MS Teams channel configuration panel and set up the Incoming webhook connector for the channel that you would want Email This Issue to send the alerts to.

In this example, it's called Alerting-Incidents. Click on the three dots and open Connectors:

Microsoft Teams channel settings

After the App browser pops up look for the Incoming Webhook - Add option:

Incoming Webhook - Add panel

If you cannot see it; search for it using the search bar. Add the Incoming Webhook to your channel by clicking on the Add button.

Incoming Webhook item in the App browser

After adding the Webhook, you can name this connection and upload an image for it.

Icoming Webhook configuration panel

Clicking on the Create button will reveal the URL that Email This Issue needs to connect to your channel:

Microsoft Teams Incoming Webhook service URL

This concludes the setup process in Microsoft Teams.

Configuring the Webhook in Email This Issue

In Email This Issue you need to create a Custom Webhook:

Email This Issue Webhook creation panel

Copy the whole URL from the Incoming Webhook (in the Microsoft settings) and paste it in the Service URL section. There is no API Token needed, the Request header part can also be left as it is.

Enail This Issue webhook configuration panel

You can also configure the message (request body) here. Above you can see an example for a very simple alert, but you can use the syntax reference from the Microsoft documentation for further styling options. For the list of available variables and references please check out the Webhooks documentation page.