Zendesk Integration

What does Opsgenie offer Zendesk users?

Opsgenie provides a powerful bidirectional integration with Zendesk. When a new ticket is created in Zendesk, a corresponding Opsgenie alert/incident is automatically created, containing rich information about the ticket. Opsgenie provides rich notifications with on-call rotation, scheduling etc. features and alert escalations to ensure the best ticket management for Zendesk customers. As users execute actions on the alerts/incidents, like acknowledge, comment, or close– the ticket on Zendesk is also automatically updated with comments about these alert actions.

Functionality of the integration

Opsgenie provides 4 different flows for the Zendesk integration:

1. Creating alerts in Opsgenie for the Zendesk tickets
2. Creating tickets in Zendesk for the Opsgenie alerts
3. Creating incidents in Opsgenie for the Zendesk tickets
4. Creating tickets in Zendesk for the Opsgenie incidents

📘

For Incidents to be created

Please make sure a Service has already been defined. Add link to the Service and Incident docs here.

Creating alerts/incidents in Opsgenie for the Zendesk tickets:

• When a ticket is created in Zendesk, an alert/incident is created in Opsgenie.
• If Zendesk to Opsgenie updates are enabled, actions for Zendesk tickets are executed in Opsgenie when the chosen action is executed in Zendesk for alerts/incidents which are created by the Zendesk integration.
• If Opsgenie to Zendesk updates are enabled, actions for Zendesk tickets are executed in Zendesk when the chosen action is executed in Opsgenie for alerts/incidents which are created by the Zendesk integration.

Creating tickets in Zendesk for the Opsgenie alerts/incidents:

📘

API Token should also be entered into the Opsgenie configuration for the action mappings to work. For more information, refer to Zendesk support.

• When an alert/incident is created in Opsgenie, a ticket is created in Zendesk.
• If Zendesk to Opsgenie updates are enabled, actions are executed in Opsgenie when the chosen action is executed in Zendesk for alerts/incidents which have a source other than the Zendesk integration.
• If Opsgenie to Zendesk updates are enabled, actions are executed in Zendesk when the chosen action is executed in Opsgenie for alerts/incidents which have a source other than the Zendesk integration.

Add Zendesk Integration in Opsgenie

1. Please create an Opsgenie account if you haven't done so already.
2. From the Integrations page in Opsgenie, search and click on the Zendesk Integration which redirects you to a flow selection window.
3. Select one of the four integration flows to use.
4. Specify who is notified of Zendesk alerts using the Teams field. Auto-complete suggestions are provided as you type.

📘

An alternative for Step 2) and Step 4) is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

5. Copy the integration API KEY.
6. Click Save Integration (If Opsgenie is not creating tickets in zendesk, make sure UPDATE Opsgenie -> Zendesk toggle button is unchecked. If Opsgenie should create tickets, add in Zendesk API Key https://support.zendesk.com/hc/en-us/articles/226022787-Generating-a-new-API-token-)

Configuration in Zendesk

1. In Zendesk, go to the "Admin" page.
2. Select Extensions under "Settings".
3. Click add target.
4. Select URL target from the opened list.
5. Enter the following URL according to the domain that you use

• US domain: https://api.opsgenie.com/v2/json/integrations/zendeskv2?apiKey= previously into "URL".
• EU domain: https://api.eu.opsgenie.com/v2/json/integrations/zendeskv2?apiKey= previously into "URL".
  Select POST as "Method". Enter "ticket" into the "Attribute Name" field.

6. Select "Create target" and click Submit.
7. Now from the admin panel, select Triggers under "Business Rules".
8. Create the triggers following this instructions file.

Configure alert properties from the Zendesk Integration / Advanced Settings page.

​All set! Now manage your Zendesk alerts at Opsgenie and leverage its full alerting functionality.

Action Mapping Feature

Opsgenie allows customers to define action mappings between Opsgenie actions and Zendesk actions.

For Zendesk to Opsgenie updates:
Zendesk to Opsgenie action mappings are available for all of the integration flows. Use this action mapping to map different Zendesk actions to different Opsgenie actions. For example, add a note to Opsgenie alert/incident, when a public reply is added to the ticket in Zendesk. In order to do this, define "If a public reply is added to the ticket in Zendesk, a note is added to the alert in Opsgenie". mapping in "Zendesk -> Opsgenie" Update Section.

For Opsgenie to Zendesk updates:
Opsgenie to Zendesk action mappings are available for all of the integration flows. Use this action mapping to map different Opsgenie actions to different Zendesk actions. For example, add an internal note to the Zendesk ticket, when the related incident is resolved in Opsgenie. In order to do this, define "If incident is resolved in Opsgenie, an internal note is added to the ticket in Zendesk". mapping in "Opsgenie -> Zendesk" Update Section.

• "A tag is added to the alert and a custom action is executed on alert" actions differ from other actions. When one of these actions is selected, an extra field appears to enter for which tags or for which custom action this mapping works.
• Enter multiple tags by separating the tags with a comma. If multiple tags are entered, the mapping works if the alert has one or more of the specified tags. Leave the tags field empty, for the mapping to work for any tag.
• If an Opsgenie action is mapped to multiple Zendesk actions, an error occurs except for the "a tag is added to the alert" and "a custom action is executed on alert" actions. Save multiple mappings for these actions, because they differ by the given tags and the given custom action names.

📘

API Token should also be entered into the Opsgenie configuration for the action mappings to work. For more information, refer to Zendesk support.

Troubleshooting

If Zendesk alerts are not getting created in Opsgenie, make sure that Zendesk is able to reach to Opsgenie endpoint using Test target option from the target created under Settings->Extensions.

• If no test alert appears in your Opsgenie account after clicking Test target option, this means the target was not successfully added. Please go back to add target section of the document and check the steps.
• If the test alert is created in Opsgenie, then the test target configuration is correct. First please check the "Logs" page to see if Opsgenie received the integration and if an error has occurred. If no request or error is shown in the "Logs". Please check if the Zendesk trigger is used when a ticket is created/updated. Find this info from Business Rules->Triggers page. If their usage is 0 that means the trigger rule is not used, so there must be something wrong with its configuration.