Zendesk User Guide
Using the Zendesk integration after installation
After completing the integration configuration, you can manage PagerDuty incidents in Zendesk, create Zendesk tickets from PagerDuty incidents, and view the PagerDuty Status Dashboard within Zendesk.
Pricing Plan
The Zendesk integration is available to accounts on the following pricing plans: Customer Service Professional, Customer Service Business, Customer Service Digital Operations (legacy) and Enterprise for Customer Service. Please contact our Sales Team if you would like to upgrade to a plan featuring the Zendesk integration.
Manage PagerDuty Incidents From Zendesk
- To manage PagerDuty incidents in Zendesk, navigate to a Zendesk ticket and then click the Apps button on the right side of the screen.
- The PagerDuty app will appear and prompt you to log in to your PagerDuty account. Note: If you do not have a PagerDuty account, you can still view any incidents that are linked to this incident, but you cannot take any actions to coordinate a response or communicate with stakeholders.
![zendesk-login-incident-command-console.png Log in to PagerDuty](https://files.readme.io/f12482b-zendesk-login-incident-command-console.png)
Log in to PagerDuty
- Once you've logged in, you can take the following actions from the Zendesk Incident Command Console, on the right-hand side of a ticket:
-
Create Incident or Link Incident: Create a new incident or link to an existing open incident.
- The following actions are also available from the menu:
Required User Permissions
If you do not see some of actions listed below, you may have a limitation based on your permissions, which are listed in each feature's linked article. Please contact your team’s admin user for assistance.
* Features marked with an asterisk are available to users on the following pricing plans: Business, Digital Operations (legacy) and Enterprise for Incident Management. Please contact our Sales Team if you would like to upgrade to a plan with these features.
Action Instructions Acknowledge Acknowledge that you are working on the incident and pause any further escalation. Confirm your selection by clicking Acknowledge in the modal. Resolve Resolve the incident. Enter an optional resolution note and click Resolve in the modal. Edit Incident Details Edit the PagerDuty incident's title or incident priority, then click Update incident. Add Responders* Add more responders to help with the incident. Select Users and/or Escalation Policies , enter an optional message, and then click Add Responders. Add Subscribers* Add Subscribers to the incident, who will receive any future status updates. Select the desired Users and/or Teams, and then click Add Subscribers. Send a Status Update* Send a status update to internal users that are subscribed to this incident. Enter your desired text and click Send a Status Update. Run an Incident Workflow Run an Incident Workflow to mobilize responders, engage stakeholders with status updates, and set up collaboration in Slack, Zoom, and MS Teams. Select an Incident Workflow from the dropdown and click Run. Run Automation Actions Run Automation Actions from PagerDuty to execute scripts run by an automation runner and shorten resolution times. Escalate Escalate the incident to another user or level on the associated escalation policy. Select a user from the dropdown and click Escalate. Add Note Add a note about the incident to communicate with internal teams following it. Enter your desired text and then click Add Note. Reassign Reassign the incident to a different user or to another team’s escalation policy. Select Users and/or an Escalation Policy, and click Reassign. Unlink Incident Unlink the incident from this Zendesk ticket. You’ll be prompted to confirm your selection — click Unlink Incident in the modal.
- If you would like to condense the information in the Incident Command Console, you can collapse the Detail, Timeline or Notes headers. You can also click at the bottom of the console to choose which pieces of information should be displayed.
Create a PagerDuty Incident
- While viewing a Zendesk ticket, expand the PagerDuty app from the right pane and select Create Incident.
- Enter values for the following fields: Incident title, PagerDuty Service, PagerDuty Priority and Incident description.
- Click Create Incident.
Link to a PagerDuty Incident
- While viewing a Zendesk ticket, expand the PagerDuty app from the right pane and select Link Incident.
- In the modal’s dropdown, search or select a PagerDuty incident.
- Click Link Incident. This will link the Zendesk ticket to the PagerDuty incident. You can view the link to the Zendesk ticket on the PagerDuty incident's details page.
- If multiple PagerDuty incidents are related to a Zendesk ticket, you can repeat this as many times as needed.
![Linked Zendesk ticket Linked Zendesk ticket](https://files.readme.io/95b63d6-Linked_Zendesk_ticket.png)
Linked Zendesk ticket
Note: You can view up to 10 linked Zendesk tickets on the PagerDuty incident's details page.
Create a Zendesk Ticket From a PagerDuty Incident
If you ever want to create a Zendesk ticket based on a PagerDuty incident, you can do so from the PagerDuty incident’s details page. You will only be able to create a Zendesk ticket if the incident’s service is connected to Zendesk.
-
In PagerDuty, click an incident's Title to open the incident details page.
-
Select More Create Ticket -
your-subdomain
. -
In the Create Ticket modal enter the following information:
- Ticket Type
- Ticket priority
- Subject
- Comment
- Click Create Ticket.
Zendesk will create a corresponding ticket via its API:
![zendesk-api-ticket-example.png Linked case in Zendesk](https://files.readme.io/33e9868-zendesk-api-ticket-example.png)
Linked case in Zendesk
View Status Dashboard in Zendesk
Pricing Plans
The Status Dashboard feature is available on the following pricing plans: Customer Service Business, Customer Service Digital Operations (legacy) and Enterprise for Customer Service. Please contact our Sales Team if you would like to upgrade to a plan including the Status Dashboard feature.
The PagerDuty Status Dashboard is available in Zendesk, allowing support agents to check real-time system health from where they work.
To view your Status Dashboard:
- In a Zendesk account with the PagerDuty Zendesk integration configured, click the PagerDuty app at the top right. You will see a dropdown with an overview of your current status.
- Click View Status Dashboard.
To view a different status dashboard:
- Click .
- Select your preferred dashboard from the dropdown.
- Click Save.
Updated about 1 month ago