How to configure Zendesk for integration with Service-Flow
This document shows an example of what needs to be done in Zendesk to make it integration-ready with Service-Flow (S-F). Note also, that the amount of fields used in integrations might vary. The document also describes what S-F needs to be able to send messages to the Zendesk instance.
Note that to be able to use any integration features in Zendesk, you need to have at least Support Team subscription level. Essential subscription plan does not include the needed features.
For any questions related setting up the integration, please send mail to email@example.com.
Sending messages from Service-Flow to Zendesk
S-F accesses Zendesk with using Zendesk REST API.
Create Integration user to ServiceNow
Add integration user to Zendesk. This user is used be able to create an update the entities that are integrated. These credentials need to be inserted to Service-Flow's end-point configuration.
Sending messages from Zendesk to Service-Flow
Zendesk accesses S-F with form-encoded HTTP requests. The needed parts are HTTP Target and a Trigger. The following chapter explains how to configure the needed functions to trigger calling the web services when inserting and/or updating incidents in Zendesk.
Create an ID attribute to incident table
You need to have an attribute to match updates coming from external vendors system. This field is typically called Correlation ID (correlation_id). You can use a field of you choice but in this guide correlation id is used.
Create HTTP target
Settings → Extensions → add target → HTTP target
Name: Service-Flow Integration Target
Content Type: JSON
Authentication: you will receive these credentials from Service-Flow UI's endpoint configuration
Create a trigger
Business rules → Triggers → Add trigger
Trigger name: Service-Flow Integration
Add at least the following condition:
- Ticket update via - is not - Web service (API)
Perform these actions:
- Notifications: Notify target → Service-Flow Integration Target