Configuring Mattermost Integration

StatusDrift integrates with Mattermost to deliver monitoring alerts directly to your team’s channels. This guide explains how to configure the Mattermost integration using incoming webhooks.

What This Integration Does

The Mattermost integration sends notifications to your channels when:

• A monitored service goes down or becomes unreachable
• A service recovers and returns to normal operation
• SSL certificates are expiring or have issues
• Performance thresholds are exceeded

Messages are formatted with clear status indicators and include relevant details about the monitoring event.

Prerequisites

Before configuring the Mattermost integration, ensure you have:

• A Mattermost workspace with admin permissions to create webhooks
• A StatusDrift account with notification channel management access
• A dedicated channel for monitoring alerts (recommended)

Step 1: Create an Incoming Webhook in Mattermost

First, create an incoming webhook in your Mattermost workspace:

1. Log in to your Mattermost workspace
2. Click the hamburger menu and select Integrations
3. Click Incoming Webhooks
4. Click Add Incoming Webhook
5. Enter a title like “StatusDrift Alerts”
6. Select the channel where alerts should be posted
7. Optionally set a custom username and icon
8. Click Save
9. Copy the Webhook URL that is generated

Step 2: Add the Mattermost Channel in StatusDrift

Now configure the integration in your StatusDrift dashboard:

1. Log in to your StatusDrift account at app.statusdrift.com
2. Navigate to Notification Channels in the sidebar
3. Click Add Channel
4. Select Mattermost as the channel type
5. Enter a descriptive name like “Mattermost – Ops Channel”
6. Paste the Webhook URL from Mattermost
7. Click Save to create the channel

Step 3: Assign to Monitors

Connect the notification channel to your monitors:

1. Go to Monitors in the StatusDrift dashboard
2. Select the monitor you want to configure
3. Scroll to the Notification Channels section
4. Enable the Mattermost channel you created
5. Save your changes

Testing the Integration

Verify your Mattermost integration is working:

1. Go to Notification Channels in StatusDrift
2. Find your Mattermost channel in the list
3. Click the Test button
4. Check your Mattermost channel for the test message

Message Format

StatusDrift sends formatted messages to Mattermost that include:

• Status indicator – Color-coded for quick visual identification
• Monitor name – Which service triggered the alert
• Event type – Down, up, SSL warning, etc.
• Timestamp – When the event occurred
• Error details – Response codes or error messages when available

Troubleshooting

Messages not appearing in Mattermost

• Verify the Webhook URL is copied correctly without extra spaces
• Confirm incoming webhooks are enabled in your Mattermost system settings
• Check that the webhook is not deleted or disabled
• Use the Test button in StatusDrift to send a test message

Messages going to wrong channel

• Each webhook is tied to a specific channel in Mattermost
• To change channels, create a new webhook for the desired channel
• Update the Webhook URL in StatusDrift

Formatting issues

• Ensure your Mattermost version supports incoming webhook formatting
• Check if any custom formatting plugins are interfering