How to add Zingtree Session Data to a Zendesk ticket form:

  • Updated

You can use Zingtree with Zendesk's New Request Form to view your customer's Zingtree session history side-by-side with any ticket they submit. This requires using the Zingtree Zendesk app, and adding some code to your Zendesk New Request Form template.

Here's how to add Zingtree Session Data to a Zendesk ticket form:

  1. Log into your Zendesk account.
  2. From the top-right icon, choose Guide then Guide admin:
    mceclip0.png
  3. Click the view icon in the left sidebar:

    mceclip1.png
  4. Click Customize for your active theme:
    mceclip2.png
  5. Click the Edit Code button at the bottom-right of the page:
    mceclip3.png
  6. Under Templates, select new_request_page.hbs:

    mceclip4.png
  7. Add this code to the bottom of the HTML:

     src="https://zingtree.com/api/zendesk-new-ticket.js"


    Your edited data should look something like this:



  8. Click Publish.
  9. In Zingtree, when launching your form using a Link node, be sure to include #‌session# in the

    URL. Example:

    https://mydesk.zendesk.com/hc/en-us/requests/new?session_id=#‌session#

 

Next, install the Zingtree Zendesk App. If you're an Enterprise user, you'll want to do this from the main hub.

  1. Download the app here.
  2. Open your Admin panel in Zendesk, and click Manage under Apps.
  3. Click the Upload App button.
  4. Enter "Zingtree" as the app name.
  5. Click Choose File, and locate the ZIP file you downloaded previously.
  6. Click Upload.
  7. Click the Install button. (Leave the other defaults set.)

Now, when you're looking at Zendesk tickets, click the Apps button at the top right of the screen to show the Zingtree app. Try it!

Troubleshooting Tips

If no Zingtree data appears in the Zendesk ticket, make sure:

  • You are direct linking to the Zendesk form. If you access the support form from a drop-down, then the session data will not be passed along.
  • Make sure the Zingtree Session ID field is a part of your form. This is installed in the default form, but other custom forms may need this manually added. (Note that including the Zingtree Javascript will hide this field from view to your end-users.)

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request

Didn't find what you need?

Our friendly customer support team is here to help

Submit a Ticket

Looking for help or advice?

Reach out to our knowledgeable community of users.

Zingtree Community