Link Search Menu Expand Document

Mattermost Outgoing Webhooks Integration Guide

Logo Company Estimated Time Functionality Vendor Docs
Mattermost Inc. Mattermost Inc. 3 minutes One-Way view

Mattermost Outgoing Webhooks 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.

Important Information

  • Mattermost to PagerTree (keyword trigger) - Continue reading this page
  • PagerTree to Mattermost (post to channel) - See Mattermost Integration

How Mattermost users benefit from PagerTree

Mattermost Outgoing Webhooks triggers a webhook anytime a Mattermost message starts with configured trigger words. PagerTree will create an alert based on these webhooks, determining the right people to notify based on on-call schedules. PagerTree notifies them via email, sms, voice, and/or push notifications until the alert is acknowledged or closed.

Functionality of Integration

The Mattermost Outgoing Webhooks integration is one-way, meaning:

  • An alert will be created in PagerTree when Mattermost sends an Outgoing Webhook to PagerTree.
  • PagerTree will try to extract an urgency from the message text. Valid values are low|medium|high|critical. If the urgency is not found in the message text it will default to the integration urgency.

Tutorial Overview

In this integration tutorial we will show you how to connect your Mattermost Outgoing Webhooks integration with PagerTree. The estimated time for this integration is 3 minutes. We assume that you already have a PagerTree and Mattmost account setup.

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.
    2. Select the Type to Mattermost Outgoing Webhooks
    3. Select an appropriate Urgency for when this integration is triggered
    4. Select the Team this alert will be assigned to Click Create
  3. Click Save
  4. Copy the Endpoint URL Copy Endpoint URL

In Mattermost

  1. Go to Menu and choose Integrations Select Integrations
  2. At the following screen choose Outgoing Webhooks Select Outgoing Webhooks
  3. Click the button on the top right Add Outgoing Webhook Select Add Outgoing Webhook
  4. Setup the outgoing webhook
    1. Content Type - Specify application/json.
    2. Channel - Select an appropriate channel this will apply to, or any for all channels.
    3. Trigger Words - Select the words that trigger the webhook (e.g. outage, sev-1, down).
    4. URL(s) - Paste the PagerTree Endpoint URL you copied. Configure Outgoing Webhook
  5. Click Save
  6. On the next screen Copy the Token value, as this can be used for the additional security step below. Copy Token

Bonus: Additional Security

For security purposes, you can also provide PagerTree with the token Mattermost provides. If using this feature, PagerTree will not create an alert unless the token sent by Mattermost is the same token that is configured with the integration. This protects against spoofing attacks.

In PagerTree
  1. From the Integration Page, Click Edit
  2. Paste the Token that you copied from Mattermost to the Token field.
  3. Click “Save”

You have successfully completed the Mattermost Outgoing Webhooks Integration. Now PagerTree will create an alert any time a message starts with trigger words and are on the specified channels. If you have any questions please contact support@pagertree.com


© 2016-2022 PagerTree LLC. All rights reserved.