GETTING STARTED
Introduction to SmartAssist
Glossary
SmartAssist Lifecycle Management
SmartAssist Setup Guide
Sign Up for SmartAssist
Release Notes
Current Version
Recent Updates
Previous Versions
Frequently Asked Questions (FAQ)

EXPERIENCE DESIGNERS
Flow Designer
Introduction
Create Experience Flows
Navigate the Flow Designer
Experience Flow Nodes
Introduction
Node Types
IVR Menu
IVR Digit Input
Conversational Input
Split
Check Agent Availability
Check Business Hours
Message Prompt
Run Automation
Agent Transfer
Connect to API
Go to Flow
Deflect to Chat
Script Task
Set Queue
End Flow
Waiting Experience
Conversation Automation
Testing Widget
Use Cases
Overview
Questions & Answers
Conversations

ADMINISTRATORS
Account Management
Switch Account
Invite Developers to an Account
Routing
Skills
Skill Groups
Queues
Hours of Operation
Default Flows
User Management
Users
Agent Groups
Agent Settings
Role Management
Agent Status
System Setup
Channels
Voice
Chat
Email
Limitations With Accounts Using AudioCodes
Agent Transfer
Surveys
Agent Forms
Dispositions
Language & Speech
Overview
Language Management
Voice Preferences
Hold Audio
Standard Responses
Handling Sensitive Data
Widgets
Utils
AgentAssist Settings
SearchAssist
Advanced Settings
Co-Browse Settings
Community WFM (Beta)
Automatic Conversation Summary (Beta)
Intelligent Agent Tools
Sensitive Data Masking
API Reference
API Setup
API List
Integrations
Genesys Voice Bot
Voice Automation - Integration with Amazon Connect
Voice Automation NiceCX (CX One) - SIP Integration
Talkdesk Voice Automation
Audit Report

AGENTS
Agent Console
Introduction
Conversation Tray
Incoming Interactions
Interacting with Customers
Additional Tools
My Dashboard

SUPERVISORS
Dashboard
Automation
Queues and Agents
Interactions
Intelligence
Monitor Queues, Agents, Interactions, and Service Levels
Manage Layout

BUSINESS USERS
Reports
Introduction
Reports List

Widgets

SmartAssist allows you to integrate external systems and pages into the Agent Console. Agents can use widgets from within custom Agent Console Layouts.

Note: For widgets to load properly within the agent console, you may need to set up permissions to allow “smartassist.kore.ai’ to access the application or page you want to integrate. 

Add a Widget

To Add a new external widget: 

  1. Go to Configurations > System Setup > Widgets.
  2. Click the External Widget tile.

  3. The External Widgets window opens. Click + New External Widget.

  4. The Add Widget window opens, and you can configure the following:
    1. The Widget Name by which to identify it later.
    2. The Widget Icon. Click the section to upload a file, or use drag-and-drop.
  5. If you want to remove an icon, click the Delete (bin) button on the right. You can re-upload an icon afterward as needed.

  6. The URL is the address of the system or webpage that you want to integrate as a widget. You can create a dynamic URL and select variables from a static list or based on custom variables that reside inside the meta-info of the conversation. Select parameters from the {} Variable drop-down. The available variables are Agent Id, Customer Email Id, Conversation Id, Agent First Name, Customer First Name, Customer Last Name, Customer phone Number, and Agent Last Name. You can also insert a custom variable of the type: {{context.metaInfo.<yourCustomVarName>}}.
  7. The Failure URL displays in case the intended page does not load. You can set the same variables as for the main URL above.

  8. Click Save to save the widget.

  9. Once saving the widget, a success message displays, and the widget is listed within the External Widgets window.

Edit a Widget

To edit an existing widget, find it in the list of External Widgets, then click on it. The configuration window opens, and you can edit the name, icon, URLs, or all.

Delete a Widget

To delete an existing widget, find it in the list of External Widgets, then click on it. Click the Delete (bin) button on the left of the bottom toolbar, then confirm your choice.

Note: When deleting a widget, all configurations are lost, and the widget is removed from the Agent Console. You cannot restore deleted widgets. Please proceed with caution.

Add a Widget to an Agent Console Layout

Once you save an external widget, you can add it to the Agent Console using the Manage Layout feature.

To add a widget to an Agent Console Layout, follow these steps:

  1. From within SmartAssist, click Manage Layout on the top toolbar.
  2. From the list of available layouts, select the one to which you want to add the widget and click the Edit (✐) icon next to it.

  3. On the Edit Layout screen, find the widget in the left-hand-side panel. Drag and drop it to the right-hand-side panel.

  4. Click Save. Once the widget is added, the integrated system or page will display within the widget as part of the selected Agent Console Layout. See what it looks like in the demo below.

Delete a Widget from an Agent Console Layout

 

To delete a widget from an Agent Console Layout, follow these steps: 

  1. From within any SmartAssist screen, click Manage Layout on the top toolbar.
  2. From the list of available layouts, select the one to which you want to add the widget and click the Edit (✐) icon next to it.
  3. On the Edit Layout screen, click More Options at the top of the widget, then select Delete.

Note: Deleting a widget from the Agent Console Layout only removes it from the agents’ view. The external widget configuration remains in place, and you can choose to integrate it again later.

Agent Desktop and External Widget Communication

A communication channel can be established between the Agent Desktop and External Widgets to enable data sharing.

Context Sharing from Internal to External Widgets:

Internal Widgets can send contextual data to an external widget as follows:

  1. Trigger an Event from the External Widget: The external widget triggers the following event:
    liveInteraction.postMessage(“getUserContext”, **args)
  2. Event Listener in the liveInteraction: liveInteraction has an event listener to receive the getUserContext event. Upon receiving this event, liveInteraction fetches the user context data.
  3. Data Transfer to the External Widget: After fetching the user context, liveInteraction sends this data back to the external widget. This is done using the following postMessage event:
    externalWidget.postMessage(“userContext”, data), where data is the user context information.

Text Transfer:

Agents can easily copy text from an external widget to the compose bar, reducing the effort of manually responding to customers. External widgets can send text to an internal widget. 

This can be enabled by introducing a method that allows the sender widget to copy a message in the compose bar on the Live Interaction Pane of the agent. This is established as follows:

  1. Trigger an Event from the External Widget: The external widget initiates the process by sending a postMessage event to liveInteraction. The external widget triggers the following event:
    liveInteraction.postMessage(“copyText”, *message, **args)
  2. Event Listener in liveInteraction: liveInteraction has an event listener to receive the copyText event. Upon receiving this event, liveInteraction processes the text contained in the payload.

    Note: Handling template formatting is the sender window’s responsibility.

  3. The received text is automatically populated in the compose bar on the Live Interaction Pane.

Widgets

SmartAssist allows you to integrate external systems and pages into the Agent Console. Agents can use widgets from within custom Agent Console Layouts.

Note: For widgets to load properly within the agent console, you may need to set up permissions to allow “smartassist.kore.ai’ to access the application or page you want to integrate. 

Add a Widget

To Add a new external widget: 

  1. Go to Configurations > System Setup > Widgets.
  2. Click the External Widget tile.

  3. The External Widgets window opens. Click + New External Widget.

  4. The Add Widget window opens, and you can configure the following:
    1. The Widget Name by which to identify it later.
    2. The Widget Icon. Click the section to upload a file, or use drag-and-drop.
  5. If you want to remove an icon, click the Delete (bin) button on the right. You can re-upload an icon afterward as needed.

  6. The URL is the address of the system or webpage that you want to integrate as a widget. You can create a dynamic URL and select variables from a static list or based on custom variables that reside inside the meta-info of the conversation. Select parameters from the {} Variable drop-down. The available variables are Agent Id, Customer Email Id, Conversation Id, Agent First Name, Customer First Name, Customer Last Name, Customer phone Number, and Agent Last Name. You can also insert a custom variable of the type: {{context.metaInfo.<yourCustomVarName>}}.
  7. The Failure URL displays in case the intended page does not load. You can set the same variables as for the main URL above.

  8. Click Save to save the widget.

  9. Once saving the widget, a success message displays, and the widget is listed within the External Widgets window.

Edit a Widget

To edit an existing widget, find it in the list of External Widgets, then click on it. The configuration window opens, and you can edit the name, icon, URLs, or all.

Delete a Widget

To delete an existing widget, find it in the list of External Widgets, then click on it. Click the Delete (bin) button on the left of the bottom toolbar, then confirm your choice.

Note: When deleting a widget, all configurations are lost, and the widget is removed from the Agent Console. You cannot restore deleted widgets. Please proceed with caution.

Add a Widget to an Agent Console Layout

Once you save an external widget, you can add it to the Agent Console using the Manage Layout feature.

To add a widget to an Agent Console Layout, follow these steps:

  1. From within SmartAssist, click Manage Layout on the top toolbar.
  2. From the list of available layouts, select the one to which you want to add the widget and click the Edit (✐) icon next to it.

  3. On the Edit Layout screen, find the widget in the left-hand-side panel. Drag and drop it to the right-hand-side panel.

  4. Click Save. Once the widget is added, the integrated system or page will display within the widget as part of the selected Agent Console Layout. See what it looks like in the demo below.

Delete a Widget from an Agent Console Layout

 

To delete a widget from an Agent Console Layout, follow these steps: 

  1. From within any SmartAssist screen, click Manage Layout on the top toolbar.
  2. From the list of available layouts, select the one to which you want to add the widget and click the Edit (✐) icon next to it.
  3. On the Edit Layout screen, click More Options at the top of the widget, then select Delete.

Note: Deleting a widget from the Agent Console Layout only removes it from the agents’ view. The external widget configuration remains in place, and you can choose to integrate it again later.

Agent Desktop and External Widget Communication

A communication channel can be established between the Agent Desktop and External Widgets to enable data sharing.

Context Sharing from Internal to External Widgets:

Internal Widgets can send contextual data to an external widget as follows:

  1. Trigger an Event from the External Widget: The external widget triggers the following event:
    liveInteraction.postMessage(“getUserContext”, **args)
  2. Event Listener in the liveInteraction: liveInteraction has an event listener to receive the getUserContext event. Upon receiving this event, liveInteraction fetches the user context data.
  3. Data Transfer to the External Widget: After fetching the user context, liveInteraction sends this data back to the external widget. This is done using the following postMessage event:
    externalWidget.postMessage(“userContext”, data), where data is the user context information.

Text Transfer:

Agents can easily copy text from an external widget to the compose bar, reducing the effort of manually responding to customers. External widgets can send text to an internal widget. 

This can be enabled by introducing a method that allows the sender widget to copy a message in the compose bar on the Live Interaction Pane of the agent. This is established as follows:

  1. Trigger an Event from the External Widget: The external widget initiates the process by sending a postMessage event to liveInteraction. The external widget triggers the following event:
    liveInteraction.postMessage(“copyText”, *message, **args)
  2. Event Listener in liveInteraction: liveInteraction has an event listener to receive the copyText event. Upon receiving this event, liveInteraction processes the text contained in the payload.

    Note: Handling template formatting is the sender window’s responsibility.

  3. The received text is automatically populated in the compose bar on the Live Interaction Pane.