This documentation supports the 21.3 and consecutive patch versions of Live Chat.To view an earlier version, select the version from the Product version menu.

Enabling the system and typing notifications


As an administrator, you can enable system notifications and typing notifications that are displayed to the end users in Self Service Portal and the support agents. 

Important

The following messages are not localized:

"websocket.session-timeout.title": "Your session has ended.",
"websocket.session-timeout.content": "Refresh your browser to send and receive messages.",
"websocket.msg-status.not-delivered": "Not delivered",
"websocket.network-connection-error.title": "Network connection error.",
"websocket.network-connection-error.content": "Refresh your browser to connect to send and receive messages."

If you want to localize these message, see To modify the default messages or add localized system messages in Self Self Portal



System notifications

You can configure the following system notifications for the end users:

  • When an invitee joins a chat session. 
    By default, a notification is not displayed when an invitee joins in Monitor mode. If an invitee joins a chat session in Participant mode, the system message is displayed by default.  
  • When an agent is disconnected from a chat session.
    A notification is displayed when an agent is disconnected from a chat session and does not join within the timeout period. The default timeout period is 60 seconds and is configurable. 


Typing notifications

You can configure the following typing notifications for the agents and end users.

  • If an agent and the end user are on different BMC Virtual Chat servers, by default, the notifications are displayed. As an administrator, you can disable the notifications. 
  • If an agent and the end user are on the same BMC Virtual Chat server, by default, the notifications are displayed and cannot be disabled. 


To configure the system and typing notifications

  1. From the IT Home page, select Virtual Agent > Virtual Chat Administration Console.
  2. Select Self Service Portal Configuration
  3. From the list of entries, select System Configuration and click Modify.
  4. In the Configuration section, click one of the following options: 
    • If an overlay exists, click Open Overlay
    • If an overlay does not exist, click Create Overlay
  5. Set the following parameter values:

    Parameter

    Description and valid values

    Example

    showMonitorJoinedChatMs

    Specifies whether you want to display a message when an invitee joins a chat session.

    • Default value) true—To display the system message.
    • false—To not to display the system message

    <showMonitorJoinedChatMsg>
    true
    </showMonitorJoinedChatMsg>

     

    agentUnloadTimeoutInSec

    Specifies the timeout period in seconds within which the agent should reconnect to a chat session. The following system notification is displayed to the end users if the agent does not connect to the chat session after this timeout period: Agent name was disconnected from this chat session. An agent will connect shortly.

    • (Default value) 60
    • Valid range—30 seconds to 300 seconds

    <agentUnloadTimeoutInSec>
    60
    </agentUnloadTimeoutInSec>

    releaseAssignedChatsOnAgentDisconnect

    Specifies whether the chat session should be released to the support queue after an agent is disconnected. The following system notification is displayed to the end users after the chat session is released in the queue: {{code language="none"}}
    The chat is released back to the support queue. An agent will connect shortly.
    {{/code}}

    • (Default value) true—To display the system message.
    • false—To not to display the system message.

    <releaseAssignedChatsOnAgentDisconnect>
    true
    </releaseAssignedChatsOnAgentDisconnect>

    sendTypingUpdateToOtherCNSNodes

    Specifies whether you want to enable or disable typing notifications when the agent and end user are on different BMC Virtual Chat servers.

    • (Default value) true—To display the typing notifications.
    • false—To not to display the typing notifications.

    Important: If an agent and the end user are on the same BMC Virtual Chat server, by default, the notifications are always displayed and cannot be disabled.


    <sendTypingUpdateToOtherCNSNodes>
    true
    </sendTypingUpdateToOtherCNSNodes>

    ignoreCompanyForQueuePosition

    Specifies whether you want to include the Company field value when the system calculates the chat's queue position. Use this setting if you have a common group of support agents for a multi-company queue.

    • Default value: false

    Example: 

    There are two companies in your system - Apex Global and Petramco that are supported by a common group of support agents. The current queue has 25 users who belong to these companies, out of which 4 are from Apex Global. The queue position displayed to a new user from Apex Global will be: 

    • If the value is set to True, the queue position is 26.
    • If the value if set to False, the queue position is 5. 

    <ignoreCompanyForQueuePosition>
    false
    </ignoreCompanyForQueuePosition>

  6. Save the settings. 
  7. In the Self Service Portal Configuration screen, click Apply.
  8. Click Refresh Servlets.

The following image shows the System Configuration entry: 

Invitee notification setting.png


To modify the default messages or add localized system messages in Self Self Portal

  1. From the IT Home page, select Virtual Agent > Virtual Chat Administration Console.
  2. Select Self Service Portal Configuration
  3. Modify the default system messages:
    1. From the list of entries, select Interfaces English and click Modify.
    2. In the Configuration section, click one of the following options: 
    3. If an overlay exists, click Open Overlay
    4. If an overlay does not exist, click Create Overlay
    5. Select the message that you want to customize from the msg_message title tag and replace the default text with the modified message. 

      The following image shows an example of customizing the typing notifications:
      Custom_system_messages.png

  4. Save the changes. 
  5. If you want to localize the customize message, repeat these steps for each Interface locale entry that you want to use. 
  6. Click Refresh Servlets to apply the changes. 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*