Category Archives: Zingtree News

Cloudflare Causing Service Interruption

In case you or your team had trouble using Zingtree today, the cause was due to our caching provider (Cloudflare). We use Cloudflare to ensure better performance and reliability on zingtree.com (as do a lot of other popular sites), but in this case it made things worse.

Here’s Cloudflare’s summary of the problem:

Identified – Starting at 00:00 UTC on January 1, 2017, CNAME resolutions on some machines stopped working due to a bug triggered by the universal addition of one leap second, which affected both some authoritative DNS and origin DNS lookups, causing 5xx errors. Authoritative DNS was less affected since resolvers were served SERVFAIL and possibly retried until they hit a healthy instance. We deployed a fix at 01:30 UTC and it is rolling out to most affected sites. We will update this once the deployment is finished.

Details here.

Zendesk Agent Scripting App – Version 9

1428079854_thumb

Our Contact Center customers using Zendesk are becoming more sophisticated, so we’re continuing to improve our Zendesk Agent Scripting app in response. This version 9 update automatically chooses scripts based upon one of the following:

  • The Zendesk brand field
  • Zendesk ticket tags
  • The value of a custom field

If you’re just using one script for everyone, this is supported as well.

Here’s how the app appears in the right hand sidebar in Zendesk:

Zingtree Setup

Script matching works by matching tree tags you set in Zingtree to values in the Brand, Tags, or a custom field in a Zendesk ticket. For example, if a tree is tagged with “astrology”, and the ticket tags include “astrology”, then that tree appears. If several trees match, then they will all appear.

First, add tags to a tree in Zingtree as follows:

  1. Select a tree from My Trees.
  2. Go to the Settings tool.
  3. Enter or select a tag from the tags field.

Zendesk Setup

You’ll need to download and configure the Zendesk Agent Scripting App version 9:

  1. Download the Agent Scripting app.
  2. In Zendesk, click the Admin icon and go to Apps > Manage.

  3. Click Upload Private App.

  4. The Upload App page appears.

  5. Enter “Zingtree Agent Scripting” for the App Name.
  6. For App File, locate the file zingtree-agent-scripting-v9.zip you downloaded in step 1.
  7. Click Upload, then confirm if necessary.

Configuring the App

Once you’ve uploaded the app, the configuration screen appears:

Here’s what each item does:

Title: A title for the app, as it displays in Zendesk.

Tree ID: If you’re installing just one script for everyone, enter the ID of your tree here.  If you will be offering multiple scripts to your agents, leave this blank.

Height (pixels): The height of the app as it appears in the Zendesk ticket sidebar.

Display in Panels Style: Tick this option to use the Panels style to display your scripts.  Untick to use Buttons style.

Open Script based upon Brand: If this option is checked, the subdomain of the selected brand will be matched to a tree tag.  Any matching tree or trees will appear.  For example, if the brand subdomain is xyz.zendesk.com, any trees tagged as xyz will appear. (Requires the Zingtree API key in this configuration.)

Open Script based upon Tags: If checked, the values in the Zendesk ticket tags will be matched with your tree tags to show one or more matching scripts. (Requires the Zingtree API key in this configuration.)

Open Script based upon Custom field: If you want to use a custom field value to show matching scripts, enter the field ID here. The Field ID can be found in Zendesk under Admin, Manage, Ticket Fields. Click Edit to see the field ID. (Requires the Zingtree API key in this configuration.)

Zingtree API key: Each organization in Zingtree has an API key, which is used to match scripts. If you’re using one of the tag matching options, this is required. Your API key can be found at zingtree.com under Help > API.

Try It with Example Data

You can use trees from the Zingtree Gallery to see how the Agent Scripting app works.

For a single tree, enter ’14’ as the Tree ID. This will show an Astrology web site troubleshooter example.

For multiple trees, see how a tree can be selected by tag by doing the following:

  1. Enter 6a103737e44e4aa6e1e4b6b0bcb46f83 as the API key.
  2. Make sure Open Script based upon Tags is checked.
  3. Try entering one or more of these tags into a ticket: “zingtree”, “astrology”, “pet_rock”.

Any questions? We’re always here to help

Zapier Decision Tree Integrations with Zingtree

zingtree-blogpost-zapier

Our Zapier app makes it easy to send data collected during each Zingtree session to more than 500+ applications supported by Zapier. In case you haven’t heard of it, Zapier is a tool that simplifies data exchange between various web applications. We’re big fans.

Here are some cool things you can do with Zingtree and Zapier:

  • Send data collected in a Zingtree session to Salesforce, Zoho, Highrise, or any other CRM.
  • Add an email address entered in a tree into Mailchimp.
  • Send  yourself an email or SMS message when a customer reaches a critical node in a tree.
  • Save new customer information in a Google Sheets row.
  • Create Trello cards from trees, and include customer notes and session data.
  • And tons more!

When using Zapier, you create “Zaps.” A Zap has a “trigger,” which is the source of the data, and an “action,” which is where the data gets sent. Most of our customers want to send data from Zingtree to another app, so we’ll demonstrate how this is done here.

Before starting, you may want to examine a demo tree from our Gallery that gathers data and sends it to Zapier, or copy it to your account.

How to Set up Zapier for Zingtree

The Zingtree Zapier app is currently invite-only. But if you’re reading this article, you’re invited!

  1. Create a free Zapier account at Zapier.com.
  2. Go here to accept an invitation to use the Zingtree app. The invitation appears:
    Accept the invite.
  3. You’ll be prompted to make a new Zap:
    Click Make a new Zap.
  4. You’ll be asked to choose a Trigger App, which is the source of the data exchange.
    Search for Zingtree, and select Zingtree (Beta).
  5. You’ll be asked to choose a single trigger.
    Click Save + Continue.
  6. Next, you’ll need to connect your Zingtree account, and a tree to Zapier.
    Click Connect a New Account.

     

  7. You’ll be asked for your Zingtree API Key, which you can find here at the bottom of this page. Also enter the Tree ID that will be sending data to Zapier.
    Click Continue when finished.
  8. Change the name of the account, then click Test.

    You should see “success.” Click Save + Continue.
  9. Next, Zapier will attempt to retrieve any variables or sample data from your tree. If this is a new tree, you may want to run through it once and gather some data.
    Click Fetch & Continue.
  10. You’ll see some of the stock data that Zingtree always provides, as well as any custom data for your tree. Again, if you don’t see all the data you expect, do a test run through your tree, and enter some data at least once. This will make the rest of the process easier.
    Click Continue.

Set up the Action App – Email Example

So now you’re done with the Zingtree part. Congratulations! Next, you need to set up an Action App, which will receive data from Zingtree. Let’s set up email delivery as an action, as follows:

  1. Search for email, and choose Email by Zapier as an action app.
    Select Email by Zapier.
  2. This app has just one action.
    Click Save + Continue.
  3. Fill in details for the outbound email. You can insert fields from Zingtree in the body of the email as well.Click Continue when the email is set up correctly.
  4. You’ll see  a preview of what to expect.
    Click Create & Continue to save the action and send a test email.
  5. You should see another “success” screen.
    Click Finish when the email appears as you like.
  6. Name your Zap Zingtree to Email, and turn it on!

Your Zapier Zap is all set.

Making Zingtree Send Data

The final step is to tell Zingtree when to send all the data collected in a session to Zapier. This can be triggered from one or more nodes, when they are seen by the end-user of your tree.

  1. From Overview, Edit Node, edit the node that you want to trigger sending data to Zapier.
  2. Go to Send Message to, and pick Zapier: Zingtree to Email. This is the new Zap you created.
  3. Click Save.
  4. Now try a test from Zingtree. Using Preview or the Publish tool, navigate your tree, and when you reach the node that triggers the send, you should see something in your inbox. IMPORTANT: Make sure to use https in your published Zingtree URL when using Zapier.

Once you get your first Zap done, it becomes easy and addictive to hook Zingtree to the other applications that your business depends upon. So keep going!

Have any questions? Contact us anytime!

Fresh Tree Updates: Document Nodes and More

This latest Zingtree update includes the new Document Node type, and a smattering of small improvements:

  • New: Edit Tree Node can now open selected tree in a new tab for editing (Paul G, Sebastian V.).
  • New: email-session-info.php has new parameters for subject, body, from, secure_data_link. You can also include multiple emails separated by commas.  Details here. (Alok)
  • New: Link nodes can now accept variables (both Data Entry Fields and Merge Variables).
  • Update: Added “Add Node” option to main tree tools page.
  • Fix: Duplicating Scoring nodes now also copies scoring branch rules.
  • Fix: Root node no longer ever appears as an Answer node, even if there are no choices yet.
  • Fix: Copy Node now works properly again from Overview (Chrissie, Admin).
  • Update: Edit Node can now set the Start node.
  • Fix: Multi-line text fields now input form data from previous form fills.
  • Fix: Edit Node preview now renders blank questions properly.
  • Fix: One across button layouts are now shorter, centered (Deb & Tif).
  • Fix: unchecking “Use Scoring” when editing buttons in Edit Node no longer keeps scoring variable.
  • Update: Now shows scoring variables for data entry fields in simple overview summary, Edit Node data entry fields summary.
  • Fix: Long feedback comments display better.
  • Update: Can now read and delete comments on Scoring nodes (Chrissie).
  • Fix: Instant preview in edit-node-content after deleting a data entry field no longer shows a blank for that field.
  • Fix: Simple overview buttons don’t wrap on smaller screen sizes.
  • Fix: Added extra capacity for servers, fixed server scaling issue.

We love feedback. Send us your ideas!

Make Tests, Quizzes, Assessments & More with Zingtree’s Scoring System

adding-search-to-decision-trees-6

Zingtree has the ability to create what we call evaluations. These can be interactive tests, quizzes, assessments, training simulations, or anything else that requires assigning a score to each question answered – then later acting upon the total score. Coupled with the powerful decision tree logic already present in Zingtree, this capability opens up a whole new realm of knowledge engineering possibilities.

To see a working example of an interactive decision tree quiz, try this 10-question Personality Test found in the Zingtree Gallery.

Here are the basics on how to build a tree with scoring:

  • Add a score value to each button click when designing your tree.
  • As the end-user goes through your tree, Zingtree keeps a running total of the score values of all buttons clicked.
  • When you’re ready to act upon the running total score, use a new “Score Branch Node”. From there, you can specify a range of score values which redirect to specific nodes.

Want to build your own? Here’s a step-by-step guide:

Step 1: First, go to Overview > Edit Node and open up the button editor by clicking Edit Buttons. Select Use Scoring, and enter a Score Variable Name that will be used to tally scores and branch on later.

581d3092c6fe48-46396098-359664

Step 2: Next, add your desired score values to button clicks in your lead qualification decision tree.

button-scoring

Step 3: Now, add a new Score Branch Node using This Tree > Add Node. In the Score Branch Node, you can specify which node should appear next (and which to branch to) according to a range of scores.

score-branch-node

Step 4: Link the last button click of your test/quiz/assessment to this new Score Branch Node.

Note that the Score Branch Node never appears on screen. When you direct the flow of your Zingtree to this node, it looks at the sum total of all the button click scores, and redirects to the proper node.

Need to See More Examples? The Zingtree Gallery has three trees that use the new Scoring capabilities. You can play or examine them to see how they work.  See the Evaluations examples.

Bonus Tip! 
Want to display the score on a node? Just add the text #score# into the content area.

Other Notes:

  • You should make sure you are using the latest embed code or hosting URL for your tree.
  • If your end-user presses the back button, the running total score will adjust.
  • If the tree is restarted, the running total score resets to zero.

Any questions? Please reach out to us at any time

Update: New Decision Tree Designer and Data Entry Fields Management

NL-header-updates3

This latest Zingtree update is more comprehensive than most, primarily because we took some time to focus on our core decision tree building features and make them even better. You’ll see big improvements in Visual Designer, as well as managing Data Entry fields and editing nodes.

Visual Designer

The big change is that we’ve moved to a more powerful pop-up editor within Designer, and eliminated editing from the right panel. You now have a larger drawing area, and can do almost all of your work directly in Designer without having to go to Overview.

Designer also has “isolated” view – just click on a node, and you’ll see just the nodes and buttons connected to it. Additionally, you can print and export your tree drawings to PNG image files. And, Designer now loads 2x to 3x faster!

Important: To edit a node in Designer, you’ll need to double-click or right-click.

Here’s what some of the new changes look like:

Larger Drawing Area

larger drawing areaPop-Up Editor

Isolated View

Click on any node or button/arrow to highlight connections.

Other Designer updates:

  • Designer boxes resize to fit longer content when loading tree.
  • Designer with two buttons going to same place now has larger separation of arrow connectors.
  • Fix: Apostrophes in titles or questions now display properly.

Data Entry Fields

Also new is an improved way to manage data entry fields. Rather than inserting code into the content area, you can now manage data entry fields separately, which makes it easier for non-programmers to edit, add and change data fields.

Within the node editor (from Overview or Designer), you can add any number of data entry fields from a simple, easy-to-use form.

Complete instructions on how to use Data Entry Fields is in the Zingtree FAQ here.

Other Enhancements

Several other improvements and fixes are in this update, including:

  • Update: Tree node search now includes tags in search (h/t Trey H.)
  • Update: Simplified Edit Node.
  • Update: “Hide from Agent Portal” no longer defaulted when creating a new tree. Also gives hint to check this if no trees found in Agent portal.
  • Update: Copy Node on node editors, no more “Save and Create Duplicate”
  • New: Can now edit two trees at the same time through Designer, or keep two tabs open for different trees.
  • Fix: Edit Tree Node now shows links to all trees in your organization.
  • Fix: Traffic Map report now shows tree node links. (h/t Ben C.)
  • Fix: email-session-info.php will now substitute #source# or #agent# in the link (link node fix) (h/t Craig)
  • Update: Simple overview only shows scoring variable if scoring is being used.
  • Update: Preview now substitutes #agent_name# for author name. (h/t Marlin)
  • Update: Email nodes now insert body of message into “Notes” form field, which can be viewed and exported from the Form Data report (for Holly B.)
  • Fix: Search results linking to a tree node no longer fail (Chrissie)
  • New: Can delete multiple nodes easily from Simple Overview (for Ben C.)
  • Fix: Last Opened in My Trees page is adjusted for the user’s time zone (h/t Elijah H.)
  • New: Button Clicks report has a View All option to see all nodes on one page (h/t Mike H.)
  • Fix: apostrophe’s in page title no longer messes up #taglist# link tracking (Chrissie)

Thanks again to everyone who suggested updates! I’m sure we may have forgotten a few of you.

As always, if you have a suggestion to make Zingtree work better for you, please share.

Live Chat Integration: Intercom and Zingtree

z-integrations-blog

Live chat is an incredibly useful way to connect to our customers, both for offering support and for getting insights into new product ideas we may never have thought of ourselves. We are happily using Intercom, which allows us to track chat and email conversations with each customer.

For technical inquiries, we use Zingtree Data Entry forms to get the tree ID, node and URL of any problem reports. To save our customers some typing, and make it faster for us to answer questions, we’ve built our own Contact page using Zingtree. For technical and sales inquiries, the decision tree leads to an end point that opens Intercom chat, with information about the problem already pre-populated.

Once you submit a technical question, here’s what appears in Intercom:

Intercom chat with Zingtree

Demos:

Requirements:

  • Your tree must be embedded on your site.
  • You need to have the Intercom chat client in place on the page that contains your tree.

How to open an Intercom chat session, and include the Zingtree transcript and data entry:

  1. Go to Overview.
  2. Edit the node you want to trigger the chat, and  set the Parent Action to Intercom: New: #session#.When a customer lands on this node, this Parent Action is triggered.
  3. On the hosting page, include this script before the </body> tag:
    <script src="//zingtree.com/api/chat/intercom.js"></script>

It’s that easy!

Source Code:

From the Zingtree Gallery, you can see two examples:

Form Fields: Decision Trees with Data Entry

blog-howto-2

One of the most requested features for Zingtree interactive decision trees is to have the ability to collect key customer information from users while they are navigating your tree. So, we made it happen!

With Zingtree’s data entry feature, you can do things like…

  • Add form fields to your trees (text, list boxes, check boxes, radio buttons, dates and numbers).
  • Include form data dynamically in other parts of the tree (i.e. you can ask for a name in the first node, and have that name appear in other parts of the tree).
  • Export form data into any other system, including Help Desk or CRM applications.

For example, your decision trees can gather data like this:

Example Tree

Try the Form Fields and Data Entry Demo tree from the gallery. This will ask you for some information, echo it in other parts of the tree, and finally inject it into a standard HTML form.

How to Include Data Entry Fields in your Tree

Here’s how to add a Data Entry field to a node:
  1. Edit a question node from Overview or Designer.
  2. Click Add next to Data Entry Fields.

  3. A new Data Entry field dialog appears.  Select the type of data you want to collect, and enter a variable name and a label which the end-user will see.

  4. Select Required to make this field require an entry before proceeding.
  5. For radio buttons and list boxes, you can enter the option choices as well. If you are using scoring nodes, you can enter a score variable, and a score to assign to each choice.

  6. Click Add Field when finished.

 

Inserting Form Field Data into Other Parts of the Tree

Once the end-user adds data to a form field and then clicks a button, this data can appear anywhere in the tree’s content, question or title areas. The trick is to use the variable name, surrounded by # characters. For example, after adding a text input field named name,  insert text like this into a node to show the value of name:

Hello #name#! Welcome back.

The #name# part will be replaced with whatever was entered previously into the name field.

Injecting Zingtree Form Data into Other Systems

Once your form fields are set up and your tree is running, the entered data can be injected into any other form.  Here’s how to do it:

  1. Make sure the variable names in your Zingtree form match the variable names on the form you want to inject data into.
  2. When opening the URL for the destination form, make sure to include &session_id=#session# in the link URL.
  3. In the destination form, include this piece of code:
    <script id="zingtree_field_id" value="session_data" src="//zingtree.com/api/zingtree.js">
    </script>

When the destination form is opened, it will include the data from the Zingtree session in the fields that match.

The Form Fields and Data Entry gallery tree shows a full example. Click all the way through, and you’ll see an HTML page with Zingtree forms data present.

Misc Notes

  • The form fields button in the editor is not available in Designer. You’ll need to use Overview, Edit Node to access it.
  • Tech note: If you’re hand-coding the HTML for your forms, each form element must have a class of zt-data to be recognized and saved.

Any questions? Reach out to us at any time.

Updates: New Button Click Traffic Report, Designer Enhancements and More

updates-blog-image

This latest Zingtree update is once again powered by our clever customers. We just take the ball and run with it.

Here’s what’s new this week:

New Traffic (Button Clicks) Report

For each node, you can see how often each button is clicked for any date range.  Also, you can walk through your tree and see clicks for the next node. Thanks to Elise M. and Matthew S. for the suggestion.

Designer Updates

We’ve made the color palette better, and the root node is now a unique dark shade of green.  Thanks to Corey D. for the inspiration.

Also New and Notable

  • Fix: Mobile output looks better due to a meta tag scaling fix
  • Update: Reports list ordered by popularity
  • Fix: Super user status not always recognized in My Trees (h/t Trey H.)
  • Update: Added content-question and content-answer classes to tree output for more CSS control over question and content areas. (h/t Kolja W.)
  • Fix: Breadcrumbs links went back one step too far. Fixed. (Cris M.)
  • Update: Session Notes now turn red if there’s a previous note, shows previous note. Also appears in Session List, Session Data reports. (h/t Florent N.).
  • Update: Added API for Session Notes extraction
  • New: Settings now has a Language option to ensure Back button and Email Node fields are localized properly (h/t Mike H.)

Got a great idea? Send it to us, and watch it magically appear in the next update!

Updates: HTTPS Security, Email Attachments and Better Forms

updates-blog2

Usually we have a common theme around our weekly updates, but this week it’s a smattering of great suggestions from our customers.

Enhanced HTTPS Security

Dave T. pointed out that his company restricts any information being sent insecurely, especially the content of their decision trees. To address this, we ensured that every page on zingtree.com is redirected to https protocol; now all of your information is encrypted end-to-end from your browser to our servers.

Email Nodes with Attachments

Eve B. is building an application whereby their field reps use Zingtree decision trees to go through a returns process. At the end of the process, they wanted to generate an email with a photograph of the damaged item. With the new Attachments capability, any email node can include a file delivered with the email, including documents, images, or anything else.

Better Forms

Tom K. made a suggestion to simplify how the Zingtree content editor creates radio button and list box forms.  Now, there’s rarely a need to modify the underlying HTML when creating these form fields – we ask for the result values up-front, and the form is generated right away. Thanks Tom!


Want to experience the thrill of being a product designer without having to program anything? Send us an idea or a suggestion to make Zingtree even better!