Slack Outgoing WebHooks Integration Guide

Slack Outgoing WebHooks Integration

Slack brings team communication and collaboration into one place so users can get more work done.

Note. This documentation is meant for Slack Outgoing WebHooks. If you are looking for Slack notifications, please refer to the documentation here.

How Slack users benefit from PagerTree

Slack Outgoing WebHooks triggers a webhook anytime a slack message starts with configured trigger words. PagerTree will create an incident 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 incident is acknowledged or closed.

Functionality of Integration

The Slack Outgoing WebHooks integration is one-way, meaning:

  • An incident will be created in PagerTree when Slack 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 Slack Outgoing WebHooks integration with PagerTree. The estimated time for this integration is 3 minutes. We assume that you already have a PagerTree and Slack account setup.

In PagerTree

  1. From the navigation menu, click the “+ Integration” button. Click Plus Integration Button
  2. In the “Create Integration” box, fill out the following:
    1. Name of the Integration
    2. Select the Integration Type to Slack (Outgoing WebHook)
    3. Select an appropriate urgency for when this integration is triggered
    4. Select the team this incident will be assigned to Click Create
  3. Click “Create”
  4. Copy the Endpoint URL Copy Endpoint URL

In Slack

  1. Go to Slack Outgoing WebHooks App Page
  2. On the App page, click “Add Configuration” Click Add Configuration
  3. On the New configuration page, click “Add Outgoing WebHooks Integration” Click Add Outgoing WebHooks integration
  4. Scroll down the page to the Integration Settings
    1. Channel - Select an appropriate channel this will apply to, or any for all channels.
    2. Trigger Words - Select the words that trigger the webhook (e.g. outage, sev-1, down).
    3. URL(s) - Paste the PagerTree Endpoint URL you copied.
    4. Descriptive Label - Easy to remember label on what this outgoing webhook does. Integration Settings
  5. Click “Save Settings” Click Save Settings

Bonus: Additional Security

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

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

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