Tag Archives: zingtree api

Updates: Reporting Enhancements, API Tweaks

updates-blog

Being able to see how much time and money you are saving with Zingtree makes us all feel good and useful. So this past week we’ve been working with some of our customers to make reporting cleaner.

Here’s what’s new with reporting:

  • Fix: All Tree Stats, Clicks and Usage and Popular Nodes now using same measurement techniques for engagement (Olivier).
  • Fix: Session Detail report now shows duration from first click (Jane A.).
  • Update: Added Agent Details to All Agents report.

Our APIs and integrations also needed a few tweaks to help solve some business problems for our customers. Here’s what’s new on the API side:

  • Fix: Zendesk session ID stuffer leaves existing session IDs in place in case of error submitting ticket form (Iggy).
  • Fix: Back button keeps data entry field values. (Chrispy).
  • Update for Zendesk tag matching (Jorge).
  • Update: /api/tree-tag-search.php now takes a minimum number of tags to match (Jorge).
  • Update: Zendesk API now returns a blank instead of “false” if no session IDs present (Bryan M.).
  • Fix: API for tree tag matching strips trailing commas from search string.
  • Update: Tree tag matching now returns results in alphabetical order.

Got any great ideas? Chat us up!

Integrating Zingtree with Freshdesk

feshdesk_zingtree

Freshdesk is one of our most popular integrations, so we’ve made sure it’s easy to import Zingtree session transcripts into a Freshdesk ticket. With the integration in place, support staff can see all of the steps a customer went through in a decision tree before needing to ask for help – it’s a huge time-saver for agents!

When the integration is set up, agents will see a Zingtree transcript with each ticket, like this:

Requirements:

You will need the Estate or Forest plan from Freshdesk to accomplish this integration.

Overview:

You’ll first need Freshdesk Admin privileges to complete the process. This method will create a new field called Zingtree Session Datait gets hidden from the customer, but it appears for the agent answering the ticket. It includes the entire Q&A transcript of the user’s Zingtree session prior to opening a new ticket in Freshdesk.

Here’s how to set up the Freshdesk side:

  1. In Freshdesk, go to your Admin panel, and select Ticket Fields.
  2. Create a new “Multi Line Text”  ticket field named Zingtree Session Data. (This field must be set up as “display to customer” and “customer can edit”, but will be hidden from the end-user once you implement step #7 below. Trust us!) The properties will look like this:
  3. Click Done.
  4. Click Save to add the field.
  5. Next go to Admin, Portals, and click  Customize Portal next to the portal that will receive Zingtree data.
  6. Go to Layout and Pages, Portal Pages.
  7. Click New Ticket, then add this code to the new ticket edit area:
    <script src="//zingtree.com/api/freshdesk-new-ticket.js"></script>

    This is what it looks like (new code outlined in red):

  8. Click Save and Publish.

On the Zingtree side:

You see to make Link Nodes that go to your Freshdesk New Ticket form, and add ?session_id=#session# to the end of the URL. Example:

If this is the link to your ticket form:
http://support.mycompany.com/support/tickets/new

Use this URL within a Zingtree Link Node to go to the ticket form, and have the Zingtree session transcript transferred:

http://support.mycompany.com/support/tickets/new?session_id=#session#

We’ve set up a sample Gallery tree (“Freshdesk Integration example”) for you to examine here. You can copy this tree, and then change the URL link to point to your own Freshdesk domain.

Follow these steps and in 15 minutes or less you’ll have a powerful integration between Freshdesk and your Zingtrees.

Any questions? Reach out to us anytime.

Integrating a Decision Tree Transcript into CRM (and Other Apps)

doodle_banners

Beyond troubleshooting and support, Zingtree makes a handy interactive front-end for getting people to the right page on your website. We consistently see our customers building trees for sales prospecting, medical appointments, loan qualification, hiring and other environments where a little bit of automated filtering goes a long way. Plus, Zingtrees are a great means for information gathering, too!

We also get requests for integrating Zingtree within various back-end platforms – most notably, CRM. Often, when a customer’s data gets imported into another system, you’ll want the Q&A transcript of their Zingtree session attached.

We’ve created a Simple Sales Funnel demo tree and a basic back-end script in the Zingtree Gallery so you can see a working example.

Here’s how to pass a Zingtree Q&A transcript along to ANY system:

1. From your tree, create a link node to your contact form (i.e. contact_form.php), with a URL like this:

contact_form.php?session_id=#session#

2. In contact_form.php, add this JavaScript right above the ending </body> tag:

<script
id="zingtree_field_id"
value="session_data"
src="//zingtree.com/api/add-session-data-to-form.js">
</script>

3. In the form itself, add a hidden field with an id of “session_data”. The name can be whatever you like. Example:

<input id="session_data" name="zingtree_stuff" type="hidden" value="" />

That’s it!

Under the hood: When the form is loaded, the add-session-data-to-form.js script reads the session_id parameter, then loads the session transcript into the hidden field with the id=”session_data”.


BONUS:

Rather than having a field that must have an id of “session_data”, you can also specify the ID of the field that you want to insert Zingtree data into. This is especially helpful for Salesforce or other CRM apps that generate forms for you.

For example, if you added a multi-line text field to your CRM system form with an ID of “my_data_field”, you could use this piece of code instead:

<script
id="zingtree_field_id"
value="my_data_field"
src="//zingtree.com/api/add-session-data-to-form.js">
</script>