Live Chat Integration for Kibo eCommerce

Current Version: 1.0.0
Install: Kibo eCommerce App Marketplace

Talk to your customers from anywhere with Live Chat by Volusion. This simple theme integration give customers on your Kibo eCommerce site a way to communicate with your sales and support representatives in real-time, without leaving your site. Your agents manage all chats through the completely web-based Volusion Live Chat portal, which supports multiple connections, logs all chat data, and provides analytics you can use to evaluate your support efforts.

Integration Features

Get a Live Chat Account

You must set up a Live Chat account to access the web portal your agents use to chat with customers. Go to volusion.com/ecommerce-live-chat-software and select the plan that is right for your business to start chatting.

Add Live Chat to Your Theme

  1. Log in to the Volusion Live Chat admin portal.
  2. Go to Settings and select Get the Code.
  3. Copy the code snippet or email it to your theme developer.
  4. In your theme code, create a JavaScript file for the code snippet. For example, if your theme is based on the Kibo eCommerce Core theme, you can add the file: scripts/modules/livechat.js
  5. (Optional) Add any custom code to the JavaScript below the line:
    	/* Place your Volusion Live Chat JS API code below */
    For example, you can include your own logo in the Live Chat window.
  6. Use the require_script Hypr tag to include the file in the templates for any pages from which you want shoppers to be able to access chat:
    	{% require_script “modules/livechat” %}
    For example, if you want Live Chat accessible from your Home, Category, and Product pages, add the above line to the following templates: home.hypr, category.hypr, parent-category.hypr, and product.hypr
  7. Build your updated theme, upload it to Dev Center, and apply it to your site to begin using Live Chat functionality.

Tip: Refer to the Theme Asset Management topic for more information about building and uploading themes.

  1. In your livechat.js file, find the comment:
    	/* Place your Volusion Live Chat JS API code below */
  2. Add the following lines of script below the comment:
    	VolusionChat.setHeaderLogo('INSERTURLHERE');
    	VolusionChatChat.setHeaderLogo('INSERTURLHERE');
  3. Replace INSERTURLHERE with the URL for your logo. You can get this URL by uploading the image to the File Manager in Admin, clicking the three dots next to the image, and selecting Get Url.

Note: The dimensions of the logo image must be 330px by 50px.

Test Your Integration

  1. From Admin, go to Site Builder and view your Staged site. You should see the default green Chat button floating on the side of your storefront.
    Note: If the green button you see is labeled Help instead of Chat, it may indicate that all chat agents (including you) are offline. Make sure you're logged into Live Chat as an agent, and that your status is set to Available.
  2. Click the Chat button to begin a test chat. At this point, there should be two windows open - one on your storefront and one in Live Chat.
  3. Test the customer chat window and the agent chat window by entering a message and a response.
  4. Once you are satisfied with the look and feel of your Live Chat interface, you can publish your changes to your live site.

Configure Live Chat

Live Chat includes a number of features you can use to better connect with your customers. The following functionality is all accessed from the Volusion Live Chat admin portal.

Tip: A list of all possible Volusion Live Chat Settings is available from the Volusion Knowledge Base.

Add Agents

When you sign up with Live Chat, you receive one agent that is assigned to the email address you signed up with. If you purchase the Professional Plan, you can add agents as follows:

  1. Go to Settings and select Agent Settings.
  2. On the Chat Agents tab, click Add Chat Agent.
  3. Select a chat system from the Chat System menu (Recommended: Volusion Live Chat Portal).
  4. Enter the Account Email associated with the new agent.
  5. Choose an Alias (the name that will appear to customers for this agent).
  6. Set a maximum number of chats that the agent can have open at one time. The default is 4. Note: The max setting for a specific agent overrides the global Maximum chats per Agent setting for all agents on the Chat Assignment tab.
  7. Click Save.

Your new agent is now set up and ready to chat! The agent will receive an email with instructions for logging in.

Note: The maximum number of agents is 4.

Create Widgets

Widgets in Live Chat are portals to different departments within your company. For example, you can have separate widgets for Sales and Support or separate widgets for support in different languages. Live Chat users on the Professional Plan can configure up to four widgets, and you can enable agents to transfer chats from one widget to another.

  1. Widgets appear directly under the Volusion logo in the Live Chat admin portal. Select a widget and click Create a new Widget to configure additional widgets.
  2. Go to Settings and select the Options tab.
  3. Select the widget to configure options for it. For example, you can:
    • Show agents social media profiles for the shopper.
    • Allow agents and shoppers to exchange files.
    • Configure thank you notes to send to users when a chat ends.
    • Allow shoppers to rate agents at the end of a chat.
    • Specify an amount of time to wait before closing an idle chat.

Manage Chat Assignment

The Chat Assignment tab under Settings > Agent Settings includes a number of options you can use to manage how chats are assigned across all agents. For example, you can:

Configure Response Shortcuts

You can create pre-set responses to save agents from re-typing common replies every time they engage in a chat:

  1. Go to Settings and select Agent Settings.
  2. Go to the Shortcuts tab.
  3. Click Add New Shortcut.
  4. In the Command field, enter the command word that will trigger the shortcut.
  5. In the Message field, enter the full message that the shortcut will generate. For example, you might enter "How" as the Command, and "How may I help you today?" as the Message.
  6. Click Save Changes.

Agents can type shortcuts into the chat window in a few different ways:

Tip: Typing a shortcut command without a slash will display a shortcut selector above the text. You do not have to select the shortcut (in cases when you want to use the actual word and not the command).

Enable Proactive Chat

If you enable proactive chat, Live Chat will automatically invite shoppers to chat with you after they've been on your site for a designated amount of time. You can also set other conditions that trigger the Proactive Chat feature, such as time of day, the number of pages a shopper has visited on your site, or the amount of time they've been browsing:

  1. Go to Settings and select Proactive Chat.
  2. Check the box to Enable Proactive Chat When a Chat Agent is Online.
  3. Set a time to delay re-engaging the same customer if they decline the proactive chat invite.
  4. Under Create and Edit Proactive Triggers, you can set conditions that will cause the proactive chat to appear or not appear to shoppers. Proactive chats are sorted by the message that appears to the user when the chat begins, and conditions at the bottom of the list are checked before conditions higher in the list. If you set a global or catch-all rule, make sure it appears at the top of the list so individual sub-page conditions will function when appropriate.
  5. Click Add proactive chat configuration to create a new message and configure triggers for the message. Click Edit to modify the triggers for an existing configuration.
  6. When you're finished, click Save Changes.

Customize the Appearance of Live Chat on Your Site

Go to Settings > Style to customize the appearance of Live Chat functionality on your site. For example, you can:

Use Live Chat

The following sections describe ways you and your agents interact with Live Chat on a daily basis.

Chat Portal

Agents interact with customers through the Chat Portal, which is accessible from the Live Chat admin portal or at https://volusionchat.appspot.com/client. The main page of the Chat Portal shows each agent their current stats, their Live Chat status (Available, Paused, or Offline), and offers easy access to keyboard shortcuts, other available agents, and additional Settings each agent can configure for their personal chat interface.

Agents can click the chat status bar in the bottom left corner of the screen to switch to the Live Chat Monitor, which shows each agent their total chats in progress, how many notifications of new chats they have received, and how many visitors are waiting in the queue.

What Your Agents See

When Live Chat agents engage with a customer, a Visitors panel appears on the left side of the Chat Portal and shows all chats currently in progress. When an agent selects a chat, the Live Chat Monitor on the right side of the screen is replaced with details about the shopper details, including their location, the platform or browser they're using, the number of times they've visited your site and/or engaged in a chat, and the URL they initiated the current chat from. The chat itself appears directly below the shopper details.

View Chat Logs

If you want to view the time, details, and transcript for a specific chat, you can do so from the Live Chat admin portal:

  1. Select Logs from the left-hand navigation.
  2. Locate the chat on the Chat Logs tab. You can find a chat by email address or by date and time.
  3. Click the Chat link in the far left column to view details.
  4. (Optional) Go to the Export Logs tab to view monthly export reports or to manually export chat logs to a CSV file.

Message and Chat Transcript Delivery Preferences

With the Live Chat Email integration, you can have chat transcripts and missed chats sent directly to your preferred help desk or CRM platform.

  1. Go to Settings and click Integrations.
  2. Enter the email address(es) you'd like to forward each transcript or offline message to. Be sure to separate multiple addresses with a comma.
  3. Use the Configure Integration section to further specify what transcript or message data is sent, and under what conditions.
  4. Click Save Changes.