Mattermost Integration Guide

Mattermost Integration

Mattermost is an open-source, self-hostable online chat service with file sharing, search, and integrations. It is designed as an internal chat for organisations and companies.

How Mattermost users benefit from PagerTree

Messages are sent to Mattermost channels, making sure the right channels are notified of alerts.

Functionality of Integration

The Mattermost integration is one-way, meaning:

  • When an alert in PagerTree is opened/acknowledged/resolved/dropped, PagerTree will post a message to a channel of your choice.

Tutorial Overview

In this integration tutorial we will show you how to send alerts from PagerTree into Mattermost channel. The estimated time for this integration is 3 minutes. We assume that you already have a PagerTree and Mattermost account setup.

In Mattermost

  1. In the top left, click the hamburger menu icon, then select Integrations. Click Integrations
  2. On the integrations page, click the Incoming Webhooks. Click Incoming Webhooks
  3. On the Incoming Webhooks page, click the Add Incoming Webhook button. Click Add Incoming Webhook
  4. In the Add Form:
    1. Title - PagerTree
    2. Channel - Select the channel you want PagerTree to post messages to
    3. Username - pagertree
    4. Profile Picture - https://pagertree.com/assets/img/logo/pagertree-icon-256-256.png
    5. Click Save. Configure Webhook
  5. Click Copy Icon Button. Copy Webhook URL
  6. Click Done.

In PagerTree

  1. From the action button, click the “Create Integration” button. Click Create Integration Button
  2. In the “Create Integration” box, fill out the following:
    1. Name of the Integration. (ex: “Mattermost Chat - #Devops”)
    2. Select the Type to Mattermost. Click Create
  3. Click Save.
  4. In the Integration Options section:
    1. Double click the URL option. Double click incoming webhook url option
    2. Paste the URL you copied earlier. Paste the generated url you copied
    3. Click Save.
  5. Enable Events that should trigger messages to your channel. Enable events to trigger messages

You have successfully completed the Mattermost Integration. Now when an alert event is created in PagerTree and it matches your preferences, PagerTree will send a message to Mattermost. If you have any questions please contact support@pagertree.com