# Microsoft Teams Integration via Incoming Webhook

{% hint style="danger" %}
**Office 365 connectors within Microsoft Teams are deprecated, they will no longer work after 15.08.24.** Please use [Workflow](https://docs.ilert.com/chatops/microsoft-teams/chat/workflows), if you want to migrate an existing alert action you will need to create a new one.
{% endhint %}

{% hint style="warning" %}
If possible we suggest to use [ilert's Microsoft Teams Bot](https://docs.ilert.com/chatops/microsoft-teams/chat) for the setup, this guide and integration is only suggested in case you do not want to grant any permissions to ilert
{% endhint %}

## In Microsoft Teams: Add an ilert Connector to a channel <a href="#add-to-channel" id="add-to-channel"></a>

{% hint style="info" %}
**Admin permission required**

To set up the integration, you must have admin rights in ilert.
{% endhint %}

1. Select the channel in which you want to publish ilert Alerts and click **...** -> **Connectors**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FYbagNN51bT50tT2J5IT7%2F1.png?alt=media&#x26;token=2bc98788-ac0b-43b3-8556-674ad0d1b83f" alt=""><figcaption></figcaption></figure>

2. Type webhook in the search field and click **Add**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FJXS8CGCWUjpF32bdW3Df%2F2.png?alt=media&#x26;token=1823b155-0390-45ce-8b73-6e25ff111f56" alt=""><figcaption></figcaption></figure>

3. Again click on **Add**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FAASsiWxXvUYNny0DR6xy%2F3.png?alt=media&#x26;token=96c65bb6-8aaf-450a-b7e5-a94f755db24e" alt=""><figcaption></figcaption></figure>

4. Now in **Connectors** click on **Configure**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FWl79NV8uwpkoWY9GaqQz%2F4.png?alt=media&#x26;token=19eec25d-37d8-4d98-b06b-1fd830650731" alt=""><figcaption></figcaption></figure>

5. Type the **connector Name** and click **Create**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FToTzSpFxbcWQ5gSZPUtP%2F5.png?alt=media&#x26;token=e8a59d78-153f-49ef-8ee6-5fbe1da7c061" alt=""><figcaption></figcaption></figure>

6. Copy the **connector URL** and click **Done**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fluyn3xYoT6uGnmMrrGt2%2FScreenshot%202023-08-14%20at%2012.20.09.png?alt=media&#x26;token=be162a6e-1ca8-43d1-a239-d2347d34cab2" alt=""><figcaption></figcaption></figure>

7. Your connector has now been set up. You will need the URL from step 4 in ilert.

## In Microsoft Teams: Manage existing Connectors <a href="#create-alarm-source" id="create-alarm-source"></a>

1. Select the channel in which you want to publish ilert Alerts and click **...** -> **Connectors**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FYbagNN51bT50tT2J5IT7%2F1.png?alt=media&#x26;token=2bc98788-ac0b-43b3-8556-674ad0d1b83f" alt=""><figcaption></figcaption></figure>

2. In the **Manage** tab click on **Configured**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FIzN4lm3zkxHd93ukySdp%2F7.png?alt=media&#x26;token=2c23cd22-bf4d-4bb7-bd2a-3c6c6ba6eecb" alt=""><figcaption></figcaption></figure>

3. Now open up the dropdown list by clicking on **Configured** and click on the **Manage** button of the desired connector.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fu7qyTEV0dJXFv01XT0zX%2F8.png?alt=media&#x26;token=dbfbe84b-5b07-42e8-81fa-5e516799912f" alt=""><figcaption></figcaption></figure>

## In ilert: Create the Microsoft Teams Connector and link it to the alert source <a href="#create-alarm-source" id="create-alarm-source"></a>

1. Click the gear icon → **Connectors**

<div data-full-width="false"><figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FLgM1vB8U1wa0kgrnJtU7%2F9.png?alt=media&#x26;token=e98bc628-852c-4920-af41-7cb251f44f10" alt="" width="177"><figcaption></figcaption></figure></div>

2. Click **Create Connector**
3. Select **Microsoft Teams** as **Type**. Assign a name for the connector, enter the URL from [above](#add-to-channel) and save it.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F71vHoHLqWzcztetixFcg%2F10.png?alt=media&#x26;token=77cf3fe3-abcb-4f1d-b1c9-06a7173284cc" alt=""><figcaption></figcaption></figure>

4. **Go to** the alert sources tab and open the alert source whose alerts you want to publish to Microsoft Teams. Click **Alert Actions → Add New Alert Action**.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FTQ30opdXGQ02Ft0fJvWn%2F11.png?alt=media&#x26;token=3e15f31d-71a7-472d-be2c-b9b6e31840f2" alt=""><figcaption></figcaption></figure>

5. Select **Microsoft Teams** as the **type**, select the connector created in step 3, and name it.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FdeyYl0EPKbBiXjkAj9wM%2F12.png?alt=media&#x26;token=75936f2e-10ea-419d-b33c-ba0e8889b600" alt=""><figcaption></figcaption></figure>

6. Select the alert filters and conditions for execution as needed and save the alert action.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FOz1ni8q8XlWDHzFJ3M0U%2F13.png?alt=media&#x26;token=97f125b8-5283-4109-81c5-8fd680940654" alt=""><figcaption></figcaption></figure>

7. Finished! You can now test the connection by clicking on the button **Test this alert action**. Thereafter, a test message will be posted on the Microsoft Teams channel.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FH1VtqAoRIcFfsQ5lvtZv%2F14.png?alt=media&#x26;token=a6e1db77-4ef2-49a3-ac3e-6952c9637e40" alt=""><figcaption></figcaption></figure>

## FAQ <a href="#faq" id="faq"></a>

**Can I link multiple Microsoft Teams Spaces to an ilert account?**

Yes.

**Are updates to an alert published on the Microsoft Teams channel?**

Yes, the following updates to an alert are currently being released:

* **Escalations** : An alert is assigned to another user through an automatic escalation.
* **Manual Assignments** : An alert is manually assigned to someone.
* **Actions** : An alert is accepted or resolved.


---

# 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.ilert.com/chatops/microsoft-teams/chat/incoming-webhook.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.
