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:
- In a public Slack channel, run the command
/pd oncall
, then, if prompted, choose the desired PagerDuty account. - You'll receive a private message prompt in the same Slack channel; click the provided hyperlink to link your accounts.
- 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.
- Click Run a Workflow.
- Select an Incident Workflow from the dropdown.
- 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.
- Add a Note : Add a note to the incident.
- Add Responder: Add a responder to the incident.
- View Details: View incident details within the PagerDuty web app.
- Add Task: Create and assign an Incident Task.
- View Tasks: View existing Incident Tasks for this incident.
- Assign Roles: Assign Incident Roles to responders.
- Change Priority : Change an incident’s priority.
- Reassign: Reassign the incident to another user.
- Escalate: Escalate the incident to the next on-call responder.
- View | Create Channel: Create an on-demand Slack channel for the current incident.
- New Status Update: Create a new status update for the incident.
- Run an Action: Run an Automation Action.
![Incident actions in Slack](https://files.readme.io/85ce3ea-slack-more-actions.png)
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](https://files.readme.io/84d385d-small-view-impacted-apps-slack.png)
PagerDuty incident card in Slack
To view individual cases:
- To the right of the application you would like to view, click
[#]
Cases. - 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](https://files.readme.io/0ae8c48-small-view-impacted-apps-slack-modal.png)
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
- In the PagerDuty web app, navigate to your desired PagerDuty incident and click its Title to view the incident details screen.
- Click Set Channel to create an incident-specific Slack channel.
![Create a Slack channel from an incident Create a Slack channel from an incident](https://files.readme.io/2f9bfea-slack-set-channel.png)
Create a Slack channel from an incident
- 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.
- The channel will be automatically created in Slack.
Create a Slack Channel from a Slack Incident Notification
- In Slack, navigate to your desired PagerDuty incident notification.
- 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](https://files.readme.io/f528c72-slack-create-channel.png)
Create a channel in Slack
Create an Incident Trigger Slack Workflow
Slack workflows can be used to trigger PagerDuty incidents via Slack with pre-configured details such as the associated service. This option is useful for employees who do not have PagerDuty licenses, but still need to be able to trigger PagerDuty incidents in Slack.
Slack’s New Workflows
With the deprecation of Slack’s legacy workflows, we highly recommend utilizing Slack's new Workflow Builder for creating incident trigger workflows.
The new Workflow Builder’s PagerDuty connector steps were developed by Slack. For issues or concerns with these connector steps, please reach out to Slack’s Support team.
-
In your Slack desktop app, click the top left Workspace dropdown and select Tools Workflow Builder.
-
Click Create Workflow. Select the option for how you’d like to start the workflow. Enter the required information, if any, then click Continue.
-
Next, you will create a form for users to enter information about the incident. On the Steps panel, search for or select Collect info in a form.
-
In the Collect info in a form modal, enter the following information:
Field Value Title Enter a Title for the form, such as Trigger PD incident
.Answer format Select Single line of text
in the dropdown.Your question Enter a Title
.
This will be the title of the incident that triggers.Make this required Enable this checkbox. -
Click Save.
-
Next, on the Steps panel, search or select the PagerDuty connector’s Trigger an incident step.
-
On the Trigger an incident modal:
-
Click Edit next to the option PagerDuty account being used for this step.
On the Accounts modal, select whose PagerDuty account should be used for triggering an incident.
To use a different PagerDuty user account, click Switch Accounts, then select an account from the list of connected accounts, or connect a new account. After selecting a PagerDuty account, click Save. -
Enter the following information:
Field Value Incident title Click Insert a variable and select Answer to: Title
to add theTitle
value collected from the form.Incident details Enter your preferred message to be sent with the workflow.
You have the option to include variables that contain PagerDuty Incident, Escalation policy, Service, and Team data by clicking Insert a variable under the message form.Service Select the preferred Service for the new incident. Escalation policy Select the preferred Escalation Policy for the new incident. -
Click Save.
-
-
If you would like to add an optional message when someone uses this workflow, continue to step 9. If you do not want to add a message, skip to step 10.
-
(Optional) On the Steps panel, search for or select the Send a message to a channel step.
On the Send a message to a channel modal, enter the following information:
Field Value Select a channel Select Channel where the workflow was used
.Add a message Enter your preferred message to be sent with the workflow.
Click Insert a variable under the message form to include variables that contain PagerDuty Incident, Escalation Policy, Service, and/or Team data.Click Save.
-
Click Finish Up in the upper right. Enter the workflow’s details and permissions, then click Publish.
Use an Incident Trigger Slack Workflow
- 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. - 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.
Add a Slack Contact Method
Once the Slack integration has been configured, you can add Slack as an incident contact method. Please see our User Profile article for more information.
Updated about 1 month ago