# 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&#x20;

{% 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.&#x20;

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

![Microsoft Teams channel settings](/files/06Sp9Xjdr04U6GsvS9Qp)

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

![Incoming Webhook - Add panel](/files/zPGTpW6DViWRJpXnaoOM)

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 ](/files/TpZRM0Busm2M8wODnfbQ)

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

![Icoming Webhook configuration panel ](/files/e7hOhtngEH8qakDdDnm8)

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](/files/bjACZdC67GRCbXIhdhvq)

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](/files/Jflk3pdCjLrGgm71VnW6)

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](/files/CAyhqRhxocSOzSEEn5TY)

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meta-inf.hu/email-this-issue/administration/alerting-via-webhooks/webhooks/configuring-microsoft-teams-to-receive-alerts-via-webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
