Updated March 12, 2020: Added support for targeting a specific Zendesk Ticket Form.
Do you use Zendesk to manage technical support?
If so, you can use Zingtree decision trees to reduce your technical support team’s workload. Customers can either self-solve their issue, or a new ticket can be created automatically in Zendesk that includes all the information from the customer’s decision tree troubleshooting session. By making it easy to gather background information from the customer via the decision tree, your support team saves a lot of time by reducing back-and-forth messages.
Zingtree provides a free app for Zendesk to make it easy for your support agents to see the decision tree transcript. It looks like this inside of Zendesk:
It’s easy to set this up – here’s an overview of the process:
- Add a new Application to Zingtree for creating Zendesk Tickets.
- Create a “Ticket Submitted” node which sends the new ticket info to Zendesk.
- Create a “New Ticket” node to obtain the customer’s name, email, a ticket subject, a description, and optional custom fields.
- Make sure Zendesk is properly configured to allow external apps to create requests.
- Optionally install the Zingtree app into Zendesk via the Zendesk App Marketplace.
Adding a new Application to Zingtree to create a Zendesk Ticket.
A Zingtree application can be called from any node. You’ll need to add the Zendesk New Ticket App first as follows:
- Log into your Zingtree account.
- Go to Account > My Apps.
- Select the Zendesk: New Ticket App.
- Enter your Zendesk account email, API token and domain name. (Instructions are on the page.) If you are using multiple Ticket Forms, you can also add an optional Form ID.
- Click Add Zendesk App to save the new App.
Note: You can create an API Token in Zendesk via Admin > Channels > API.
Create a “Ticket Submitted” Node
When this node appears, a new ticket is added to Zendesk. This is the end result of pressing a “Submit Ticket” button inside the decision tree. You can create this node as follows:
- Go to Tools > Add Node.
- Add a new Content Node.
- Give the node a title, and any text you want to appear in the content area – like “Thanks for submitting a ticket” etc.
- Click the Apps/Webhooks tab.
- Click Add App/Webhook.
- Select the Zendesk App you just created. You should see something like this:
- Click Save Changes to save this node.
Tip: The session transcript is added by default to the ticket description unless a Zingtree Session ID field is present. To disable transcripts, add notranscript to the Message Data area.
Now we’re ready to link a ticket entry page to this “Ticket Submitted” node.
Create a “New Ticket” node
When end-users navigate the troubleshooting decision tree, if they haven’t been able to resolve the issue, you can direct them to a node which collects data for the ticket. These variables must be named exactly as specified below so that Zingtree knows which fields to include in the new Zendesk ticket.
These variables are mandatory:
- zd_subject – The subject of the request.
- zd_description – The description for the request.
- zd_requester_name – The customer’s full name.
- zd_requester_email – The email of the customer.
These variables are optional:
- zd_type – The type of the request. (Defaults to “question”) – Possible values: “problem”, “incident”, “question” or “task”
- zd_priority – The priority of the request. (Defaults to “normal”) – Possible values: “urgent”, “high”, “normal”, “low”.
You can also add custom fields to your ticket form (see below for details).
To create a new ticket form in your decision tree:
- Edit the node where you want the customer to submit the ticket.
- Click the Data Entry Fields tab.
- Add fields for zd_subject, zd_description, zd_requester_name and zd_requester_email at minimum.
- Add zt_priority or zt_type optionally.
- When you are done, your Data Entry Fields will look something like this:
- Click the Action Buttons tab, and add a “Submit” button to go to your submit ticket page.
- Save the changes to this node.
Bonus: When a ticket is created, the Zendesk ticket ID is returned as a variable named zt_ticket_id.
How to Include Custom Fields
Every field in your Zendesk Ticket from has a unique ID. So to include field #12345 in the ticket form, you would add a variable named like this: zd_custom_field_12345
You can locate the Field ID for your custom ticket fields in Zendesk as follows:
- In Zendesk, click Admin, Manage, Ticket Fields. The Ticket Fields screen appears:
- Copy the Field ID (outlined in red above).
Your Zendesk setup will need to allow anonymous requests. To enable this, the following Customer settings must be set in the Support admin interface:
- Enable “Anyone can submit tickets”
- Disable “Ask users to register”
You can do this via Admin > Settings > Customers. Your setup should look like this:
Add the Zingtree Support App to Zendesk (recommended)
To make a deluxe experience for your support techs, we recommend adding the Zingtree Support app to your Zendesk. In Zendesk, go to Admin > Apps > Marketplace, and search for “Zingtree”. Be sure to choose the Zingtree app:
Examine this tree from the Demo Gallery to see a real live setup.
If tickets aren’t being created, the Event Log is a great way to see if any errors are being returned from Zendesk.
- In Zingtree, go to Account > Event Log.
- Choose Zendesk New Ticket as the Event Type, and you’ll see all ticket creation attempts.
In the above example, you can see an error flagged with a red exclamation point in the left column.
That’s how easy it is to create Zendesk Tickets from Zingtree. Any questions, comments or suggestions for improvement? Talk to us!