Category Archives: Product Updates

Yonyx Alternative – Better Guided Customer Interactions with Zingtree

We often get requests from companies that have deployed decision trees in the past with Yonyx and are looking to migrate to Zingtree. These occur for some of the following reasons:

  • Zingtree offers a better price with our pay-for-what-you-use model.
  • Zingtree tools are more modern, and easier to use.
  • Zingtrees present better. Customers have more options to create the look and feel they envision, choose custom colors and button styles, use effects and transitions, and better match their branding.
  • Customers like Zingtree’s integrations capabilities more – specifically the Webhook system and Zapier integration.
  • And more…

In response, we’ve created an import tool to make it easy to migrate your Yonyx trees to Zingtree. You can test out your Yonyx trees in Zingtree, tweak them, and see for yourself how they render and perform.

Here’s how to import Yonyx decision trees into the Zingtree alternative:

  1. Export your Yonyx tree into XML.
  2. In Zingtree go to My Trees, and click Import.
  3. Pick Import from Yonyx XML file.
  4. Select the Yonyx XML file to import. It will be uploaded and converted into a fully functional Zingtree decision tree.

Are you looking to move from Yonyx? Tell us your story!

Upload File Attachments into Decision Tree Sessions

Many customers have asked for a way to include file uploads as a part of a Zingtree decision tree session. Some use cases include:

  • Attaching a screenshot.
  • Including a photo.
  • Uploading a document.

Overview

Using Data Entry Fields, you can pick the File Upload field type. This allows you to include one or more files in the session data gathered by Zingtree. When the end-user uploads a file, here’s what happens:

  1. The file is copied from the end-user’s computer to a Zingtree file storage server.
  2. Zingtree assigns a variable to the URL where the new file resides.

Security note: Each file uploaded has a random 7 digit prefix or session ID attached to it, so that files with the same name aren’t overwritten, and the file names cannot easily be discovered by hackers.

How It Works

When the end-user reaches a node with a file upload, they will see something like this:

Clicking Upload Document File allows them to choose a file on their computer. Once a file is chosen, the button changes:

How to Set up File Uploads

When editing a node, do the following:

  1. Go to Data Entry Fields, and select Add:

  2. Choose File Upload as the field type, and enter a variable name and label for the upload button:

  3. Click Add Field.
  4. Now click Save Changes to save changes in the node you were editing.

It’s that simple! This gallery example shows how a simple file upload tree is built.

If this is useful for you, let us know. We love customer stories!

Zingtree Enterprise: Self-Hosted Decision Trees

enterprise-BLOG

While we are highly focused on our own security and data integrity, we recognize that using a SaaS (Software as a Service) site like Zingtree may require approval from various departments. For many, the hosting of company data offsite immediately triggers a cautionary reaction.

To address these concerns, we have a completely self-hosted Zingtree version. It utilizes the same awesome tools found in Zingtree but packaged in a way that can be installed on any server with industry standard PHP and MySQL. A full source code license is included, as well as regular updates.

This self-hosted option has a lot of benefits:

  • Customer data remains on-site.
  • Data is not intermixed with other company’s data (in case of legal subpoena issues).
  • Full source code allows security specialists to inspect the code for any possible hacking loopholes.
  • The design and engineering teams can modify the code or design of Zingtree to their liking.
  • You can guarantee your own uptime.
  • Plus, we provide consulting, support and maintenance as requested.

Want to learn more about the self-hosted Zingtree Enterprise solution?

Please contact us with licensing questions, or to get started with your self-hosted Zingtree Enterprise solution.

This article was originally published on September 28, 2015, but the information is still just as relevant! 

Tree Nodes: How to Automatically Return to a Previous Decision Tree

Tree Nodes are one of Zingtree’s most popular decision tree building features. By allowing one tree to launch another, you can better organize your work and use smaller components repeatedly as a part of larger processes.

For example, a hardware company that makes lots of products may have a specific troubleshooting process for power-on problems that are common to many trees. By linking to a subtree, this troubleshooter can be authored just once, and used from several different trees.

A common request when implementing tree nodes is to be able to automatically return to the original decision tree that launched the process – just like a return statement in any programming language. This is done using a special type of tree node that is labeled as “return to previous tree.”

Summary: Setting Up a Return to a Previous Tree

Setting up a return tree node requires these steps:

  • Create a tree node in the starting tree, and specify a node number to return to.
  • In the subtree, use a tree node selected as return to previous tree. When this node is reached, the return node in the calling tree appears next.

Setup: Step by Step

  1. Create your starting tree and the subtree that will be launched from the starting tree.
  2. In the starting tree, create a tree node. Include the tree to launch, as well as a node in the starting tree that you want to return to when the subtree is finished (highlighted in red below). It looks like this when editing a tree node:

  3. In the subtree, create a new tree node and specify it as “return to previous tree.” Like this:

When the “return to previous tree” node is reached in the subtree, the return node from the starting tree will appear.

Example

The Zingtree Gallery has an example, both the starting tree and the subtree.

Thanks for Shawn G. and others for the inspiration!

Summer Updates: Pop-Up Overlays, Predefined Webhooks and More

We’ve been busy this summer – so much so that we haven’t had a chance to share all the great updates we’ve done in the last couple of months! So here’s a list of all the latest improvements to Zingtree:

  • New: Popup overlay option
  • Fix: Webhooks now run when added to root node
  • New: Pre-defined webhooks (Session Summary, Timestamp, Send Custom Email)
  • Fix: Phone number field type can now be set as ‘required” (Boruch)
  • Fix: Preview now shows agent / end-user views properly (Boruch)
  • Update: Sessions List report now paginates at 500 per page (Roman)
  • New: Send secure session data link in email node also now includes a link to reopen the session (Boruch)
  • Fix: Zendesk app Q&A now shows all button clicks, even when going through subtrees (Phillip R.)
  • Fix: Session detail report now shows subtree jumps properly (Phillip R.)
  • Fix: PHP API call for tree_sessions now recognizes tree_sessions operation.
  • New: Repeating Forms
  • Fix: Designer now properly saves absolute button click values (i.e. =3)
  • Fix: Agent logins with trailing space characters now work in Agent Portal
  • Fix: Designer now always shows root node properly
  • New: Search Terms report
  • Update: Added Copy to Clipboard button for iFrame embed advanced options
  • New: Timestamp stock webhook (for Abe in Japan)
  • Update: Cleaned up API documentation so section titles and calls properly matched
  • Update: Layout of My Agents page improved
  • Fix: Phone number verification now treats numbers starting with 1 as International style. Allows for easy verification of USA numbers entered starting with 1.
  • Update: Made margins smaller for embeds in mobile device.
  • New: added email validation option, phone number validation (Tom K., Alok)
  • Fix: Verified badges for address lookups now align with input forms
  • Fix: Address verification now looks better on smaller screen displays
  • Fix: Copying trees now also properly copies checkbox score values in data entry forms (Ana)
  • New: Added CSV export to All Tree Stats report.
  • New: USA Address auto-complete and verification system in place
  • Update: Increased max form fields to 50 (Jonathan K)
  • Update: Scoring nodes can now call webhooks
  • Update: Webhooks and apps no longer run asynchronously, so webhook data is available immediately upon node launch
  • Fix: Recovering trees from snapshots no longer duplicates form fields
  • Fix: Copying a tree saves new copy as first entry in snapshots, labels the copy event properly
  • Update: All tree Stats report shows totals in the last row (Diana T.), lets you select an organization
  • Fix: Thin line at top of embedded trees no longer appears (Josh S)
  • Update: Agent portal “Done with Customer” button now logs that as a button click in session logs
  • Fix: Plus signs in email addresses now get transferred properly via email-session-info link nodes.
  • Fix: Embed options now always uses https by default.
  • Fix: Publishing links cleaned up for https always.
  • Update: Custom CSS URLs are now forced to be https in Settings tool.
  • New: Data Totals report
  • Fix: Saving layouts with unlinked nodes in Designer no longer gives weird error messages
  • Fix: “Default Browser” as browser type broke Zendesk agent scripting app for some people
  • Fix: Redirecting from http to https didn’t work for some really long URLs. Including Zendesk Agent Scripting app.
  • Fix: Webhooks now handle URLs with variables with spaces properly
  • Update: Now forces https for all URLs
  • New: Added zt_browser as an enhanced location variable
  • Fix: Pressing restart button reloads enhanced location variables, merge variables
  • Update: Question field length now 500 characters (Julie C.)
  • Fix: Updated location data for higher volume lookups
  • Fix: Resetting button click variables on the first click now works properly.
  • Update: Export to CSV buttons now at top of each report page (for Josh)
  • New: Option to switch between running total and fixed value for button click scoring

Whew! That’s a lot of updates over the last two months.

Whenever possible, we give credit to the customer who suggested an improvement. So if you have a brilliant idea, a suggestion, or a real need, let us know and we’ll do our best to make it part of the next update.

Publishing Pop-Up Decision Trees

Zingtree makes it fun to include decision trees on your site by enabling them to appear on top of any page, simply by clicking a button. We call this publishing method a “pop-up overlay.” You can easily customize the button color, text, and look of the trees.

You can also include multiple trees on one page. Try these examples:

    

 

Here’s how to set up pop-up overlays:

  1. Click the My Trees button at the top of the screen.
  2. Choose the tree to embed.
  3. Select Publishing Links.
  4. Click Pop-up Overlay via Button Click.
  5. Copy the default button code to your web site, or click the Advanced Options button to do some cool customization.

Shortcut: Go here to create a button that launches a pop-up overlay for your tree.

We think this is yet another cool way to incorporate interactive decision trees into your web site. Do you like it? Or have a better idea?

Send us feedback and let us know what you think!

Repeating Forms in Decision Tree Data Gathering

Our call center customers are so enthusiastic about Zingtree that we get some awesome feature requests. In particular, more and more operations are using decision trees for collecting data. One essential part is to be able to collect information on an indeterminate number of items.

For example, an insurance application may need to collect names and ages of each family member – be it one or twenty. Zingtree’s Repeating Forms capability fulfills this need.

How Repeating Forms Work

Quick dive: Try this demo tree from the Gallery.

The details: A node can collect multiple forms, one at a time. First, the agent starts with one form:

The agent can click Add Another to enter a second family member:

This can continue for multiple family members. At the end of the process, when the agent clicks the Continue button in this tree, the tree’s session will data variables set for each family member, like so:

Configuring Forms for Repeat Entries

When editing a node, there’s an option in the Data Entry Fields part to configure repeating items. Here are the details:

  1. Edit the node with the form you want to make repeating.
  2. In the Data Entry Fields area, click the Repeat Form option:

  3. Enter the maximum number of items to repeat (up to 50):

  4. Click Save Changes to save your work.

That’s all you need to do! The data variable names for your repeating forms will have an underscore and an item number at the end. So, in the example above, the variables for name and age will be name_1 and age_1,  name_2 and age_2, etc.

Thanks again to Tom K. for the great feature suggestion. While your trees can gather repeating items, great ideas like this need to be repeated only once to make it into the product.

So if you have a killer suggestion, please share!

Create Decision Trees using Microsoft Excel

decision tree excel

If you’re comfortable using Microsoft Excel, you can build the first draft of your Zingtree decision trees in Excel using a spreadsheet, and then easily import them into Zingtree. Once you’ve successfully imported your tree, you can modify it and enhance it using Zingtree’s editing tools, which offer a lot more decision tree related functionality than Excel.

Here’s how our example tree used in the tutorials appears in Excel:

Overview

Zingtree can create decision trees from Excel, or any similarly formatted tabular source. Your spreadsheets just need to be set up in a specific way for this to work.

Start now by downloading and modifying this example .XLS file:

Download Examples for Excel

Note: This spreadsheet has two tabs: Basic and Advanced.

Here are the rules:

  1. The first row is for column headings. This is important, as it tells Zingtree what type of data is in each column. Make sure to use the column headings as described below.
  2. Column A is for the node number. Usually, this is sequential. It’s required. The heading must say “Node“.
  3. Column B is for the title of a node. Your trees will be easier to read if each node has a descriptive title. The heading must say “Title“.
  4. Column C is the question that is being asked. You can leave this blank if you want an answer node. The heading must be “Question“.
  5. Column D is for any content that appears in the content area.  This is imported as plain text, but you can add formatting, images, and videos later using the Zingtree editing tools. The heading must read “Content“.
  6. If you want to include node tags in your tree, insert a column with a heading of “Tags“. This is optional.
  7. If you are using a scoring variable for scoring button clicks, add a column headed “Score Variable“. This is optional.
  8. The last columns are for the button choices.  The heading over the first button column must be “Buttons“. You can have several columns of buttons.
  9. For the button columns, you can make them link to other nodes by adding the node number in square brackets.  In the above example, cell F2 has a button labeled “Yes” that links to node #2.  ( Yes[2]  ).
  10. If you’re using score variables for button clicks, you can include something like “+3” after the node number in brackets.  This would add 3 to the scoring variable mentioned in the Score variable column. (See the Advanced tab in the sample spreadsheet for an example.)
  11. If you want to add a comment to any node, insert a cell on the right that starts with an exclamation point character (!).

Note: Columns can be in any order, but the column headings must contain the proper text like “Node”, “Question” etc.

You can also make Link Nodes and Tree Nodes with special text in the content column:

  • Example: To make a Link Node that goes to Google, the content area looks like this (see cell D9 in the example):
    LINK: http://google.com
  • Example: To make Tree Node that opens tree ID #123456789, the content area is this (see cell D8 in the example):
    TREE: 123456789
  • Example: To make a Tree Node that opens tree ID #999999999 at node #3, the content area should be:
    TREE: 999999999,3

Once you’ve finished your tree, it needs to be exported as a TXT file. This is also known as a tab delimited CSV.

You can also just copy and paste cells from your Excel document into Zingtree. Excel copies tab delimited CSV data to the clipboard automatically.

Build Your Tree

To start, download our “what to wear” example tree, as an Excel.XLS file.

Open this file in Excel, and start modifying it.  You can use the Basic or Advanced tab – most people start with the basic option. Make sure to keep top row column headings in place. Keep questions in the question column, content in the content column, etc.

When you’re done, you can import it into Zingteee via copy and paste, or by exporting to a TXT file.

Import via Copy and Paste

This is the easiest way to bring your decision tree into Zingtree:

  1. In Excel, select the entire range of cells for your tree, and copy to the clipboard (Ctrl+C or Cmd+C).
  2. In Zingtree, go to the Import via Copy and Paste tool.  (You can also get there via My Trees, Create Tree, then select Import from Microsoft Excel.) A screen like this appears:

  3. Choose Microsoft Excel as the source.
  4. Enter a name for your tree
  5. Paste the data copied from step 1 into the data area. (Use Ctrl+V or Cmd+V).
  6. Click Import and Create Tree.

You’ll see your new tree in the Zingtree overview.

Import via a TXT file

For larger trees, you may find it better to upload a file instead of copying and pasting. Here’s how it’s done:

  1. In Excel, go to File, Save As, and select Text (Tab Delimited) as the type.

  2. The file name will become the name of your tree. Click Save when finished.
  3. In Zingtree, go to the Import File tool. (You can also get there from My Trees, Create Tree, and then choosing Import from Excel.)

  4. If you want to overwrite an existing tree, select it via Replace Tree. Otherwise, a new tree will be created.
  5. Click Import File, and locate the file you created in steps 1 and 2.
  6. The new tree will appear in Zingtree.

Notes:

  • You can use this process to import files from any tab delimited CSV format.

Any questions? Reach out to us anytime. 

This article was originally published January 26, 2017.

Validate Email and Phone Numbers in Decision Tree Data Entry

Besides address verification, Zingtree can also validate phone numbers and email addresses entered while collecting data in your decision trees. Since there’s nothing worse than missing an opportunity due to a typo, being able to ensure good clean data is now much easier.

Here’s a short animation that shows how it works:

Try it Yourself!

The Zingtree Gallery has demonstration trees for validation. Just enter a phone number or email, and move to the next field in the form. A validation status badge appears automatically.

Try the Email Validation Demo
Try the Phone Number Validation Demo

Both phone number validation and email validation work world-wide. If your are entering phone numbers for people outside of the USA, you’ll need to prefix them with a plus sign. USA numbers can be entered without a plus.

Setup

There are two steps to enabling validation:

  1. Using the Settings tool, configure your tree to validate phone numbers or email addresses.
  2. Use an email or phone field type in the data entry fields in your decision tree nodes.


How to set up your tree for Phone or Email validation:

  1. Go to My Trees, and select your tree.
  2. Click the Settings tool, and make sure Verify: Phone or Verify: Email is selected.

  3. Click Update Settings to save.
  4. Now, let’s add a phone or email data entry field to a node.
  5. From Overview, pick a question node to edit, and click the Edit Tool.
  6. Go to Data Entry Fields, and add an Email or Phone Number type field:

  7. Click Add Field, and then Save Changes to save your Node.

Please note: Using phone or email validation is an extra cost, usually $0.01 per lookup.

Tips and Tricks

  • When using validation, it’s best to make sure the phone or email field is the first field, or has at least one more field below it. The validation process doesn’t start until the cursor leaves the edit box, so if it’s the last field in the form the validation may never occur.
  • Once a field is validated, you can hover over the validation badge and get more information about the phone number or email address. Try it!

Summary

Now you have a great new tool to ensure you are getting good, clean data.

As always, if you like this feature, or have any comments or suggestions, please tell us!