# 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.
