Iterable can ingest Zendesk data through webhooks and send data back to Zendesk to enable the automation of user profile updates, event ingestion and messaging campaigns based on user actions taken and tickets filed.
NOTE
This integration requires an Iterable account and a Zendesk account.
If you’re not already an Iterable client, request a demo to discuss how the Iterable and Zendesk integration can work for you.
Instructions
For Data Zendesk -->Iterable
You must have Zendesk admin access to set up this integration. Reference this Zendesk support doc for further help setting up the webhook in Zendesk.
Create an API key in Iterable
-
Sign in to Iterable account at https://app.iterable.com/login/.
-
Navigate to Integrations > API Keys.
-
Click Create New API Key.
-
For the key type, select JavaScriptSDK.
-
Click Create.
-
Copy the API key from the Key column of the Existing API Keys table.
Create a webhook in Zendesk
NOTE
This example demonstrates how to create a Zendesk webhook that will post an event to Iterable's /events/track
endpoint. You can also use this method to update information on the user profile simply by mapping the webhook (or Notify Target, as Zendesk refers to it) to the /users/update
endpoint.
-
In Zendesk Support, click the Admin icon (
) in the left sidebar. Then, select Settings > Extensions.
-
Click the Targets tab and click Add Target.
-
Select HTTP Target. You will be taken to a page similar to this screenshot:
-
For the URL, enter the following:
https://api.iterable.com/api/events/track?apiKey=[YOUR_API_KEY]
-
For Method, choose POST.
-
For Content type, choose JSON.
-
Click Submit.
You will be taken to a page where you can test a call to Iterable’s endpoint with your proposed JSON body. Please note that you need to structure the JSON body in accordance with the Iterable endpoint the Zendesk Webhook is pointing at. Please refer to Iterable's API docs for examples.
-
In a new browser tab, open Business Rules > Triggers.
-
Click Create New Trigger and set up your logic.
It should look something like this:
-
In the Actions section, map the trigger to the webhook you just created.
-
For the first dropdown, select Notify Target.
-
For the second dropdown, select Title of the webhook defined in step 3.
-
-
Provide a JSON body.
-
Format the JSON payload as specified by Iterable's
/events/track
API. -
The JSON body should look similar to the screenshot above, and must contain an
email
andeventName
parameter. -
Add merge parameters (placeholders) directly in the JSON body as necessary. For a list of available placeholders, click on the View Available Placeholders link, which will bring up a list similar to the following:
-
Example JSON body:
{ "email": "{{current_user.email}}", "eventName": "New Zendesk Ticket Created", "dataFields": { "Ticket_Id": "{{ticket.id}}", "Ticket_Description": "{{ticket.description}}", "Ticket_Priority": "{{ticket.priority}}" } }
-
-
Copy the JSON body into the webhook configuration in the previous browser tab.
-
Click Submit.
-
If you don’t get an error code, login to your Iterable account and check the event under the test user’s email you used.
-
Once you’ve confirmed Iterable ingested the test event, confirm that the trigger is active.
Your automated webhook from Zendesk to Iterable is now set up and you can use events ingested from Zendesk to trigger messaging campaigns.
Please reference our For Data Iterable-->ZendeskWorkflow Webhook Documentation and Zendesk's API Documentation. Your Iterable CSM can help you to configure the Zendesk Workflow Webhooks as each setup is unique to your Zendesk data schema.
Here is an example of a configured Workflow Webhook --> Zendesk for creating a new user:
- Go the Workflow Webhook configuration screen
- Select create new Workflow Webhook.
- Set the Method to "Post."
- Authentication to "Basic."
- Add in the desired Zendesk API Endpoint. In the example below, we used: "https://d3v-iterable.zendesk.com/api/v2/users/create_or_update.json"
- Select "custom Json" and add in the Iterable data you would like to send to Zendesk, be sure to format it according to the Zendesk's scheme for each endpoint listed in their API docs.
- Hit Save. Below is a screenshot of how the Workflow Webhook should look once you're done configuring it.
- Create a new Workflow then add in a Workflow Webhook.
- Select "preconfigured Workflow Webhooks."
- Iterable will now trigger that workflow webhook as users pass through the workflow.
Comments
0 comments
Please sign in to leave a comment.