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.

Important Information

• Slack to PagerTree (keyword trigger) - Continue reading this page
• PagerTree to Slack (post to channel) - See Slack Incoming Webhooks
• Slack Notifications - See Slack Notifications

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 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 Slack Outgoing Webhooks integration is one-way, meaning:

• An alert 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 action button, click the “Create Integration” button.
2. In the “Create Integration” box, fill out the following:
   1. Name of the Integration.
   2. Select the Type to Slack Outgoing Webhooks
   3. Select an appropriate Urgency for when this integration is triggered
   4. Select the Team this alert will be assigned to
3. Click Save
4. Copy the Endpoint URL

In Slack

1. Go to Slack Outgoing Webhooks App Page
2. On the App page, click “Add Configuration”
3. On the New configuration page, 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.
5. 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 alert 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

In PagerTree

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

---

You have successfully completed the Slack 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

---