Set Up a Simplified Digital Live Chat for a Virtual Agent

You can use a digital Live Chat Agents and contacts interact on a real-time basis channel with any supported text virtual agent. A full implementation of a Live Chat channel includes some features that may not be needed when testing a text virtual agent or for a simplified Digital Experience implementation. The instructions on this page allow you to set up a Live Chat channel without these features. This results in a simplified digital Live Chat experience.

You can use the simplified Live Chat setup with virtual agent implementations or for testing implementations that will be used with live agents. However, it's not a complete setup and some functionality is lost through the simplification. If the channel will be used by both virtual and live agents and you need a full implementation of the Live Chat channel, contact your CXone Account Representative.

Differences in the Simplified Setup

A complete setup of the Live Chat window that appears on your website has two features that you may want to change or disable when using it with a virtual agent. The features are necessary when using Live Chat with live agents. However, when using Live Chat with virtual agents, they're not needed because the virtual agent is always available and ready to respond immediately. The features are: 

• A dot showing online (green) or offline (red) status to indicate agent availability. You can configure this to always show green.

  View image

  

• An overlay that can be used to display messages to contacts. Often, this is used to let contacts know that an agent will respond soon. You can disable this if you don't need to display messages to contacts who are interacting with virtual agents.

  View image

  

If conversations on this channel will be escalated to live agents, these features are recommended. They cannot be disabled during the virtual agent portion of the interaction and later dynamically re-enabled for the live agent. They must be on or off for the entire interaction.

In addition to the two features already mentioned, the simplified setup affects reporting on the Live Chat channel. A complete Live Chat setup includes the creation of a pseudo agent employee account in CXone. The account is associated with the channel but not with a live agent. It allows CXone to track Digital Experience information associated with the pseudo agent account for reporting purposes. The simplified Live Channel setup does not include a pseudo agent account by default, so the reporting information won't be available. You can set up a pseudo agent account if you need this information.

Complete the steps on this page in addition to setting up the integration of your text virtual agent in Virtual Agent Hub.

Prerequisites

Before you can set up a digital live chat channel, you must:

• Have Digital Experience set up and configured in your tenant High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment.
• Use a CXone employee profile with the Digital Engagement attribute.
• Have a digital Studio script created and ready to use with the new channel. This could be the same script that's configured to work with your virtual agent integration.

Set Up a Live Chat Channel

After confirming that the prerequisites have been met, you can set up the Live Chat channel. You can do this in the CXone ACD application. You need to: 

1. Add the live chat channel.
2. Create a digital ACD skill to use for this channel. CXone requires ACD skills for all points of contact, including those for use with virtual agents.
3. Configure the digital point of contact for the Live Chat channel to use the existing digital script and the digital skill you created.
4. Customize the appearance of the channel's chat pop-up window.

Make a Live Chat Channel Available 24/7

Removing the online indicator dot from one channel does not impact the availability of the dot in other Live Chat channels A way for contacts to interact with agents or bots. A channel can be voice, email, chat, social media, and so on.. After you disable the online indicator dot for this channel, it cannot be dynamically re-enabled. To re-enable the feature, you must remove the line of code that you add in the following steps.

1. In CXone, click the app selector and select ACD.
2. Go to Digital > Points of Contact Digital.
3. Click Chat in the list of channel types at the top of the page.

4. On the My Channels page, click Initialization & Test for the Live Chat channel you want to modify.

   View image

   
5. Copy the JavaScript code from theInitialization & Test page.

6. Add the copied JavaScript code to your website. On any page where you want this chat channel to be available, paste the copied JavaScript code into the page header. Keep the web page open in your website editor.

7. Copy the following line of JavaScript from the help page:

   brandembassy('enableChatAlwaysOnline');

8. In your website editor, paste the line of JavaScript you copied in the preceding step just above the </script> tag of the code you added from the Initialization & Test page. The following image shows where to paste the code:

   View image

   

   Learn more about this feature and other ways you can customize your digital chat channels on the Customize Chat Channels Using JavaScript page.

9. Save your changes.
10. Open the modified web page in a browser window. Verify that the online indicator dot is always green. You can also verify that the message to contacts does not appear in the chat window.

Disable the Message Overlay

Disabling the message overlay removes the ability to display messages to a customer after they're in queue. The overlay can be used to display messages to the contact for things such as estimated wait time, their current position in the queue, and so on.

Removing the message overlay from this channel A way for contacts to interact with agents or bots. A channel can be voice, email, chat, social media, and so on. does not impact the availability of the message overlay in other Live Chat channels. After you disable the message overlay for this channel A way for contacts to interact with agents or bots. A channel can be voice, email, chat, social media, and so on., it cannot be dynamically re-enabled. To re-enable the message overlay, you must remove the line of code that you add in the following steps.

1. In CXone, click the app selector and select ACD.
2. Go to Digital > Points of Contact Digital.
3. Click Chat in the list of channel types at the top of the page.
4. On the My Channels page, click Customization for the Live Chat channel you want to modify.

5. Copy the following line of code:

   [data-selector="ACTIVITY_BAR"] {display: none !important}

6. Paste the copied code into the Custom CSS field under Customization (CSS and JS).
7. Click Save.

Verify JSON with the Digital Experience Mirror Tool

The JSON mirror tool allows you to verify the JSON for digital chat-based channels, such as Live Chat Agents and contacts interact on a real-time basis. It does this by processing JSON you paste into the tool's window. If the JSON is properly formatted and contains all the required parameters, the script displays the output based on your JSON.

The JSON mirror tool consists of a custom script and a digital chat-based channel that's created specifically to use with the tool. The script is designed only to verify JSON that's pasted into the chat window. It doesn't support interactions with contacts.

You can use the JSON mirror tool in one of two ways: 

• Use the tool set up by NICE CXone. This tool uses a Digital Live Chat channel, but it can verify JSON for any digital channel. You can find the tool at the following URL: 

  https://vah-client-app.s3.us-west-2.amazonaws.com/dfo/dfo-mirror.html

• Set up a mirror tool on your own system. You can use your own Live Chat or other digital channel and the JSON mirror tool custom script that NICE CXone provides.

Set Up the JSON Mirror Tool

1. Download the Digital Experiencemirror tool script and import it into Studio.
2. Add a digital Live Chat channel in CXone. You don't need to configure routing or queues for the channel.
3. Configure the channel to use the mirror tool script and a digital ACD skill Used to automate delivery of interactions based on agent skills, abilities, and knowledge. You can use any digital ACD skill with the mirror tool, but ensure that the one you choose doesn't affect your organization's reporting.
4. Create a webpage to use with the tool. This is the page that will hold the chat window used with the mirror tool. It doesn't have to have any other content.
5. Enable and initialize the channel. You don't need to customize the JavaScript code that you add to the webpage. You may be able to do this on your local computer or you may need to upload the page to a web server.
6. Open the webpage in a browser.
7. If prompted, enter a name into the Your name field on the chat window and click Begin Conversation.

8. Paste the following sample JSON into the message field, then press Enter to send a test message.

   {
    "prompts": [{ 
      "mediaSpecificObject": {  
   	"dfoMessage": {  
   	  "messageContent": {	
   		"type": "PLUGIN",	 
   		"payload": {	
   			"elements": [{	  
   				"id": "bf2521f4-5e85-413f-b6ed-815d1c3905f0",
   	   			"type": "FILE",	   
   				"filename": "photo.jpg",	  
   				"url": "https://www.nice.com/-/media/niceincontact/layout/nice-logo-web-header/nice-web-logo.ashx",	   
   				"mimeType": "image/jpeg"	   
   				}	 
   			   ]	   
   			 } 	  
   			}	
   		  }	
   		}  
   	 } 
   	]
   }

9. After the message sends, you should receive the NICE CXone company logo as a response in the chat window, as shown in the following image.

   View image

   

Use the JSON Mirror Tool

1. In a web browser, go to the URL of the page that holds the Live Chat window for the mirror tool.
2. Click the Live Chat window.
3. If prompted, enter a name and click Send.

4. Paste a JSON string into the message field in the chat window and press Enter to send it. The Digital Experience mirror script connected to the chat window sends the JSON to Digital Experience, which validates the JSON and replies. The reply indicates the results of the validation:

   • Valid: The reply is output that looks as you expected it to.
   • Invalid: The reply is an error message or output that doesn't look as you expected it to.