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

  1. To manage PagerDuty incidents in Zendesk, navigate to a Zendesk ticket and then click the Apps button on the right side of the screen.
  2. 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.
Log in to PagerDuty

Log in to PagerDuty

  1. 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.

    ActionInstructions
    AcknowledgeAcknowledge that you are working on the incident and pause any further escalation. Confirm your selection by clicking Acknowledge in the modal.
    ResolveResolve the incident. Enter an optional resolution note and click Resolve in the modal.
    Edit Incident DetailsEdit 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 Response Play*Run a Response Play to mobilize responders, engage stakeholders with status updates, and set up conference bridge collaboration at once. Select a Response Play from the dropdown and click Run Response Play.
    Run an Incident WorkflowRun 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 ActionsRun Automation Actions from PagerDuty to execute scripts run by an automation runner and shorten resolution times.
    EscalateEscalate the incident to another user or level on the associated escalation policy. Select a user from the dropdown and click Escalate.
    Add NoteAdd a note about the incident to communicate with internal teams following it. Enter your desired text and then click Add Note.
    ReassignReassign the incident to a different user or to another team’s escalation policy. Select Users and/or an Escalation Policy, and click Reassign.
    Unlink IncidentUnlink the incident from this Zendesk ticket. You’ll be prompted to confirm your selection — click Unlink Incident in the modal.
  1. 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

  1. While viewing a Zendesk ticket, expand the PagerDuty app from the right pane and select Create Incident.
  2. Enter values for the following fields: Incident title, PagerDuty Service, PagerDuty Priority and Incident description.
  3. Click Create Incident.

Link to a PagerDuty Incident

  1. While viewing a Zendesk ticket, expand the PagerDuty app from the right pane and select Link Incident.
  2. In the modal’s dropdown, search or select a PagerDuty incident.
  3. 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

Note: You can view up to 10 linked Salesforce records 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.

  1. In PagerDuty, click an incident's Title to open the incident details page.

  2. Select More ​​ Create Ticket - your-subdomain.

  3. In the Create Ticket modal enter the following information:

  • Ticket Type
  • Ticket priority
  • Subject
  • Comment
  1. Click Create Ticket.

Zendesk will create a corresponding ticket via its API:

Linked case in Zendesk

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:

  1. 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.
  2. Click View Status Dashboard.

To view a different status dashboard:

  1. Click .
  2. Select your preferred dashboard from the dropdown.
  3. Click Save.