# Mattermost Integration

The [Mattermost](https://mattermost.com/) integration allows ilert to automatically post updates about alerts or incidents to your Mattermost channels. This ensures your teams stay aligned during outages or escalations, facilitating faster communication and real-time incident collaboration.

{% hint style="warning" %}
To set up this integration, you must have admin rights in ilert.
{% endhint %}

## In Mattermost: Create an incoming webhook <a href="#add-to-channel" id="add-to-channel"></a>

1. Go to the main menu and click **Integrations**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSx8eVskipa3667b3eC%2F-MSx9q9xEwwNHRJ_EMTr%2FScreenshot_07_02_21__16_44.png?alt=media\&token=8deb2244-f803-4aa8-84d7-8b082634097c)

2. Click on **Incoming Webhooks**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSx8eVskipa3667b3eC%2F-MSxA6n4DtODinR_xOSz%2FScreenshot_07_02_21__16_45.png?alt=media\&token=9175286a-2eab-4404-9ecd-8803e6a08007)

3. On the next page click on the **Add incoming Webhook** button

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSx8eVskipa3667b3eC%2F-MSxATmsDtu3NA9a8Oh4%2FScreenshot_07_02_21__16_47.png?alt=media\&token=30885ce8-e648-4b8a-ae8a-fcc2a53fb331)

4. On the next page, name the webhook e.g. **iLert**, choose **a channel** and click on the **Save** button.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSx8eVskipa3667b3eC%2F-MSxB0j8uLJrcRTNOlFH%2FScreenshot_07_02_21__16_49.png?alt=media\&token=453dfd54-95e7-460b-a87b-62ee5800e9af)

5. Your webhook has now been set up. You will need the URL in the next step.

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

1. Click on the gear icon and navigate to → **Connectors**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-da01367fa650f8ebb847143f5c33130440a865e8%2Fgo_to_connectors%20\(3\).png?alt=media)

2. Click on **Add Connector**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-84b162bdc422a867250f28e5614028cdc07471b0%2Fcreate_connector_button%20\(8\).png?alt=media)

3. Select **Mattermost** as **Type**. Assign a name for the connector, enter the URL from above and save it.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MSx8eVskipa3667b3eC%2F-MSxBn4dHbHw2FaqnU9P%2FScreenshot_07_02_21__16_53.png?alt=media\&token=852c8597-bea5-4d78-b43f-3865e192a07c)

4. **Go to** the alert sources tab and open the alert source whose alerts you want to publish to Mattermost. Click **Alert actions → Create alert action**.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fgit-blob-9887e1978c30c61025f427813bcf148b4a9d8282%2Fnew_incident_action%20\(7\)%20\(1\).png?alt=media)

5. Select **Mattermost** as the **type**, select the connector created in step 3 and give your connection a name.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-Ma7z8Vot-JQBt0MIv9d%2F-Ma80jrjGjSI2qQ4eBND%2FiLert.png?alt=media\&token=f269e10f-cbf8-4509-bd56-e0505607f56a)

6. Finished! You can now test the connection by clicking on the **Test this connection** button. A test message will be posted in the Mattermost channel.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-Ma7z8Vot-JQBt0MIv9d%2F-Ma810RmlK6-iltwwzbJ%2FiLert.png?alt=media\&token=99e1927a-a306-4f38-82d8-81993f4820a9)

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

**Can I link multiple Mattermost Spaces to an ilert account?**

Yes.

**Are updates to an alert published in the Mattermost channel?**

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

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