salesforce and zingtree

 

Update May 2019: Have a look at the Zingtree Agent Scripting app for Salesforce.

Original article:

If you run a Call Center or do live support, and you use Salesforce, being able to link a Zingtree script or troubleshooter to each case is really handy. Not only does this give agents a guide to follow when helping customers, but if a case is transferred or reopened, the last viewed node in the Zingtree reappears, and the entire history of the session is available as well.

Inside of Salesforce, we’ll create an Agent Script button, accessible from each case. Clicking this button will open an Agent Script, built with Zingtree:

Here’s how to set up Salesforce with an embedded Zingtree:

  1. Go to Salesforce.com, and log in to your account.
  2. Click Setup on the top right of the screen.
  3. Select Build > Customize > Cases > Buttons, Links and Actions in the left panel.
  4. Click New Button or Link.
  5. We’ll modify the New Button form to look like this:
  6. Make the Label “Agent Script”.
  7. Make the Name “Agent_Script”. (The name cannot have space characters, so we use an underscore here.)
  8. Select Detail Page Button.
  9. The Behavior is Display in New Window.
  10. The Content Source is URL.
  11. For the URL, make it look like this (substituting the tree ID of your script for #########):
    https://zingtree.com/host.php?z=salesforce&date_format=yy-mm-dd&tree_id=#########&style=panels&show_history=1&persist_names=Restart&persist_node_ids=1&agent_mode=1&nopermalink=1&source={!Case.OwnerEmail}&session_id=SF#########-{!Case.CaseNumber}&sf_id={!Case.Id}
  12. Click Save.
  13. Next, we have to add the custom button to the Case page layout. Within Setup, go to Build, Customize, Cases, Page Layout.
  14. Click Buttons.
  15. Drag the Agent Script button into the custom buttons area, like this:
  16. Click Save.

Now, when your agents are in a case, they can click the Agent Script button, and walk through your Zingtree troubleshooter with the customer. Awesome!

Customization Notes: You can use the Zingtree Advanced Hosting Options to customize the display of your tree within Salesforce by modifying the URL. Once you’re done, take the hosting URL, and add the following to it (substituting your tree ID for #########):

&source={!Case.OwnerEmail}&agent_mode=1&session_id=SF#########-{!Case.CaseNumber}

Leads and Other Object Types

You can use the Zingtree Salesforce app with other objects besides Cases. For example, to work with Leads instead, your URL (from step 11 above) will look like this:

https://zingtree.com/host.php?tree_id=#########&style=panels&show_history=1&persist_names=Restart&persist_node_ids=1&agent_mode=1&nopermalink=1&source={!Lead.LeadSource}&session_id=SF{!Lead.Id}&sf_id={!Lead.Id}

The keys are:

  • Make the sf_id parameter contain the Salesforce object ID.
  • The session_id parameter needs to be tied to the object, and should be universally unique across all Zingtree customers. (Using the Salesforce object ID with a prefix works well.)
  • The source parameter should be the name or identifier of the person operating on this object.

New Updates from 2018: