Category Archives: Zingtree News

5 Reasons Why Shoppers Might Hate Navigating Your Website

navigating website

Your customer-facing website is meant to be an environment that welcomes, informs, engages, supports, and converts. So why is it that most users only stay on the webpage they landed on for less than 59 seconds?

Everywhere you look online, you can find examples of websites and eCommerce stores that don’t necessarily meet today’s standards of customer ease-of-use. And, while a site visitor could have gotten their answer or information they were seeking within that single webpage in 59 seconds, it’s far more likely that something just isn’t working for your target audience. With eCommerce expected to hit $4.5 trillion in 2021 (Statista) and consumers’ risings expectations for flawless, seamless web experiences to browse and purchase your products or services, it’s more important than ever to pay attention to where your site may be lacking.

There could be any number or combination of reasons why customers might not enjoy navigating your website. We’re shedding some light on a few of the most common issues that eCommerce sites run into.

1. Your products and services are hard-to-find

Poorly-designed menus, hidden information, and clunky sub-categories are responsible for a huge amount of customer dread when it comes to navigating eCommerce sites. A whopping 41% of online shoppers cite this as being a reason for disliking a website; jumping through digital hoops to find what they’re looking for just doesn’t cut it.

Having a well-organized menu of web pages and easy-to-use product finders are a fantastic method for helping customers to help themselves and find just what they need. From selecting a pair of sunglasses to figuring out the best type of bike, Zingtree product finders are the easiest way to locate specifics among a robust product offering.

2. You have poor search functionality

Search is at the core of every eCommerce website’s ability to convert customers quickly and easily. Incredibly basic search functions that don’t even use filters to refine the results can be a frustrating experience. With a poor system fleshed out for searching products, support information, and other FAQs, customers will feel lost in your website and be much quicker to abandon ship.

The more complex your product or service offering, the more advanced your search functionality should be in order to keep up with customer needs. eCommerce search tools that are efficient and effective have shown to prolong a customer’s visit to your website and is far more likely to encourage a sale.

3. You haven’t optimized your site for mobile

It’s safe to say that mobile shoppers are now officially outnumbering desktop-only online shoppers. Mobile eCommerce sales account for 34.5% of total eCommerce sales in 2017, and that number is growing still. If your mobile eCommerce site leaves something to be desired, or if it’s completely non-functional, it’s time to make it a priority.

If a customer on a smartphone opens up your website to find and purchase a product, and that mobile site is difficult to navigate, loading slowly, or clearly not set up to support such dimensions, they will leave immediately and not come back. When making final purchases and using online bill pay, this becomes even more important to remain competitive.

Image via UserZoom

4. Your design leaves something to be desired

While we may teach not to judge a book by its cover, the look and feel of your eCommerce site means absolutely everything. In fact, many consumers won’t even make a purchase from a website they don’t feel has a trustworthy appearance. If your customers type in your URL and get launched into a UI from the early 2000’s, the urge to find somewhere more visually pleasing to do their shopping is inevitable.

Website design directly correlates with how customers determine whether they believe you to be a reliable, professional company. 95% of users indicated that a positive user experience is the most important factor when they visit a website (Econsultancy). In addition, Forrester has reported that your website’s conversion rate could increase by 200 to 400% with a well-designed interface.

5. You don’t have an FAQ

When any type of purchase is involved, customers will consistently have questions about shipping, returns, manufacturing, and other specific details of your business and its products. Having a Frequently Asked Questions (FAQ) section that’s easy to locate, scan through, and find what you need saves your customer valuable time and improves your eCommerce site’s conversion rates.

Interactive FAQs and customer support decision trees were designed with this in mind, offering a powerful platform for customizing and publishing an in-depth, yet concise knowledge base of information. With an interactive element that’s simple to search through and find just what’s needed, customers feel empowered to solve their own problems without getting in touch with your eCommerce business directly.

 

Ready to learn about how Zingtree’s powerful toolkit can help you create interactive FAQs and product finders that will keep customers happy, engaged, and converting? Get in touch, be sure to check out our example decision trees, and read up about our solutions for eCommerce and retail businesses. 

Zingtree Updates: September 2018 – Labor of Love

Just in time for Labor Day, here’s what’s been happening at the Zingtree labs this summer! With a new Task Manager, PDF capability for Document Nodes, renumber and merge trees, and some more notification options are the highlights, we’re really excited about the progress we’ve made over the last several weeks.

See all of our improvements since June 2018 below:

New Features

  • Task Manager tool: Business Process Management, using Zingtree decision trees.
  • Renumbering nodes: You can now renumber nodes using the new option in the Copy Tree tool.
  • Combine trees: Make two trees into one using the new Merge Trees tool.
  • PDF generation: Document Nodes can now create PDF files.
  • History and Breadcrumbs: Embedded trees now have URL switches for embed_history or embed_breadcrumbs (various).
  • Push Live update flag: For trees with Push Live, DEV trees with updates since last push live now show with a red icon in My Trees (thx Lasse).
  • Event Log: See failed emails, login attempts and more from Account > Event Log.
  • Simple SMS, email & Slack notifications: From new built-in Apps under Account > My Apps.
  • Multiple apps: You can now have several apps/webhooks on a single node.
  • Better receipts: Customer receipts now have a PDF download option.
  • Erase variables: There’s now a Zingtree Erase Variables stock webhook (for Pharoah).

Updates and Minor Improvements

  • Agent feedback comments on a LIVE tree now always go to DEV version of the tree (Ian M.).
  • Preview now includes a feedback button (customer request).
  • “Lookup credits” are now “Enhanced Usage” credits.
  • Now shows “please wait” when loading traffic map (button clicks) report.
  • Added “please wait” message to long tree loads.
  • CSS templates now display white text in HTML <btn> tags (used in adding buttons to node contents).
  • Preview tool shows back, restart button options.
  • Added hint for webhook calls in the node editor.
  • Uploads now go to uploads.zingtree.com instead of zingtree-uploads.s3.amazonaws.com.
  • Doesn’t show “back” or “restart” on the starting node (Various customers requested this).
  • Right-to-left (Hebrew) display for History bar looks better (for Tal).
  • New WordPress plug-in 5.0 supports history, breadcrumbs.
  • Reorganized My Apps page.
  • Node labels in button choices in content node editor now use node titles (if available).
  • Session Details report cleaned up.
  • “Unknown” result label changed to “In Progress.”
  • Drawing return-to links from tree nodes now supported in Designer.
  • Content Node editor loads faster (thx Oliver).
  • Multi-tree API calls sped up.
  • Link control in the editor and new link nodes now defaults to “new tab” (Jonathan B.).
  • Content editor no longer shows link option for Google, Facebook, Froala.
  • Content editor links now have a tooltip option.

Fixes

  • Linking from LIVE to DEV tree now shows proper tree ID of DEV tree in session data.
  • PNG export looks for invalid characters that can break it.
  • PNG export is better at framing the content of the tree in the PNG.
  • Copied trees now show current date and time for “last opened” – appears at top of the list in My Trees.
  • Adding new merge variables in a pause and resume scenario now works consistently (Lasse).
  • SSO author login errors no longer stay stuck unable to log in.
  • Empty checkbox score no longer crashes form field data update (Jay H.)
  • Double-quoted strings now work OK in Logic Node editor, Designer for Logic Nodes.
  • Single quotes no long make Zapier transfers fail (Alok).
  • Now says “new logic node” instead of “new scoring node” in an alert message when creating a new logic node.
  • Doc node Continuation buttons now use theme.
  • Searching linked trees used the wrong search when a fade transition was in effect.
  • MailChimp API calls changed to always use a secure connection – now works properly again (Jonathan T.).
  • Form field labels in the content editor no longer show HTML codes instead of single quotes (Kwame A.).
  • Document node continuation button editor now shows email nodes correctly.
  • Breadcrumbs and history restore to the same state when pause & resume is triggered after a ##treetag-any## or ##treetag-all## link is clicked (Tal).
  • Custom CSS generator now ensures variables have values – won’t show error messages.
  • Layout for Snapshots tool now better for action buttons on one line.
  • Now allows multiple simultaneous people to use Agent Portal or Task Manager demos.
  • Centering videos now works properly.
  • Task manager login page no longer redirects to agent login page if the session is no longer valid.
  • Session click history output when included in a node now also includes blank questions in the click path – substituting page titles instead (Tatiana).
  • User-only text now hidden in subtrees when in agent mode (Kelly S.).
  • Thumbnails overview now shows “auto-send” for auto-send email nodes.
  • Sending email when the main tree was pushed LIVE and subtree was DEV now works as expected (Rachel D.).
  • Fixed bug with Tree tag links not working after restart.
  • Tree-node node selector now shows updated labels.
  • Rendering engine faster for large trees with many variables (Lee S.).
  • Shows stock apps in Settings/Code selector.
  • Inviting authors always allows people to continue signup.
  • Auto-send from email nodes no longer logs click text from the previous click.
  • Email input form now displays wider on small devices (Christiaan).
  • Edit, Copy buttons for auto-email nodes in Thumbnails overview now works as expected (Ian M.).
  • Tree rendering now handles improper UTF-8 characters (Thai).
  • DEV trees no longer show in Agent Portal search results (Angie H.).
  • CSV import now handles UTF-8 characters properly (Emma V.).
  • API speed updates for find_agent_sessions, find_tree_sessions.
  • Editing code in pop-up Content Node editor now highlights properly (Matthieu).
  • Empty webhook return no longer causes JS error.
  • Tags now allow Hebrew characters (Tal).
  • Now replaces #session# in email node templates for auto-send (Lasse).
  • Phone number validation no longer fails if there’s a space inside the phone number.
  • Retina display of screenshots now works properly in Wizard, Designer tutorials.
  • New email form nodes now include session data.
  • Email form node shows default text if no continuation text specified (for Legacy forms).
  • Email form nodes properly show “please wait” when Send is clicked.

That’s it! Keep an eye on all of our product updates, and feel free to reach out with any questions, anytime. 

Service Issue – September 2-3, 2018

We experienced a temporary issue with saving data from approximately 12 PM PST September 2, to 12 PM PST September 3. This was caused by an update which passed our QA process, but nevertheless had issues.

The functionality of trees worked properly, but any data collection during that time may not have worked properly for some trees.

Going forward, we’ve updated our build process to ensure this particular issue does not resurface again. Our apologies if this affected your operation in any way.

Thanks for your patience, and continued support of Zingtree.

P.S. If you are using Agent Portal, we may be able to recover raw data from the outage period. Just ask us on chat.

Decision Trees for Business Processes – The Zingtree Task Manager Tool

Business Process Management with Zingtree

Overview

One of the more common, interesting uses for interactive decision trees is as an online task management tool for streamlining recurring business processes. These are standardized workflows that have a series of repeatable steps, which may need to involve handoffs to different people on a team or even in another department. For example, your company may have an approval process for:

  • making purchases
  • approving project budgets
  • hiring or firing employees
  • creating blog posts (like this one!)
  • and any other repetitive tasks or processes your business uses

The Zingtree Task Manager is a dashboard for guiding your coworkers through decision-tree-based processes created using the Zingtree tools.  This makes it easy for everyone to be held accountable, and to follow standard operating procedures.

Here’s a diagram of a simple purchasing process:

In this case, if the item is under $100, then the request is approved automatically. Otherwise, a manager needs to approve the order.

Set Up

Creating your first business process with interactive decision trees is not complicated. It involves these steps:

  1. Enter your “agents” – the people who act upon your processes – and assign them to groups.
  2. Create a decision tree, and assign each node (step of the process) to one of your Agent Groups.
  3. Assign your tree(s) to various Agent Groups. Only people in those groups will be allowed to start or kill a project.

This article has full details on how to set up your first business process.

The Task Manager

The Zingtree Task Manager was built with full-team functionality in mind. Anyone involved in a work process can use standardized decision tree workflows to navigate through the procedure. Certain steps can only be completed by specific people, and once you reach a step where it’s no longer your responsibility, that task is assigned to someone else.

This article has a video and full reference for the Zingtree Task Manager.

For example, in the procurement process diagrammed above, an employee creates the purchase request and a manager approves or declines it if over $100.

Here’s how the Task Manager could appear for an individual:

When someone Takes or Resumes a task, it looks like this:

Groups

Each person involved in a process (an “agent”) can belong to one or more groups. You can configure people and groups via Account > My Agents. So for example, a small team with two employees and one manager is set up like this:

Note that “Bill Zing” belongs to both the manager and employee groups.

When creating your process trees, you can tag each tree with the groups that are allowed to start the process.

Assigning Steps in the Process using Tags

Each node of your business process tree needs to include the Agent Group(s) allowed to act on that step of the process. You can see how our procurement process tree’s groups (outlined in red) are set up here:

 

The initial request step (node #1) is tagged with “employee”, so only people in the employee group can initiate a request. Node #6 – the Manager approval step – is tagged as “manager”, so only a manager can approve the purchase.

Assigning Agent Groups to a node is done using the Groups tab when editing a node. Here’s how node #1 is set up for an employee group:

 

Project Status: Success, Failure or In-Progress

At the end of a workflow, a project is either successful or a failure. When building your process tree, you can assign a result to each node in the node editor – like this:

Once a node is reached with a success or failure result, the process has ended.

Notifications

A notification can be sent when any node (process step) is reached so that the next person can be alerted and step in for their task. Notifications can be sent in a few different ways, including:

  • A text message
  • A simple email notification
  • A Slack notification
  • A customized email (using an email node)

Task Manager Operations

Your agents – people involved in your processes – can perform the following operations on each task:

  • Start: Begin a new task, and assign it a name.
  • Take: Take over the next step of a task. Only one person at a time can move a task to the next step.
  • Release: Release a task so another person can complete the step.
  • Resume: Continue with a task that you have previously taken.
  • Revisit: Go back to a previous step in the task you have permissions to act upon.
  • Reclaim: Take back a task from someone who has taken it.
  • Kill: End a task early, without following all the steps to completion.

Go here for a full reference on the Task Manager


Got questions about using Zingtree for streamlining your repetitive business processes? Reach out to our team!

Using Zingtree’s Task Manager for Your Business Processes

Business Process Management with Zingtree

Once you’ve been set up as an “agent”, you can log in and start using the Zingtree Task Manager. You can easily check for tasks that are awaiting your action, see other tasks of interest and revisit them.

Watch this video for a quick two-minute tour of Task Manager basics:

This video shows more advanced operations:

 

Task Manager Test Drive

Want to use Task Manager just like a real person?

Try a working version of the Task Manager here.

Operations Reference

Click on any operation below to learn how it works:

Opening the Task Manager

To start, open the task manager and log in from here.

The task manager appears like this:

Starting a New Project

  1. From Task Manager, click Start a New Project.

  2. Click the Start button next to a business process workflow. The Start New Project screen appears:

  3. Give the project a name, and click Start New Project.

You can now click through your task steps in the project.

Taking or Resuming a Task

The task manager shows you tasks which require your attention, under My Tasks Needing Action.

Click Take It to act upon the task. If you’ve already taken a task, you can click Resume to continue the task you’ve taken.

Releasing a Task

If you’ve previously taken a task, but now you want to let someone else in your group act upon it, you can Release it. In the above example, if you click Resume, your task screen will have the option to release the task via the orange Release Task button in the upper right:

Reclaiming a Task

If someone else has taken a task, and you want to act upon it and override them, you can use the Reclaim option. Here’s how to do it:

From Other Projects in Progress, click the info button to the right:

This opens the project info pop-over:

Click the Reclaim button to give yourself access to this task.

Killing a Project

Sometimes a task will get started, and it turned out to be a bad idea. Using the same process as above, you can click the red Kill button to kill a project.

Killed projects will appear under the Completed Projects tab in Task Manager.

Revisiting a Task

There may be times when you want to go back to a previous step in a project. For example, in the PC Purchase project, the manager may have declined a purchase and then changed her mind.

When a task is opened, the Task Progress accordion shows the steps taken previously. Click the brown Revisit button next to a step to go back to that part of the business process workflow.

Viewing the History of the Project

The Task Progress accordion also shows each step in the project, who acted upon it, and when (see above). You can get even more history by selecting Show Click Detail at the bottom of the Task progress area. This shows you EVERY operation on the project, not just the summary.

See more about our online task management tool for streamlining business processes

How to Setup Zingtree Decision Trees for Business Processes

Business Process Management with Zingtree

Getting your organization ready to use business process decision trees via the Zingtree Task Manager is relatively simple.

Here’s an overview of the process:

  1. Setup your organization to use the Task Manager.
  2. Create your “agents”, and assign them to one or more Agent Groups.
  3. Create your decision trees for the workflows your agents will follow.
  4. Assign decision trees to your Agent Groups.
  5. Assign the steps in your workflows to your Agent Groups.
  6. End the workflows with Success or Failure.

Setting Up Agents and Task Manager

To enable your organization top use Task Manager, start by going to Account > My Agents. Select Task Manager for agent logins, like this:

Next, you’ll need to add agent logins – one for each person who will be using the system. Click Add One New Agent, the enter the agent’s name, a login (usually their email), a password, and what groups they are assigned to, like this:

The groups will be used later to determine who is allowed to act on each step of the workflow. In the above example, Joe Smith is assigned to the employee group.

Assigning Decision Trees for Agent Groups

Each tree you create can be assigned to one or more groups. Any agent in the assigned group can start a new project using that tree as a business process workflow. This is done via the Settings tool.

For example, if we want Joe Smith to be able to run a procurement process decision tree, we would assign that tree to the employee group, as follows:

  1. Select the tree from My Trees.
  2. Open the Settings tool.
  3. Under the Groups tab, enter the group or groups to assign to this tree.

Here we entered the employee group:

Be sure to click Update All Settings when finished!

Assigning Nodes to Agent groups

Each step in the business process workflow corresponds to a node in your decision tree. And just like trees, you can assign nodes to agent groups. This has the effect that only agents in that group can act upon a specific node.

Here’s how to assign a group or groups to a node:

  1. Edit the node.
  2. Go to the Groups tab, and enter the group or groups that are allowed to act on this node.

It will look like this:

Click Save Changes when finished.

Now, repeat this for the other nodes in your tree.

Setting Endpoints

A project ends when you reach a node that has a “success” or “failure” result on it. You can set the result of the node as follows:

  1. Edit the node.
  2. Set the Result to Success or Failure, from here:

Handy Tips

Tip #1: The name of the current task can be used as a variable in your tree. Just enter #task_name# where you want the name of the task to appear.

Tip #2: You can see the results and the groups for every node in a tree from the Simple Overview tool. Here’s a procurement tree with the Results and Groups highlighted:

Tip #3: For all your trees, you can see the Agent Groups allowed to start a project via My Trees. Like this:

See more about our online task management tool for streamlining business processes

Decision Tree Updates: June 2018

Over the last six weeks, we’ve been focusing resources on improving tasks that have been the topics of our most frequent conversations with customers. In general, here’s what we’ve improved:

Here are the details of everything that’s changed:

Visual Designer

For more details on what’s new in Designer, see this post.

  • Update: Question and Answer nodes are now just “Content” nodes.
  • Fix: Designer no longer shows things like &apos; in labels.
  • Fix: Designer no longer hangs with “contains” operation in logic nodes.
  • Update: Designer shows better symbols in logic branches
  • Update: Can now move logic node branches in Designer
  • Update: Designer has no more “save” button. Changes are saved automatically.
  • New: Pop-up editor can now be used to edit button links or logic nodes. Changes appear instantly in the Designer view.
  • Fix: Adding nodes now makes them appear in the proper display order when viewing the tree in Simple Overview.
  • Update: Designer pop-ups can now change the root node.
  • Update: Removed Undo/Redo buttons.
  • Fix: Designer PNG export crops unneeded whitespace from the image file.
  • Update: Designer loads 2x faster!
  • Update: Unlinked buttons appear as red arrows and buttons.
  • Update: “unlinked” node position can be moved and saved.
  • Update: New node icons. These also appear in hi-res for Retina displays.
  • Fix: Button labels no longer occasionally return after being turned off.

Email Nodes

  • New Email Node option to automatically send email, and then continue to another node.
  • Creating email templates is much easier – no longer need to upload HTML files, or use a special link node.
  • You can customize the “Send Message” button for email forms.
  • After sending email, the next step can go to a new node instead of requiring a URL.

Document Nodes

  • New: Document node now has a button option which can continue the session at another node.
  • Update: Document node content selector now shows just content nodes with no to/from links.

Zendesk Agent Scripting App (Version 12)

  • Fix: Now properly sets or unsets checkbox custom fields (Tim J.)
  • Fix: New tickets now works properly in all cases (Linus P.)
  • New: Zendesk App Theme.
  • Version 12 now in Zendesk App Marketplace.

Other Updates

  • Update: Question and Answer nodes are now just “Content” nodes.
  • Update: New icons for all node types.
  • Fix: Editing nodes where there are a lot of variables in content editor list now loads faster (Oliver).
  • Fix: “return to Tree” tree node no longer adds unwanted variables to the list of options in Logic Nodes.
  • Fix: Wizard now properly sets display order for node reordering.
  • Fix: Simple Overview no longer shows nodes used in document nodes in the incoming link count.
  • Fix: Setting scoring value to ‘=0’ now resets the value to zero (Jay H.)
  • Fix: Persistent button link nodes from within a subtree now work properly (Lasse)
  • Fix: When editing a node, “Assign button click variable” no longer sometimes ticked when no variable is present.
  • Update: Added search to Gallery.
  • Fix: treetaglist macro no longer shows duplicate live and dev versions of matching trees. DEV master shows dev versions only when duplicates are detected, LIVE master shows live versions when duplicates are detected (Lasse)
  • New: Added Bootstrap Table styles in content editor (hover, border, striped, condensed) (Kim M, Rachel V, Justin B)
  • Fix: Entering values for scoring uses running total without requiring ‘+’ in front of number, as per documentation (Lisa F., Chad Y.)
  • Fix: Prevents variable names from starting with a digit (Gabriele P.)
  • Fix: Fade transition no longer shows last node when “back” is selected (John H, John K.)
  • Fix: Fade Transitions work properly with logic nodes (Werner G.)
  • Fix: Fade transitions and breadcrumbs now work properly (Ben M.)
  • Fix: Persistent nodes clicked from a subtree now hide last node properly with transition/fade effect.
  • New: GDPR page at zingtree.com/gdpr
  • New: Can now drag and drop document files into the content editor to upload them to our servers (PDF/DOC, etc.) (Lucas K.)
  • Fix: Kustomer integration now adds tags properly when jumping to the root node of a tree via a tree node (Katie)
  • Update: Periods now allowed in tags (Amanda D.)
  • Fix: No longer sending “score=” in Webhook calls for an empty score (John H.)
  • Fix: Adding, editing or removing collaborators from DEV version sets proper access to Live version (Lasse)
  • Update: Date picker now has expanded year ranges (Ronnie L.)
  • New: Can add extra emails for billing notifications (Tom M.)
  • Fix: Button click values like ‘123ABC’ now store as strings, not ints (was saved as 123) (Mark C.)
  • Fix: Default Theme updated so link colors are set properly.
  • Fix: Logic nodes drop-down selections now work when related trees have no variables.
  • Update: Link control in editor and new link nodes now defaults to new tab (Jonathan B.)
  • Update: Content editor no longer shows link options for Google, Facebook
  • Update: Content editor link manager now has a tooltip option.

As always, if you have any ideas to share with us on this or any other features, please let us know!

Zendesk Agent Scripting App – Version 12

If you’re a Zendesk user in a Contact Center environment,  you’ll want to be using our Zendesk Agent Scripting app. This makes it easy to guide, train and onboard agents and is a huge productivity booster for everyone.

Contents of this Article

Overview: Sidebar and Popover views
Pause and Resume
Benefits of the Zendesk Agent Scripting App
New Features in Version 12
Demo Video
Getting Started
Installing the Agent Scripting App into Zendesk
Configuring the App
Enabling Automatic Script Selection
How to Configure to Update Ticket Fields
Using Zingtree Data Entry Fields to Update Tickets
Using Zingtree’s Zendesk CSS Theme
Try It with Example Data

Version 12 gives you the option to show your script directly in the right-hand panel when viewing a ticket, like this:

 

Or you can use less sidebar space, and make it appear as a button in the right-hand panel:

Click Open Script, and you’ll see your decision tree in a larger pop-over like this:

 

Pause and Resume

This happens automatically: If another agent picks up a ticket, they return to the last viewed node, and can see each step taken previously by opening the History.

 

Benefits of the Zendesk Agent Scripting App

  • Standardization: Show a guided path for each ticket, so that Agents follow the proper operating policies or troubleshooting procedures.
  • Pause and Resume: If a ticket is transferred, the supervisor or new agent is taken to the last place in the script, and can see the history of the previous steps taken.
  • Automatic Script Selection: The Agent Scripting App can choose a script based on the Zendesk brand, Zendesk ticket tags, or the value of a custom field.
  • Agent Feedback: Agents can send feedback directly to the authors of the decision trees with a single button click. Feedback is delivered to each author’s email, and includes the tree ID and node number where the feedback was sent from.
  • Zendesk Ticket Data in your Scripts: Values in any custom field, the agent name, customer info, as well as Zendesk ticket tags and user tags, are transferred into your script so you can display them, or use these variables to branch via Logic Nodes.
  • Automatic Ticket Updating: Tags and custom fields in the ticket can be updated from actions in the script – either via buttons clicked in the script, or from data entry collected.

New Features in Version 12

If  you’re using version 11 of the Zendesk Agent Scripting app, you may want to upgrade to take advantages of these new benefits:

  • Option to choose between Sidebar and Popover views
  • New customer information data variables sent from Zendesk: requester_name and requester_email
  • New Zendesk Theme to match Zendesk fonts and styling. This gives you a little more real estate for your content, especially in side-panel mode.

If you’re upgrading from version 10, these features are also new:

  • Toggle to share Zendesk data with Zingtree: Some customers don’t want ticket data shared with Zingtree. There’s now an option to disable data sharing.
  • Removed “Flash”: Some customers experienced a “flash” when moving from ticket to ticket in pop-over mode. This is now fixed with this update.

Demo Video

This two-minute video shows you how Agents interact with the Agent Scripting App:

Getting Started

Here are the basic steps to get up and running:

  1. Build an interactive decision tree script with Zingtree (or use one of our demos to start).
  2. Install the Agent Scripting App (version 12) into Zendesk.
  3. Configure the Agent Scripting app within Zendesk.
  4. If you want to have your decision tree scripts update your  Zendesk tickets, you’ll need to add variables and/or tags to your Zingtree tree to match your Zendesk setup.
  5. If you want to enable automatic script selection, you’ll need to add tags to your trees in Zingtree and configure the Zendesk Agent Scripting app properly.

Installing the Agent Scripting App into Zendesk

Download and configure the Zendesk Agent Scripting App version 12 like so:

  1. Download the Agent Scripting app Version 12 here.
  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.zip you downloaded in step 1.
  7. Click Upload, then confirm if necessary.

Configuring the App

Once you’ve uploaded the app, click App Configuration to see the configuration screen:

Here’s what each item does:

Tree ID: This is the default tree that appears when agents click “Open Script”.  (You should always have a default tree.)

Show Tree in Side Panel: Select this option if you want to display the entire tree in the right-hand sidebar when a ticket is open. Uncheck this to use pop-over mode instead.

Hide Integration Setup Info: When you are setting up Agent Scripting for the first time, you may need some information about your Zendesk setup to take advantage of automatically updating ticket fields. An “Integration Setup Info” link appears by default when you first install the app, and ticking this option hides it.

Match Tree Tags to Zendesk Brand: If this option is checked, the subdomain of the selected brand will be matched to a Zingtree tree tag.  Any matching tree or trees will appear.  For example, if the brand subdomain is xyz.zendesk.com, any trees tagged as xyz (using the Zingtree Settings tool) will appear.

Match Tree Tags to Zendesk Ticket Tags: If checked, the values in the Zendesk ticket tags will be matched with your Zingtree tree tags (set via the Zingtree Settings tool) to show one or more matching scripts.

Match Tree Tags to values in a Custom field: If you want to use a custom field value to show matching scripts, enter the Zendesk custom field identifier here. The field name can be found using the Integration Setup Info link that first appears in the sidebar when you install the app.

Display Half-Height: In Popover mode, the popup view will cover half the height of the screen. This has no effect when using Sidebar mode.

Don’t share Zendesk Custom Fields with Zingtree: By default, the app sends custom field data from each Zendesk ticket to Zingtree so you can do more powerful automatic branching via logic nodes, as well as echoing customer information (like their name, for example). If your organization has data privacy concerns, you can check this option to disable data sharing.

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 Resources, API.

Data Sent from Zendesk to Zingtree

Unless you select the Don’t share Zendesk Custom Fields with Zingtree configuration option, Zendesk will send the following variables to your Zingtree decision tree:

  • requester_name – The customer’s full name.
  • requester_email – The email of the customer.
  • zendesk_tags – Any tags in the ticket.
  • agent_tags – Any tags from the agent.
  • agent – The Agent’s full name.
  • agent_first_name – The Agent’s first name.
  • Any custom fields

To display one of these values, just surround the variable name with # characters. So to show the Agent’s first name in your script, enter #agent_first_name# in the content area of any node in your decision tree.

Tip: Add #ALL DATA# to the content area of any node in your own tree to see all the variables sent to your script.

Enabling Automatic Script Selection

Automatic Script Selection 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, and the agent can choose one.

To open a script based on Brand:

  • Add tags to your trees for each brand you want to match. So if one of your brands is xyz.zendesk.com, use xyz as a tree tag in Zingtree for all the trees you want to show.
  • Make sure Match Tree Tags to Zendesk Brand is checked in the App Configuration.

To open a script based upon Zendesk ticket tags:

  • Add tags to your trees for each tag you want to match. So if one of your ticket tag possibilities is “billing”, use billing as a tree tag in Zingtree for all the trees you want to show.
  • Make sure Match Tree Tags to Zendesk Ticket Tags is checked in the App Configuration.

To open a script based upon a custom field:

  • Add tags to your trees for each possible custom field value you want to match. So if one of your custom field values is “billing”, use billing as a tree tag in Zingtree for all the trees you want to show.
  • Make sure the proper Zendesk field variable name is entered for  Match Tree Tags to values in a Custom Field in the App Configuration.


Adding tags to a tree in Zingtree is done like this:

  1. Select a tree from My Trees.
  2. Go to the Settings tool.
  3. Click the Tags tab.
  4. Enter or select a tag from the Tree Tags field.

  5. Click Update All Settings.

How to Configure to Update Ticket Fields

As agents navigate through your trees, their use of the decision tree scripts you create can automatically update any custom fields in that ticket. This can be done in two ways:

  • By clicking a button in a script
  • By entering data into Zingtree data entry fields.

The key is to use variable names in your Zingtree that match the ones used in Zendesk.

First of all, determine the names of the variables in Zendesk by clicking the Integration Setup Info link in the Agent Scripting app. You’ll see something like this:

You’ll see the label for the field as it appears in Zendesk’s ticket form and the Zendesk variable next to it. In the above example, the Product custom field variable is custom_field_22899289. This is a drop-down selector, and the Zendesk values for the field options are astrology and insurance.

For the rest of this example, we’ll use custom_field_22899289 as the custom field variable.

To make a button selection update a custom field, you’ll set it up in your Zingtree as follows:

  1. Go to the Overview tool, and edit the node whose button selections will update the ticket.
  2. Click Edit Buttons (or Add Buttons if you don’t have any buttons defined). The button editor appears:

  3. Make sure Assign Button Click Variable is checked. This makes the other options appear.
  4. For the Button Click Variable, enter your custom field variable from Zendesk (custom_field_22899289 in the example).
  5. For each button option, enter the value of the variable under Score/Value. If this is a drop-down list in your Zendesk ticket, you’ll need to make sure the Score/Value entered matches one of the drop-down option values as shown in the Integration Setup Info.
  6. Click Save Changes when you’re done configuring buttons.

Bonus: Adding Tags via button clicks:

Button clicks can also add tags to a ticket. In the above example, clicking Something Else adds the tag other_tag to the ticket. Just include the tag name with two colons after the button text. So entering a button like Something Else::other_tag will add the tag other_tag to the ticket if this is clicked, but agents will only see Something Else as an option.

Using Zingtree Data Entry Fields to Update Tickets

Just like the above example, you can also use Zingtree for data entry and have that data automatically transferred to your ticket. The key is to use the same variable name in Zingtree as you used in Zendesk. The Integration Setup Info link in the sidebar will give you those Zendesk variable names.

Example: If you have a text entry field in Zingtree you want to update into the Zendesk field custom_field_1234, you would set up the variable name as follows:

Using Zingtree’s Zendesk CSS Theme

For the best user experience, we recommend using the Zendesk Apps theme in your trees that display inside of Zendesk. This will give you more room for your content (since the fonts are smaller), and also match the look and feel of the rest of the Zendesk experience.

Here’s how the theme looks in the two style options:

Buttons style:


 

Panels style:


 

 

To include the Zendesk Agent Scripting App theme in your trees, do the following:

  1. In Zingtree, open the Settings tool for your tree.
  2. Click the Display tab.
  3. Choose either Buttons or Panels as the Default Display Style.
  4. Click Pick a Color Theme.
  5. Choose Zendesk Agent Scripting as the theme.
  6. Click Save Theme and Colors.
  7. Click Update Settings.

 

Try It with Example Data

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

This Zendesk Agent Scripting Demo shows how to implement some of the basic integration features. You can install it into your own Zendesk configuration by entering tree ID 350546744 in the App Configuration.

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

  1. In the App Configuration, enter 6a103737e44e4aa6e1e4b6b0bcb46f83 as the API key. Also make sure Match Tree Tags to Zendesk Ticket Tags is checked.
  2. 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 zapier integration

Our Zapier app makes it easy to send data collected during each Zingtree session to 1000+ 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 into 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. 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. Click the Apps/Webhooks tab.
  3. Click Add App/Webhook. You’ll see something like this:

  4. Under Call App or Webhook, select Zapier: Zingtree to Email. This is the new Zap you created.
  5. Click Save Changes.
  6. 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!

February/March 2018 – Decision Tree Updates

We’re still getting a ton of great ideas from our customers, as well as the occasional “I can’t do this” message. The last couple month’s updates primarily focus on the little details that set Zingtree apart from any other solution, but there are a few new goodies as well.

Here’s what’s new:

  • Settings/Data has options to include these variables in the session: tree_id, tree_name, last_tree_id, last_tree_name (for Tal)
  • Agent Feedback option for sending agent feedback emails to a specific address, instead of all authors. (Tara)
  • Agent Alerts
  • New API call get_session_data_pure – removes “back” and “restart” clicks from session path.
  • ##library tag to load content from another node.
  • Agent Portal specific login page
  • Deleting agent feedback comments now has an option to send a message as well (Tara).
  • Kustomer integration now adds tags to nodes (Katie)
  • Added full-width textbox data entry field type (Lasse)


Some updates to existing features:

  • Reorganized Settings/Data tab area.
  • Logic Node editor now has tabs – just like content editor.
  • Added “Export to CSV” checkbox option in main reports tool page.
  • Session List report now shows lookup credits used (if any were used).
  • Session List report: If no sessions appear for DEV version, we now show a button for LIVE version reporting.
  • Session detail report now shows questions by default, not page titles.
  • Logic nodes now show variables from trees linking to and from the current tree, up to 8 levels.
  • No longer adds “score” as a score variable for Email, Link, Tree nodes
  • Tags now allow Unicode characters (Alfred G.)
  • Google sign-on now allowed for agent portal (Kwame)
  • Asks new users to confirm T&C and Privacy Policy (GDPR compliance)
  • Better color palette in node editor (Dean S.)
  • API JSON now returns in pretty-printed format for easier readability
  • Feedback comments now show in user’s timezone (Ian M.)
  • Patched security vulnerability in session tracking
  • Added session_notes to available Zapier data (Alok)
  • Hyphens now allowed in tags (Isaac W.)
  • Using Zingtree CDN for fonts (Roger A.)
  • Added tags as tag_ classes to node rendering (John H.)
  • Allows locale= parameter to be sent along in host.php to override browser’s default locale (Alok)
  • Now sends organization name into agent portal as a variable (for Ted B.)
  • Persistent buttons now spaced farther apart
  • Hosting lots of assets at assets.zingtree.com for faster browser load speed. (Roger A.)


And some fixes and performance enhancements:

  • Agent feedback messages no longer include slashes before apostrophes in the message text.
  • Organizations being paid for by another org now can enable the referral icon in Settings. (Alfred G.).
  • No longer does address verification lookups when loading tree with preloaded addresses (Jay H.).
  • Form data report now faster (Kyra).
  • Sessions List report now faster.
  • Should see fewer 504 or 524 errors on big reports since we increased the server time-out.
  • Extra spaces in list box data entry fields get removed properly (Nellie).
  • get_session_data API call would occasionally show wrong questions when a subtree was involved (Mark C.).
  • Webhooks mechanism disallows null values and arrays in return data (Daniel)
  • Centering or right aligning images in text editor now renders properly. (Chris)
  • Source list drop-down in Sessions List report no longer missing some agents (Chrissie)
  • Disabling Push Live still loaded Live tree in Agent Portal, messed up tag matching. (Alexandra R.)
  • Ill-formed taglist macros no longer cause deploying trees to hang. (Tara D.)
  • Button override colors work properly in all cases.
  • Button override class markers (like .btn.red ) no longer show in history display
  • Animated templates now wrap buttons properly in IE.
  • Importing CSV spreadsheets no longer allows variables with space characters in them (Daniel)
  • Single quotes in button click variable values now works properly (Isaac W.)
  • Dynamically generated list boxes from webhooks can now retain their previous selection after “back” is clicked (Raj P.)
  • ##treetaglist and ##taglist macros can now be properly combined in a page (Lasse)
  • get_session_data API calls now removes style prefix (i.e. .btn-red) from button text
  • JSON export no longer loses last character on occasion, output is more readable (Alfred G.)
  • Pressing BACK from root node no longer erases merge variables. (Jay H)
  • Copying trees now includes placeholders, hidden fields (Jay H.)
  • Edit node error message no longer goes to 404 page (BD)
  • Super-user with no trees now can see trees by other authors and assign themselves rights.
  • keep_vars_on_back=1 parameter no longer erases form data if a “back” was hit after first node (Jay H.)
  • Improved XSS detection so that formatted data isn’t changed (Michael B.)
  • Jumping to a tree node now keeps the form data stack properly in sync (Lazarus P.)
  • Can now update the Google Analytics account by erasing it (Josh)
  • Empty drop list data entry variables no longer throw an error.
  • Messages from overview.php now display properly.
  • Login forms ensure cookie is set and present.
  • Tree names with single quotes no longer cause browser error.
  • Clicking tree nodes in Zendesk app now updates Zendesk variables properly.
  • Patched author and agent logins to prevent CSRF attacks (logins into an unexpected account).
  • Going back over scoring nodes with a subtree jump now works properly. (Katie)
  • Now properly scrolls Thumbnails overview to last edited node.
  • Browser back button now works properly in Preview tool.
  • Alert messages with @ in them now show (introduced from security fix).
  • Agent Portal – Hides DEV version of a tree if a live version is present (Matthieu).
  • Security Fix: Prevented URLs that can change emails or passwords of logged-in users.
  • Security fix: Locked down alerts system to display validated Zingtree-generated messages only.
  • Confirmation emails now use https for verification links.
  • Wizard tutorial page now up-to-date.
  • Uses new LIVE version of Designer help (with embedded video)

Got a suggestion for us? Just chat us up.