Skip to main content
Skip table of contents

Agent Gadget Configurations

Following is the procedure to configure Agent Gadget:

  1. Navigate to <installation-dir>\hybrid-chat\core\tomcat\apache-tomcat-8.5.47\webapps\agent-gadget\assets\scripts directory
  2. Open config.json file with any text editor
  3. Save the file after configuration changes, clear browser cache and refresh /agent-gadget/ page

Configuration

Follow JSON Schema rules for changes in config.json  file. Following is a sample of this file:

config.json

CODE
{
    "ServerUrl": "https://docker-win.expertflow.com/bnp/chat",
    "SocketUrl": "https://docker-win.expertflow.com/bnp",
    "Mrd": "Chat",
    "loadSessionOnSilentMonitor": true,
    "sendUSDEvents": true,
    "standAloneAgents": false,
    "threadedView": true,
    "BotThresholds": {
        "t1": {
            "minScore": 0.8,
            "time": 60
        },
        "t2": {
            "minScore": 0.5,
            "time": 120
        },
        "t3": {
            "minScore": 0,
            "time": 180
        }
    },
    "queueStats": {
        "url": "https://docker-win.expertflow.com/bnp/database-connector",
        "mre_url": "https://docker-win.expertflow.com/bnp/mre",
        "delay": 5
    },
    "languages": "en:English,fr:French",
    "defaultLanguage": "en",
    "reconnectTime": "60",
    "acceptNotifDuration": 300000,
    "messageLimit": 500,
    "file_engine": {
        "url": "https://docker-win.expertflow.com/bnp/file-engine"
    },
    "enableCRMEvents": false,
    "recordsPerPage": 20,
    "webrtc": {
        "enabled": false,
        "url": "https://razaellahi.github.io/webrtc/"
    },
    "ENABLE_OUTBOUND_SMS": false,
    "DEFAULT_PREFIX_OUTBOUND": "+92",
    "HISTORY_ENABLED": true,
    "AUTO_LOAD_RECENT_ACTIVITIES": false,
    "HIDE_CHANNEL_IDENTITY": false,
    "ENABLE_BOT_SUGGESTION": false,
    "HANDRAISE_ENABLED": true,
    "BROWSER_NOTIF_LEVEL": "VERBOSE",
    "CLOSE_CHAT_DELAY": 300,
    "ENABLE_HYPERLINKS": true,
    "ENABLE_LOGS": true
}
Configuration VariablesDefault ValueExpected ValueLimitationsDescription
ServerUrl

https://localhost

or

https://Reverse_Proxy

string
Url of the chat-server for socket communication. Do not write /chat in end of this url
SocketUrlhttps://Reverse_Proxystring
This is a chat service URL. Only need to give Chat Server host machine FQDN here, used to establish a connection with the socket server.
MrdChatstring
This is the only Mrd at the moment, do not change it.
loadSessionOnSilentMonitortrueboolean
Only used when integrated in MS CRM or MS USD.  It is used to open screen pop-up
TransferToAgenttrueboolean
Not applicable
sendUSDEventstrueboolean
It is used to enable chat init and chat end events for Microsoft USD.
standAloneAgentsfalseboolean
Used for finesse / Umm agents.  In case of finesse agents it is set to false.
threadedViewtrueboolean

If set to false, agent and customer messages are shown on the same side. Default is true.

If set to true, all personal messages of the agent are right-aligned while the customer and other participant messages are left-aligned. 

ENABLE_BOT_SUGGESTION

trueboolean
If true, bot suggestions will be shown to the agent on the new customer message. Otherwise, all auto-response settings will also be disabled.
BotThresholds.t1.time15number

Value is in seconds

-1 means do not start timer.

Once message receives with score more than or equal to BotThresholds.t1.score, timer starts.

Message is sent after timer ends

BotThresholds.t1.minScore0.8numberValue should be less than 1

This is bot threshold

BotThresholds.t2.time30number

Value is in seconds

-1 means do not start timer.

Once message receives which score more than or equal to BotThresholds.t2.score and less than BotThresholds.t1.score, this timer starts.

Message is sent after timer ends

BotThresholds.t2.minScore0.6numberValue should be less than BotThresholds.t1.score

This is bot threshold

BotThresholds.t3.time60number

Value is in seconds

-1 means do not start timer.

Once message receives which score more than or equal to BotThresholds.t3.score and less than BotThresholds.t3.score, this timer starts.

Message is sent after timer ends

BotThresholds.t3.minScore0.5numberValue should be less than BotThresholds.t2.score

This is bot threshold

queueStats.url

https://localhost:8450

or 

https://<Reverse_Proxy>/database-connector

string
This is database-connector URL or FQDN
queueStats.mre_url

https://localhost:8095 

or

https://<Reverse_Proxy>/mre

string
MRE api URL or FQDN to fetch queue statistics for Supervisor Dashboard 
queueStats.delay5number
This is in seconds, data on queue stats dashboard is refreshed after every queueStats.delay seconds.
languagesen:English,fr:Frenchstring

List of supported languages

To add a new language, add it as a key:value pair, such as fr:French for adding French language. The key is following ISO 639.1.

A language is added as a key-value pair, where the key is a 2 character code and the language name is the value. Pairs are separated by comma(,) and a key value pair is defined as Key:Value.

defaultLanguageenstring
Default language is used when agent has selected no language
reconnectTime60number

Time in seconds, the gadget should wait before calling the logout event in case of network or server disconnection.

All controls on agent interface will be disabled and agent will be logged out from gadget when this time expires.

acceptNotifDuration30number
This is the timeout in seconds to accept a new chat request on the agent gadget.
messageLimit500number
character limit for message, it can be between 1 & 2000
file_engine.url

https://localhost:8495

or

https://<Reverse_Proxy>/file-engine

string
File Engine URL or FQDN to upload / download attachments
enableCRMEventsfalseboolean
If agent-gadget is embedded in MS CRM channel integration framework that set true. Default value is false
recordsPerPage20number
It is the number of messages that will be loaded at a time when the history button is clicked.
HISTORY_ENABLEDtrue/falseboolean
It allows the agent to fetch history during a conversation. The default value is true
AUTO_LOAD_RECENT_ACTIVITIEStrue/falseboolean
It enables us to load some conversation history by default on chat accept by the agent. The default value is false.
HIDE_CHANNEL_IDENTITYtrue/falseboolean
If set to true, the customer's phone number will not be visible to the agent.
HANDRAISE_ENABLEDtrue/falseboolean
It enables/disables hand-raise functionality for the agent.
BROWSER_NOTIF_LEVELminimal/moderate/verbose

string


  • minimal - only new request notifications are shown.
  • moderate - also shows participant's join/leave notifications along with new request notifications.
  • verbose - shows all notifications

Default value is minimal.

CLOSE_CHAT_DELAY30

Once the customer leaves the chat, the chat will remain on the agent interface until CLOSE_CHAT_DELAY expires. The default value is 30 (sec), after these 30 seconds, the chat will end automatically. Set it to -1 to make conversation stay on the agent interface forever. If the value is set to 0, the chat ends immediately. The agent can also choose to close the chat himself by clicking the 'X' button.
ENABLE_HYPERLINKStrue/falseboolean
By enabling hyperlinks a user can click on a referral link and jump to another page/document. If set to false, hyperlinks won't work, the default value is true.
ENABLE_OUTBOUND_SMStrue/falseboolean
Not applicable in windows release
DEFAULT_PREFIX_OUTBOUND


Not applicable in windows release
ENABLE_LOGStrue/falseboolean


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.