Overview
From a customer-impact standpoint, support tickets are one of the key indicators of which customers are being currently impacted by an incident. FireHydrant's Zendesk integration allows users to link Zendesk support tickets to an incident to help track customer impact and guide customer communications.
There are 2 parts to the Zendesk integration configuration:
- Enabling the Zendesk integration from the FireHydrant Integrations page
- Installing the FireHydrant Zendesk Marketplace app in Zendesk
Prerequisites
The Zendesk integration is only available for Enterprise-level FireHydrant accounts.
Configuring the FireHydrant Zendesk Integration
Prerequisites
A FireHydrant owner role is required to configure the Zendesk integration in FireHydrant. In order to install the FireHydrant Zendesk Marketplace app, you'll need to have a Zendesk administrator role.
Installation
Navigate to the Integrations configuration page from the left-hand navigation bar. Choose to add the Zendesk integration.
You will be prompted with the following dialog. FireHydrant recommends using a generic Zendesk admin account to authorize the connection. This helps to prevent disruption should a named employee depart and their Zendesk account be decommissioned. 
Enter your Zendesk subdomain url, for example:
https://[your-company].zendesk.com/
Click Authorize Application. The integration details will appear, including date installed and the authorizer.
Uninstalling the Zendesk Integration from FireHydrant
From the Integrations page, choose to edit the Zendesk integration. Click Uninstall Zendesk.
Configuring the FireHydrant Zendesk Marketplace App
The FireHydrant Zendesk Marketplace app allows support staff to create FireHydrant incidents. If you prefer not to install the app, it is still possible to link Zendesk tickets to an incident from FireHydrant, but you won't be able to create new incidents or link existing FireHydrant incidents from Zendesk.
Prerequisites
- Ensure that the Zendesk integration is enabled within FireHydrant.
-
As a FireHydrant owner role, generate a bot token from FireHydrant for the Zendesk app.
- You will need to be a Zendesk administrator to add the app.
Installation
From the Zendesk Marketplace, find the FireHydrant app. Click Install.
This will take you to the Zendesk Admin Center. Provide the following information to configure the FireHydrant app:
- Title of the FireHydrant environment
- Bot token from FireHydrant
- Zendesk role restrictions (optional)
- Zendesk group restrictions (optional)
Click Install.
Removing the FireHydrant Zendesk Marketplace App
From the Zendesk Admin Center, find the FireHydrant app. Hover over the bottom right of app icon until you see the configuration icon appear. From the configuration menu, select Uninstall.
Using the Zendesk Integration During Incident Response
Now you're ready to start using using the integration. Learn more about creating FireHydrant incidents from Zendesk and associating Zendesk support tickets to FireHydrant incidents in our responder documentation.
