Mattermost Integration

TapeAlert allows you to send notifications directly to Mattermost channels. This integration is useful for teams that use Mattermost as their primary communication platform.

Setting Up Mattermost Integration

Step 1: Create an Incoming Webhook in Mattermost

First, you need to create an incoming webhook in your Mattermost instance:

  1. Log in to your Mattermost server as an administrator
  2. Go to Main Menu (the three dots in the top-left) > Integrations
  3. Click on Incoming Webhooks
  4. Click Add Incoming Webhook
  5. Fill out the form:
    • Title: Enter a name (e.g., “Tape Notifications”)
    • Description: Optional description
    • Channel: Select the channel where notifications should be posted
    • Username: (Optional) The username that will post the messages
    • Profile Picture URL: (Optional) An icon for the bot
  6. Click Save
  7. Copy the webhook URL that appears - you’ll need this in the next step

Step 2: Add Mattermost as a Destination in TapeAlert

Next, configure Mattermost as a notification destination:

  1. Navigate to your webhook in TapeAlert
  2. Click Add Destination
  3. Select Mattermost as the destination type
  4. Provide a name for this destination (e.g., “Dev Team Channel”)
  5. Paste the webhook URL you copied from Mattermost
  6. (Optional) Set a custom username for the notifications
  7. Click Save

Testing Your Integration

After setting up the Mattermost destination, you should test it:

  1. From your destination settings, click the Test button
  2. A test notification will be sent to your Mattermost channel
  3. Verify that the notification appears as expected

Notification Format

Mattermost notifications are carefully formatted to be concise yet informative:

  • Format: Text with markdown formatting
  • Critical Information: The most important information is included directly in the main message text
  • Workflow Links: Direct links to Tape workflows when available
  • Error Details: For error notifications, the specific error message is prominently displayed
  • Status Indicators: Icons help identify notification types (⚠️ for errors, 📢 for general notifications)

Example Notification

For a workflow error, the notification will look like: