Slack User Guide

Using the Slack integration after installation

After completing the initial configuration, you can manage PagerDuty incidents in Slack.

Link User Accounts

In order for users to be able to perform PagerDuty actions from within Slack or create new channel connections on the PagerDuty side, users must first link their PagerDuty and Slack user accounts. This user-linking can be performed by each user as soon as the initial configuration has been completed for a given PagerDuty account and Slack workspace and can be initiated from either PagerDuty or Slack. The following describes how to link user accounts from Slack:

  1. In a public Slack channel, run the command /pd oncall, then, if prompted, choose the desired PagerDuty account.
  2. You'll receive a private message prompt in the same Slack channel; click the provided hyperlink to link your accounts.
  3. You’ll be directed to log into your PagerDuty account (make sure that you select the correct region and correct sign-on method (SSO or not) appropriate to your PagerDuty account); once you’ve completed authentication to the PagerDuty account, your Slack and PagerDuty users have been successfully linked.

Available Slash Commands

Once the updated integration has been installed, new slash commands will be available. You can run the following slash commands from any Slack channel that is connected with PagerDuty:

  • /pd help: Display a help message with a list of available slash commands.
  • /pd trigger: Trigger a new PagerDuty incident within the Slack interface.
  • /pd unlink: Unlink your current Slack user from your PagerDuty user.
  • /pd invite @[Slack User Name]: Invites the specified Slack user as a responder to your PagerDuty account.
  • /pd oncall: View who is on call for a PagerDuty service.
  • /pd insights: Configure the PagerDuty Analytics Slack integration to send recurring insights to Slack.

📘

PagerDuty EU

If your PagerDuty account is in the EU service region, you'll need to use /pdeu to run all slash commands instead of /pd.

🚧

Required Permissions

/pd oncall requires channel-specific permissions. You must invite @PagerDuty to private Slack channels in order to use this Slack slash command.

It is not possible to use this command in other direct messages outside of a direct message with @PagerDuty.

Incident Actions

When an incident is triggered, the incident notification message in Slack will display options for the following incident actions:

  • Acknowledge: Acknowledge the incident.
  • Resolve: Resolve the incident.
  • Run a Workflow: Run an Incident Workflow.
    1. Click Run a Workflow.
    2. Select an Incident Workflow from the dropdown.
    3. Click Run.
  • More actions…: Select the dropdown to access the below actions. Note: Not all actions are available on all pricing plans. Please contact Sales to upgrade to a pricing plan that offers any features not present in your account.
Incident actions in Slack

Incident actions in Slack

View Impacted Applications in Slack

View customer service application impact during an incident in Slack. Services with Salesforce or Zendesk integrations will list the number of cases related to the current incident, with links to individual cases.

PagerDuty incident card in Slack

PagerDuty incident card in Slack

To view individual cases:

  1. To the right of the application you would like to view, click [#] Cases.
  2. You will see a list of related cases in the modal that appears. Click a case number to navigate to the integrated application and view the case.
Linked SalesForce cases

Linked SalesForce cases

Create On-Demand Slack Channels

With this integration, PagerDuty users can create on-demand Slack channels from PagerDuty incidents, and from Slack incident notifications. The following features are available:

  • You may fully manage the incident using incident actions.
  • View all incident updates within the channel.
  • Added responders will be automatically added to the channel.
  • A dynamic conference bridge will be automatically added to the incident channel.

🚧

User Permissions

  • When you click Set Channel you may be prompted to authorize the connection between your PagerDuty and Slack accounts again, as PagerDuty will attempt to create a channel on behalf of your Slack user account.
  • You will only be able to view channels that you have permission to access in Slack.
  • If you do not have permission in Slack to create channels, you will not be able to create them from a PagerDuty incident’s Set Channel link.
  • If your PagerDuty account is connected to multiple Slack workspaces, you will have the option to select which workspace to use.

Create a Slack Channel from a PagerDuty Incident

  1. In the PagerDuty web app, navigate to your desired PagerDuty incident and click its Title to view the incident details screen.
  2. Click Set Channel to create an incident-specific Slack channel.
Create a Slack channel from an incident

Create a Slack channel from an incident

  1. Select from the following options:
    • Select existing Slack channel for this incident: Search and select an existing Slack channel.
    • Create a new Slack channel for this incident: You may use the auto-populated incident Slack channel title, or enter a new one. You may also select whether you would like the channel to be Public or Private.
    • Click Set Channel.
  2. The channel will be automatically created in Slack.

Create a Slack Channel from a Slack Incident Notification

  1. In Slack, navigate to your desired ​​PagerDuty incident notification.
  2. Click More actions... and select View | Create Channel. The integration will automatically create a Slack channel (which will include a Zoom conference bridge link) for this incident.
Create a channel in Slack

Create a channel in Slack

Create an Incident Trigger Slack Workflow

Slack workflows can be used to trigger PagerDuty incidents from Slack with pre-configured details such as the associated service and priority. This option is useful for employees who do not have PagerDuty licenses, but still need to be able to trigger PagerDuty incidents in Slack.

  1. In your Slack desktop app, click your workspace name dropdown in the top left and select Tools Workflow Builder. Click Create on the right, enter a workflow name, such as Trigger PD incident, and click Next.
  2. Click Select next to Shortcut, select your preferred channel under Which channel?, enter a name under Add a short name, such as Trigger PD incident, and then click Next.
  3. Next you will create a form for users to enter information about the incident. Click Add Step search for or select Send a form click Add.
  4. In the Send a form modal, enter the following information:
FieldValue
TitleEnter a Title for the form, such as Trigger PD incident.
Add a questionEnter Title. The answer given here will be the title of the incident that triggers.
Choose a question typeSelect Short answer in the dropdown.
Make this requiredEnable this checkbox.
Send submitted responses to a channel or to someone in a DMUncheck this checkbox.
  1. Click Save.
  2. Next, click Add Step search for or select Trigger PagerDuty incident Add.
    • If prompted, sign into your PagerDuty account, click Sign in. Once signed in, the Trigger PagerDuty Incident step will be added to your Slack workflow.
  3. Select your preferred Impacted service, optionally select the Assign to user and optionally select your preferred Priority.
  4. Under the Title textfield, click Insert a variable and select Response to: “Title” to add the Title form.
  5. Click Save.
    If you would like to add an optional message when someone uses this workflow, continue to step 10. If you do not want to add a message, skip to step 11.
  6. Send a Message With Workflow (Optional): Click Add Step and click Add next to Send a message. Under Send this message to: select Channel where workflow started. Under Message text enter your preferred message to be sent with the workflow. You have the option to include variables such as Impacted technical service, Incident number, Incident title, and Incident url by clicking Insert a variable under the message form. Click Save.
  7. Click Publish in the upper right to publish your workflow.

Use an Incident Trigger Slack Workflow

  1. In your Slack desktop app, select a channel with an Incident Trigger Slack Workflow configured click the Shortcuts at the bottom left of your text field select the Trigger PD incident workflow.
  2. Enter a Title for the incident and click Submit.

This will create an incident in PagerDuty, and you will also be able to see the incident details in your Slack channel.