Configuring Mattermost Channels
Mattermost channels deliver alert notifications to a Mattermost channel through an incoming webhook URL. Managing Notification Channels describes the operations that every channel type shares, such as creating, testing, and enabling a channel.
Creating a Mattermost Channel
Use the following steps to create a Mattermost channel in the Workbench:
- Create an incoming webhook in Mattermost, as described in Creating a Mattermost Webhook.
- Open the
Administrationconsole, and selectMattermost Channelsin theNOTIFICATIONSsection of the navigation pane. - Select
Add Channelto open theCreate Mattermost channeldialog. - Enter a name for the channel and, optionally, a description; then paste the
webhook URL into the
Webhook URLfield. - Leave
Enabledon, and turn onEstate Defaultif the channel should be active for every server that has no override. - Select
Createto save the channel. - Select the send icon (tooltip
Send test notification) in the channel's row to send a test message and confirm the configuration.
To change a channel later, select the edit icon in the channel's row on the
Mattermost Channels page.
Mattermost Channel Settings
The following table describes the settings in the Create Mattermost channel
dialog:
| Setting | Required | Description |
|---|---|---|
| Name | Yes | A descriptive name for the channel. |
| Description | No | An optional description of the channel. |
| Webhook URL | Yes | The Mattermost incoming webhook URL. |
| Enabled | No | Toggles the channel on or off; on by default. |
| Estate Default | No | Makes the channel active for every server that has no override; off by default. See Estate Defaults. |
Creating a Mattermost Webhook
To create an incoming webhook in Mattermost, follow these steps:
- Navigate to Main Menu, then Integrations.
- Select Incoming Webhooks and create a new webhook.
- Choose the target channel for notifications.
- Copy the generated webhook URL into the channel settings.
For detailed instructions, see the Mattermost Incoming Webhooks documentation.
Mattermost Templates
Mattermost channels support custom templates in the same way as Slack channels; Slack and Mattermost Templates describes the template fields and how the alerter escapes template variables for Mattermost.