Skip to content
Innomesh
Platform Since v3.5.2

Mattermost Integration

Innomesh supports Mattermost as a notification platform alongside Slack and Microsoft Teams. Alert notifications are routed to Mattermost channels based on criticality level, giving your support team real-time visibility into room and device issues within their existing messaging workflow. Mattermost integration was introduced in Innomesh v3.5.2.

Overview

Mattermost is an open-source, self-hostable messaging platform. For organisations that prefer to keep communications on-premise or within their own infrastructure, Mattermost provides an alternative to cloud-hosted services like Slack or Microsoft Teams.

Innomesh sends alert notifications to configured Mattermost channels via incoming webhooks. Each alert includes the room name, device, severity, and a direct link to the alert in the Innomesh Portal.

Prerequisites

  • A Mattermost instance (self-hosted or cloud) with incoming webhooks enabled
  • One or more Mattermost channels designated for Innomesh alerts
  • Admin access to Innomesh Portal (Administration section)

Setting Up Mattermost Integration

Step 1: Create an Incoming Webhook in Mattermost

  1. In Mattermost, navigate to Integrations > Incoming Webhooks.
  2. Click Add Incoming Webhook.
  3. Select the channel to receive Innomesh notifications.
  4. Give the webhook a display name (e.g., “Innomesh Alerts”).
  5. Click Save and copy the webhook URL.
📝 Note
Create separate webhooks for different channels if you want to route alerts by criticality (e.g., critical alerts to #innomesh-critical, low alerts to #innomesh-info).

Step 2: Configure in Innomesh Portal

  1. Navigate to Administration > Notification Settings in Innomesh Portal.
  2. Under Messaging Platforms, select Mattermost.
  3. Paste the webhook URL from Step 1.
  4. Configure channel routing by alert criticality:
    • Map each criticality level (Critical, High, Medium, Low) to a specific webhook/channel
    • Optionally use the same webhook for all levels
  5. Click Save.
  6. Click Send Test Notification to verify the connection.

Mattermost notification configuration showing webhook URL and channel routing by criticality Mattermost notification configuration, Innomesh Portal

Notification Format

Mattermost notifications include:

  • Alert severity: Colour-coded indicator (Critical, High, Medium, Low)
  • Room name and site
  • Device name and alert description
  • Direct link to the alert in Innomesh Portal
  • Timestamp

Notifications are formatted for improved searchability within Mattermost (enhanced in v3.5.3).

Troubleshooting

SymptomPossible CauseResolution
Test notification not receivedWebhook URL incorrect or expiredRegenerate the webhook in Mattermost and update the URL in Innomesh
Notifications going to wrong channelWebhook points to a different channelVerify the webhook is linked to the intended Mattermost channel
Notifications not appearing for some alertsChannel routing not configured for that criticality levelCheck that all desired criticality levels have a webhook configured
On this page