Nutshell Integration

Jul 08, 2015 | 0 comment

LiveHelpNow help desk software collects a lot of useful information about your customers. The integration with Nutshell will allow for easy transfer of live chat information into your Nutshell people list for additional marketing, business analytics, upsell and cross sell flow.

Please complete the following easy steps to integrate your LiveHelpNow chat user info into a Nutshell People list.

1. In order to setup this event, you will need to know your Nutshell User ID/email adress and API Key. To locate your API Key in Nutshell, click the Setup (1) option in the sidebar on the left and then click the API Keys (2) option on the right of the screen.


Once on the API Screen, you may need to click the add API key option if there are no existing API keys available. Once clicked, provide a name, select API+ user impersonation and copy the API key from the API key field. Please make sure you copy the entire key since it may extend to the right beyond the size of the box. If creating a new key, don’t forget to click the “Save API key” button!


2. Login to your LiveHelpNow account and go to Admin Panel->My Account->Integrations->Eventing API

A. Click on “Add Event”

B. Select “ChatOpened” event

C. Select “JSON” for Event Type

D. Select “POST” for Event Verb

3. In the HTTP Basic Authentication Username field enter your Nutshell User ID / Email address. Paste the API key you copied from Step #1 in the password field. No information is needed in the Headers fields.

4. Enter the following into the payload field:


"contact": {
"name": "$$$Name$$$",
"email": "$$$Email$$$"


Please Note: The $$$Name$$$ label in the Payload syntax above assumes you are collecting the chat user’s Name in the Pre-Chat Requested Information in LiveHelpNow mapped to “FullName” CRM Field.  

The $$$Email$$$ label in the Payload syntax above assumes you are collecting the chat user’s Full Name in the first input in the Pre-Chat Requested Information in LiveHelpNow mapped to “Email” CRM Field.  

These settings are located at Admin Panel->Chat System->Customization->Pre-chat requirements

In order to ensure data is pushed to Nutshell from all LiveHelpNow chat users, it is highly recommended you define the name and email address as required. This is done by selecting “yes” from the dropdown in the Required column for the email field in the Pre-Chat Requested Information settings.  


5. In the URL field, enter the following address:


6. Add an email address to the “Event Failed Notification(s)” field


7. Make sure the box next to Enabled is checked, and click Add Event to save.


Your saved event should look like this:




8. You’re all done! As your chat users start new chat sessions, you should now see the info provided from their Pre-Chat Questions in your Nutshell List under the People section!




See more LiveHelpNow live chat system integrations


Brought to you by LiveHelpNow

Captivate customers and outshine competitors with our easy to use, hard to resist customer service software suite.

Learn more

Get knowledge to your inbox

Sign up and be first to know about our blog posts!

About the author

Lauren Schneck

+Lauren Schneck is Director of Marketing Communications at LiveHelpNow, a customer service software company. You can contact Lauren directly at LS at livehelpnow "." com or via phone at 877-548-3001.

Do you like our posts? You might also like our product.

Give LiveHelpNow Help Desk Software a go free for 30 days.