Slack Slash Command (Legacy) Integration Guide

NOTE: This integration triggers PagerDuty incidents from Slack and is intended to complement the Slack v1 legacy extension. We have since updated our Slack integration offering with a Slack V2 extension, which includes capabilities from the Slack v1 legacy extension, embedded /pd slash commands (including one to trigger incidents from Slack), plus more features that let you work directly from Slack. Please refer to the most up to date Slack V2 integration guide for more details.

Slack is a powerful chat tool that can be used by organizations to tie various services into a single communications platform. Slack makes it easy to communicate with your team. This integration allows you to trigger incidents in PagerDuty from Slack. This complements our PagerDuty to Slack integration which posts information about PagerDuty incidents to Slack channels.

In PagerDuty

1. Go to the Services menu and select Service Directory.
2. On the Service Directory page:
   • If you are creating a new service for your integration, click +New Service.
   • If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click Add a new integration.
3. Select your app from the Integration Type menu and enter an Integration Name. If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.
4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service, click the service Name.
5. Copy the Integration URL for your new integration.

In Slack

1. In a browser, navigate to https://api.slack.com/apps
2. Click Create New App.
3. Give the app a name, select your Development Slack Workspace, and click Create App.
4. Under Add features and functionality, click Slash Commands and then Create New Command.
5. Under Command, enter a slash and then an all lowercase sequence of letters (with no spaces, e.g. /pd or /pdincident)
6. Copy and paste the Request URL from your Slack integration in PagerDuty (it is listed as Integration URL in PagerDuty)
7. Enter in a short description and (optionally) fill in the Usage Hint field. Then hit Save at the bottom right.
8. Click OAuth & Permissons on the left and then click Install App to Workspace.
9. Click Authorize on the next screen.
10. You are done! Go to Slack and enter in your slash command to test it out!

FAQ

 Can I use the command in any channel in Slack?

Yes! You can use the command in any channel in Slack to trigger a PagerDuty Incident.

Can I acknowledge or resolve incidents using the command?

At this time you can only trigger incidents using the command.