> For the complete documentation index, see [llms.txt](https://docs.meta-inf.hu/email-this-issue/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meta-inf.hu/email-this-issue/administration/alerting-via-webhooks/webhooks/configuring-microsoft-teams-to-receive-alerts-via-webhooks.md).

# 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 

{% hint style="warning" %}
If you [can't add a connection](https://techcommunity.microsoft.com/t5/microsoft-teams/can-t-add-connector-to-team/m-p/2516559)[ ](https://techcommunity.microsoft.com/t5/microsoft-teams/can-t-add-connector-to-team/m-p/2516559)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.
{% endhint %}

## 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](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FBM4lDnxPK8M4NPWEVjDp%2F2022-07-06_12h23_06.png?alt=media\&token=c25b8339-31d6-48f9-a4ca-df55853ba794)

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

![Incoming Webhook - Add panel](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FR2tglqMcLhAEt1otbz4q%2Fimage.png?alt=media\&token=8d711fd7-e678-4d89-931e-8b060a71f1d9)

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 ](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FhOEoQhRsEZ1syl39zLiD%2Fimage.png?alt=media\&token=f0b632b9-27b3-429a-9faf-9184da5a2a50)

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

![Icoming Webhook configuration panel ](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FS7ucdGBZxbjzYeJARC5B%2F2022-07-06_13h49_23.png?alt=media\&token=50a9eea8-8937-4bc6-9e39-32b84e454b64)

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](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FMx0Tph7D6ZVEIO3vBHGH%2F2022-07-06_14h09_44.png?alt=media\&token=3b1013f0-adab-497d-83d5-5354e052d496)

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](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FQwZPMDbL0AcgvGmeJzDU%2F2022-07-06_14h09_32.png?alt=media\&token=84284469-8ad6-42f0-9977-008426f3c490)

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](https://880912854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mf8H-oTE_fhOrUtfYrN-2724419853%2Fuploads%2FguUYRMFhoFaBsZBRlWR9%2F2022-07-06_14h28_36.png?alt=media\&token=70d4b871-1d24-4e4a-9c20-4b035d5db670)

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](https://docs.microsoft.com/hu-hu/outlook/actionable-messages/message-card-reference) from the Microsoft documentation for further styling options. For the list of available variables and references please check out the [Webhooks](/email-this-issue/administration/alerting-via-webhooks/webhooks.md) documentation page.