Jump to: navigation, search

chat.emojis-business-attribute

Section: interaction-workspace
Default Value:
Valid Values: Valid Name of Business Attribute.
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

Specify Name of Business Attribute contained Emojis definition.

gui.emoji-font-name

Section: interaction-workspace
Default Value: Segoe UI
Valid Values: A valid name of a font available on the agent workstation.
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

Specifies the font to be used to represent emoji symbols in chat interactions. The default Workspace font does not support all emojis.

chat.emojis-business-attribute

Section: interaction-workspace
Default Value:
Valid Values: Valid Name of Business Attribute.
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

Specify Name of Business Attribute contained Emojis definition.

chat.show-attachment-image-thumbnail

Section: interaction-workspace
Default Value: never
Valid Values: A value from the following list: never, always, online, history
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

Specifies whether to display the icon of an attached image file in chat transcript as image thumbnail (or as generic file) in the online session, the interaction history, or both.

chat.attachment-download-timeout

Section: interaction-workspace
Default Value: 20
Valid Values: An integer value between -1 and 3600.
Changes Take Effect: Immediately.


Defines the maximum duration, in seconds, of the download of an attachment. The value -1 means that there is no maximum time.

chat.max-attachments-files

Section: interaction-workspace
Default Value: 0
Valid Values: Any valid positive integer between 0 and 100. 0 means no limits.
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

The total maximum number of files that agents can attach to chat interaction. An error message is displayed to the agent if the total number of attached files exceeds this value. The value 0 means that there is no restriction.

chat.max-attachments-size

Section: interaction-workspace
Default Value: 0
Valid Values: Any valid positive integer between 0 and 1000. 0 means no maximum.
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

The total maximum number of megabytes of files that agents can attach to chat interaction. An error message is displayed to the agent if the total number of megabytes for all attached files exceeds this value. The value 0 means that there is no restriction.

chat.max-file-size

Section: interaction-workspace
Default Value: 0
Valid Values: Any valid positive integer between 0 and 1000000. 0 means no maximum.
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

The maximum file size in kilobytes that agents can attach to chat interaction. An error message is displayed to the agent if the file size exceeds this value. The value 0 means that there is no restriction.

general.writable-downloaded-attachment-file-types

Section: interaction-workspace
Default Value: No default value
Valid Values: A comma separated list of valid file extensions, such as xlsx, png, and so on.
Changes Take Effect: At next attachment download.
Introduced: 8.5.118.10

Specifies the list of attachment file types that when they are opened are writable on the hard drive of the agent workstation once they are downloaded from UCS.

chat.show-attachment-image-thumbnail

Section: interaction-workspace
Default Value: never
Valid Values: A value from the following list: never, always, online, history
Changes Take Effect: At the next interaction.
Introduced: 8.5.115.17

Specifies whether to display the icon of an attached image file in chat transcript as image thumbnail (or as generic file) in the online session, the interaction history, or both.

intercommunication.chat.queue

Section: interaction-workspace
Default Value:
Valid Values: Name of a valid Script object of type InteractionQueue
Changes Take Effect: At the next interaction.


Specifies the name of the Interaction Queue that is used by the 'routing based' feature for Chat. The following attached data are added by Interaction Worskpace: IW_RoutingBasedOriginalEmployeeId,IW_RoutingBasedTargetId,IW_RoutingBasedTargetType,IW_RoutingBasedRequestType.

intercommunication.chat.conference.invite-timeout

Section: interaction-workspace
Default Value: 30
Valid Values: from 30 to MAXINT
Changes Take Effect: At the next interaction.


Specifies the time-out interval for a chat conference or chat consultation invitation to a skill, agent group, or interaction queue.

transcript-save-notices

Section: settings
Default Value: selective
Valid Values: all, none, selective, selective2
Changes Take Effect: Immediately


Specifies which notifications are saved in the transcript in the UCS database.

  • all: All notifications are saved in the transcript.
  • none: No notifications are saved in the transcript.
  • selective: All notifications except typing notifications (USER_TYPING_ON and USER_TYPING_OFF) and idle control notifications (IDLE_CONTROL_ALERT and IDLE_CONTROL_CLOSE) are saved in the transcript.
  • selective2: All notifications except typing notifications (USER_TYPING_ON and USER_TYPING_OFF) are saved in the transcript.

keyboard.shortcut.interaction.chat.hold

Section: interaction-workspace
Default Value: No default value
Valid Values: The name of a key or a key combination that begins with one of the following modifier key names: Ctrl, Shift, and Alt, and ends with a character key. Separate the modifier key name from the character key with the '+' character.
Changes Take Effect: When the application is started or restarted.
Introduced: 8.5.128.07

The combination of keys that can be used as a keyboard shortcut to place a chat on hold. For example: F1, Ctrl+Alt+V, Ctrl+Shift+Alt+V.

chat.on-hold-queue

Section: interaction-workspace
Default Value: No default value
Valid Values: Any valid Script name of type 'Interaction Queue'.
Changes Take Effect: At the next attempt to put a chat in a queue.
Introduced: 8.5.128.07

Specifies the Interaction Queue where the chat interaction is placed when the agent clicks Place chat on hold. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

interaction.disposition.is-mandatory

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately.


Specify whether it is mandatory for the agent to set a disposition code before Marking Done an interaction. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.auto-mark-done-non-owner-agent.timer

Section: interaction-workspace
Default Value: 0
Valid Values: 0 to MAXINT
Changes Take Effect: Immediately
Dependencies: interaction.disposition.is-mandatory, chat.auto-mark-done-non-owner-agent
Introduced: 8.5.128.07
Related Options: chat.auto-mark-done-non-owner-agent, chat.auto-mark-done-owner-agent.timer

Specifies the time, in seconds, before a chat interaction auto closes if the agent is not the owner (not the last agent remaining connected to the interaction) of the chat interaction; this includes chat consultation agents and supervisors who are monitoring or coaching the chat interaction.

chat.auto-mark-done-non-owner-agent

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Dependencies: interaction.disposition.is-mandatory
Introduced: 8.5.128.07
Related Options: chat.auto-mark-done-owner-agent, chat.auto-mark-done-non-owner-agent.timer

Specifies whether chat interactions are automatically closed and marked done when the contact disconnects if the agent is not the owner (not the last agent remaining connected to the interaction) of the chat interaction; this includes chat consultation agents and supervisors who are monitoring or coaching the chat interaction.

chat.auto-mark-done-owner-agent.timer

Section: interaction-workspace
Default Value: 0
Valid Values: 0 to MAXINT
Changes Take Effect: Immediately
Dependencies: interaction.disposition.is-mandatory, chat.auto-mark-done-owner-agent
Introduced: 8.5.128.07
Related Options: chat.auto-mark-done-owner-agent, chat.auto-mark-done-non-owner-agent.timer

Specifies the time, in seconds, before a chat interaction auto closes if the agent is the owner (the last agent remaining connected to the interaction) of the chat interaction.

chat.auto-mark-done-owner-agent

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Dependencies: interaction.disposition.is-mandatory
Introduced: 8.5.128.07
Related Options: chat.auto-mark-done-non-owner-agent, chat.auto-mark-done-owner-agent.timer

Specifies whether chat interactions are automatically closed and marked done when the contact disconnects if the agent is the owner (the last agent remaining connected to the interaction) of the chat interaction.

chat.transcript-message-text-direction

Section: interaction-workspace
Default Value: ltr
Valid Values: ltr or rtl
Changes Take Effect: At the next interaction.
Introduced: 8.5.140.08
Related Options: accessibility.visual-impairment-profile, chat.simple-transcript

Specifies whether messages in the chat transcript are displayed with a left-to-right (default) or a right-to-left reading layout. Use this option for chat interactions where contacts are using a right-to-left reading language. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy. This option has no effect if the value of the accessibility.visual-impairment-profile option and/or the value of the chat.simple-transcript is set to true.

contact.history.filters-<attribute>

Section: interaction-workspace
Default Value:
Valid Values: In the key, a valid searchable interaction attribute name. In the value, a comma-separated list of strings applicable to the specified interaction attribute. Use the $All$ and $Other$ keywords to enable filtering on "all" or "other" values for this attribute.
Changes Take Effect: At the next contact search.
Modified: 8.5.104.15

This option can be used as a template to specify an interaction attribute name (in a key) and the associated values (in a value) that is used to automatically filter any list of interactions displayed in Contact History, My History, and Interaction Search views. Refer to Managing Contacts for more information. In a key, a valid searchable interaction attribute name. In the value, a comma-separated list of strings applicable to the specified interaction attribute. Use the $All$ and $Other$ keywords to enable filtering on "all" or "other" values for this attribute.

chat.transcript-enable-history-filters

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: At the next interaction.
Introduced: 8.5.132.05

Specifies that the value specified for the contact.history.filters-<attribute> option is used to filter the history-based part of the chat transcript.

chat.rich-media-widget-width

Section: interaction-workspace
Default Value: 300
Valid Values: An integer value between 100 and 500.
Changes Take Effect: At the next interaction.
Introduced: 8.5.150.06

Specifies the width, in pixels, of Rich Media in a chat interaction. The value of this option affects the minimum width of the Chat transcript view.

chat.historical.maximum-age

Section: interaction-workspace
Default Value: 0
Valid Values: 0 or any positive integer.
Changes Take Effect: At the next interaction.
Introduced: 8.5.122.08

Specifies the number of days of previous chat sessions with the current contact are to be displayed in the Chat interaction view before the current chat session. The value 0 means that no previous chat sessions are displayed. A maximum of 3000 messages can be displayed.

chat.auto-answer.enable-reject

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: At the next interaction.
Introduced: 8.5.105.12

Specifies whether the Reject button is available in the interaction notification when the value of chat.auto-answer is set to true and the value of chat.auto-answer.timer is greater than 0. The privilege to reject interactions must be granted. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.auto-answer.timer

Section: interaction-workspace
Default Value: 0
Valid Values: Any integer greater than or equal to 0
Changes Take Effect: At the next interaction.
Introduced: 8.5.105.12

Specifies the time, in seconds, after which an incoming interaction is automatically answered if the value of chat.auto-answer is set to true. If the value 0 is specified, interactions are immediately auto-answered. If any positive integer value is specified, then an interaction notification is displayed to the agent and a timer counts down the seconds until the interactions is auto-answered. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.auto-answer

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: At the next interaction.


Specifies whether a chat interaction is automatically accepted and joined when a Interaction Server Invite event is received. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

display-format.chat-customer-name

Section: interaction-workspace
Default Value: $Contact.FirstName$ $Contact.LastName$|$Party.DisplayName$
Valid Values: A string that contains a compilation of characters and field codes from the following list: $ChatCustomer.Nickname$, $Contact.X$, $AttachedData.Y$ (X: name of contact attribute, Y: attached data key name)
Changes Take Effect: Immediately.
Introduced: 8.5.145.06

Specifies the display format of the party name using a string that can contain regular characters as well as the following field codes: $ChatCustomer.Nickname$, $Contact.X$, $AttachedData.Y$, where X is the name of contact attribute and Y is the attached data key name. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

display-format.chat-agent-name

Section: interaction-workspace
Default Value: $ChatAgent.FullName$|$ChatAgent.Nickname$|$ChatAgent.UserName$
Valid Values: A string that contains a compilation of characters and field codes from the following list: $ChatAgent.FullName$,$ChatAgent.Nickname$,$ChatAgent.UserName$,$ChatAgent.LastName$,$ChatAgent.FirstName$,$ChatAgent.EmployeeId$.
Changes Take Effect: Immediately.
Related Options: Documentation:Options:IW:WDE-interaction-workspace

Specifies the display format of chat nicknames for agents by specifying a string that can contain regular characters as well as the following field codes: $ChatAgent.FullName$, $ChatAgent.Nickname$, $ChatAgent.UserName$,$ChatAgent.LastName$,$ChatAgent.FirstName$,$ChatAgent.EmployeeId$. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.nickname

Section: interaction-workspace
Default Value: $Agent.UserName$
Valid Values: A string that contains a compilation of characters and field codes from the following list: $Agent.UserName$,$Agent.LastName$,$Agent.FirstName$,$Agent.FullName$,$Agent.EmployeeId$,$AttachedData.Y$ (Y: attached data key name).
Changes Take Effect: At the next interaction.


Specifies the nickname that is used to join the chat session (presented to the customer) by a string that can contain regular characters and the following field codes: $Agent.UserName$,$Agent.LastName$,$Agent.FirstName$,$Agent.FullName$,$Agent.EmployeeId$,$AttachedData.Y$ (Y: attached data key name). This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.reconnect-timeout

Section: interaction-workspace
Default Value: 10
Valid Values: from 0 to MAXINT
Changes Take Effect: At the next interaction.


Specifies the duration, in seconds, between each attemp to reconnect to the chat session in the case of a connection loss.

chat.reconnect-attempts

Section: interaction-workspace
Default Value: 5
Valid Values: from 0 to MAXINT
Changes Take Effect: At the next interaction.


Defines the number of reconnection attemps to the chat session to make in the case of a connection loss.

chat.new-message-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid Windows file path, '|' separator and numeric values.
Changes Take Effect: Immediately


Specifies the configuration string for the new Chat Message sound. For example: "Sounds\bell.mp3|7|0|primary" The value has four components that are separated by the character '|':

1) The file name and folder relative to the application folder. It may happen that on some virtual desktop, MP3 or other sounds format cannot be rendered by Direct Show filters. Files format that can be played (.wav, …) with Direct Show must be used here.
2) The priority. The higher the integer the higher the priority.
3) The duration:
a) 0 means play the whole sound one time.
b) An integer > 0 means a time, in milliseconds, to play and repeat the sound.
4) The output devices:
a) primary means plays on the default output device.
b) secondary means plays on the output device specified by the application.secondary-audio-out-device option.
c) both means plays on both default output device and the output device specified by the application.secondary-audio-out-device option.

chat.typing-timeout

Section: interaction-workspace
Default Value: 10
Valid Values: from 0 to MAXINT
Changes Take Effect: At the next interaction.


Defines the duration, in seconds, that the typing notification is displayed after the last keystroke and before the agent or contact sends their message.

chat.typing-isenabled

Section: interaction-workspace
Default Value: true
Valid Values: true, false
Changes Take Effect: At the next interaction.
Modified: 8.5.108.11

Specifies whether typing notification is enabled. It should be disabled for Chat Server lower than 8.0.1.

Warning

If the Chat - Can Preview Customer Typing privilege is also granted, and you have configured eServices to hide sensitive personal information that is entered by the contact during the chat, agents will be able to see the information as it is entered, but not after then contact sends it.
Added: 8.5.108.11

chat.toast-information-key

Section: interaction-workspace
Default Value: Subject
Valid Values:
Changes Take Effect: At the next interaction.


Specifies whether the Information area is displayed in the Chat interaction notification. The option specifies the name of the attached data key that contains the information. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.show-unread-notification

Section: interaction-workspace
Default Value: true
Valid Values: true, false
Changes Take Effect: At the next sent message.
Introduced: 8.5.122.08

Specifies whether the unread message notification is displayed in the chat transcript. When the message is read, the notification icon disappears. This option can be overridden by a routing strategy, as described in Overriding Options by Using a Routing Strategy.

chat.pending-response-to-customer

Section: interaction-workspace
Default Value: 30,50
Valid Values: A comma-separated list value: warning time, maximum time
Changes Take Effect: At the next interaction.


Defines two alarm thresholds, in seconds, that warn agents that they have a pending response to a chat from a customer. Three levels are displayed: before the warning time, between the warning time and the maximum time, and after the maximum time.

options.record-option-locally-only

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: When the application is started or restarted.


Specifies whether the display settings for the agent are stored locally or in the agent annex.

chat.simple-transcript

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: At the next interaction.
Introduced: 8.5.122.08

Specifies whether the chat transcript is displayed as simple lines of text lines instead of text blocks.

Chat

[Modified: 8.5.108.11, 8.5.113.11, 8.5.115.17, 8.5.118.10, 8.5.122.08, 8.5.128.07, 8.5.132.05, 8.5.140.08, 8.5.142.05, 8.5.145.06]

Workspace employs the following Chat privileges for all Chat interactions:

  • Can Use Chat Media
  • Can Decline Chat
  • Can Release
  • Can One Step Transfer
  • Can One Step Conference
  • Can Push Url
  • Can Set Interaction Disposition
  • Show Silent Monitoring
  • Can Preview Customer Typing [Added: 8.5.108.11]
  • Chat - Can Transfer File From File System [Added: 8.5.115.17]
  • Chat - Can Transfer File From Standard Response [Added: 8.5.115.17]
  • Chat - Can Save Attached files [Added: 8.5.115.17]
Warning

If the Chat - Can Preview Customer Typing privilege is also granted, and you have configured eServices to hide sensitive personal information that is entered by the contact during the chat, agents will be able to see the information as it is entered, but not after the contact sends it.
[Added: 8.5.108.11]

Workspace displays a "Contact is typing a message" notice when the contact begins to type a reply message in your web site chat interface. The Chat - Can Preview Customer Typing privilege enables agents to see what the contact is typing before the contact clicks Send. This feature enables agents to anticipate their reply and therefore respond more quickly. However, Genesys recommends that you train your agents to wait until the contact has sent their message before responding to it. The text that is being typed by the contact is updated according to the updates that the web site sends to the Web API and Chat Server; therefore, your web site designer is responsible of the refresh rate of the content.

Chat server can be configured to disconnect a chat upon inactivity of engaged parties. Workspace warns the agents when a chat is about to expire due to inactivity and notifies when the session is automatically closed because of inactivity. [Added: 8.5.109.25]

Workspace notifies the agent through an audio alert or a visual alert when another party is leaving (automatically, due to inactivity, or manually) or joining the chat session while the focus is not on the Workspace application or is on another area of Workspace.

Visual notification added: 8.5.113.11

The Chat feature supports spelling check. Refer to Spelling tab for information about configuring Spelling Check.

For Genesys Widget customers, Workspace supports Rich Messaging. [Added: 8.5.142.05]

You use the following options in the interaction-workspace section to configure Chat interactions:

  • chat.simple-transcript: Specifies whether the chat transcript is displayed as simple lines of text or as colored blocks of text. [Added: 8.5.122.08]
  • options.record-option-locally-only: Specifies whether the display settings for the agent are stored locally or in the agent annex.
  • chat.pending-response-to-customer: Defines two alarm thresholds, in seconds, that warn agents that they have a pending response to a chat. Three levels are displayed: below the warning time, between the warning time and the maximum time, and above the maximum time. Agents are warned by the flashing of various elements in the user interface, including the taskbar, collapse/expand button, the interaction bar, and the pending response timer. If the agent places his or her mouse pointer on any of these flashing elements, a preview of the last received message from the contact is displayed.
  • chat.show-unread-notification: Specifies whether the unread message notification is displayed in the chat transcript. When the message is read, the notification icon disappears. [Added: 8.5.122.08]
  • chat.toast-information-key: Specifies whether the Information area is displayed in the Chat interaction notification. The option specifies the name of the attached data key that contains the information.
  • chat.typing-isenabled: Specifies whether typing notification is enabled. It should be disabled for Chat Server lower than 8.0.1.
  • chat.typing-timeout: Specifies the duration, in seconds, that the typing notification is displayed after the last keystroke and before the agent or contact sends their message.
  • chat.new-message-bell: Specifies the new Chat sound configuration string.
  • chat.reconnect-attempts—Defines the number of attempts to reconnect to the chat session. This applies to environments that implement Chat High Availability (HA) but also to simple environments if network disconnection occurs during a chat session.
  • chat.reconnect-timeout—Defines the interval between each attempt to reconnect to the chat session. This applies to environments that implement Chat High Availability (HA) but also to simple environments if network disconnection occurs during a chat session.
  • chat.nickname—Specifies that a nickname (pseudonym) is used in chat sessions instead of the agent's user name, and defines the nickname.
  • display-format.chat-agent-name—Specifies the display format of agent identifiers in agent and team supervisor views.
  • display-format.chat-customer-name—Specifies the display format of contact identifiers in agent and team supervisor views. [Added: 8.5.145.06]
  • chat.auto-answer: Specifies whether a chat interaction is automatically answered when it is routed to an agent. This option can be overridden by a routing strategy. You can also configure auto-answer to display a timer that enables an agent to view case information before the interaction is automatically answered by using the chat.auto-answer.timer and chat.auto-answer.enable-reject options [Added: 8.5.105.12].
  • chat.historical.maximum-age: Specifies the number of days of previous chat sessions with the current contact are to be displayed in the Chat interaction view before the current chat session. This reduces the need for agents to open the contact history to find previous chat interactions. Many chat sessions are conducted on mobile devices, meaning that the likelihood of timeout is very high. If a chat is resumed after a timeout, the agent sees the content of the previous sessions. [Added: 8.5.122.08]
  • chat.rich-media-widget-width: Specifies the width, in pixels, of Rich Media in a chat interaction. The value of this option affects the minimum width of the Chat transcript view [Added: 8.5.150.06].
  • chat.transcript-enable-history-filters: Specifies that the value specified for the contact.history.filters-<attribute> option is used to filter the history-based part of the chat transcript. Keys and values of the option are constructed like those of the contact.history.filters-<attribute> option. You can add these options to a routing strategy [Added: 8.5.132.05].
  • chat.transcript-message-text-direction: Specifies whether messages in the chat transcript are displayed with a left-to-right (default) or a right-to-left reading layout. Use this option for chat interactions where contacts are using a right-to-left reading language [Added: 8.5.140.08].

Provisioning the Chat channel

[Modified: 8.5.115.17, 8.5.128.07]

1. Enabling an agent to chat with a contact

Purpose:

To enable an agent to use the Chat channel to chat with a contact whose information is stored in Universal Contact Server (UCS).
Prerequisites

  • Genesys Administrator 8.0.2 or higher, configured to show Advanced View.
  • A working knowledge of Genesys Administrator 8.
  • A Workspace Application object exists in the Configuration Database.
  • Workspace has a connection to Universal Contact Server, Chat Server, and Interaction Server.
  • The Procedure: Enabling agents to manage contacts.

Start

  1. Allow the Chat privileges (see Chat Access Privileges) for the role to which the agent is assigned (refer to the Procedure: Creating a Role and allowing a Workspace privilege and assigning a Role to an agent or agent group):
    • Can Use Chat Media
    • Can Decline Chat
    • Can Release
    • Can One Step Transfer
    • Can Two Step Transfer
    • Can One Step Conference
    • Can Two Step Conference
    • Can Set Interaction Disposition
    • Can Preview Customer Typing [Added: 8.5.108.11]
  2. Configure the Chat options in the interaction-workspace section of the Workspace Application object (refer to the Chat configuration option reference for a list of Chat options and a description of how to configure them).
  3. [Added: 8.5.128.07] Configure the Chat options that control how Chat interactions are marked as done. When an agent manually marks a Chat interaction as done, a new Chat interaction can be directed to the agent. Sometimes agents do not mark interactions done to avoid getting new interactions, which affects the focus time. To have Workspace automatically mark a Chat as done, use the following configuration options:

    • chat.auto-mark-done-owner-agent: When set to true, the Chat interaction is automatically closed and marked as done as soon as the last agent (the owner) ends the Chat session or the contact disconnects. To prevent the Chat interaction from closing immediately — for example to allow for after-call work — you can specify how long the interaction window stays open by using the chat.auto-mark-done-owner-agent.timer option.
    • chat.auto-mark-done-non-owner-agent: When set to true, the Chat interaction on the non-owner's desktop is automatically closed and marked as done as soon as the non-owner leaves the Chat session or the contact disconnects. To prevent the Chat interaction from closing immediately, for example to allow for after-call work, specify how long the interaction window stays open by using the chat.auto-mark-done-non-owner-agent.timer option.

    If the value of the interaction.disposition.is-mandatory option is true, then an agent must specify an outcome for the interaction before it can be closed. In this case, the auto-close options are overridden and the agent must click Done to close the interaction.

    If the value of the interaction-workspace/mandatory option is set to true, then an agent must edit the case data for the interaction before it can be closed. In this case, the auto-close options are overridden and the agent must click Done to close the interaction.

  4. To keep chats open after the last agent leaves the session, which enables an agent to rejoin the session until the session is marked as done, set up Asynchronous chat [Added: 8.5.128.07]. Allow the following Chat privileges:
    • Chat - Can Place On Hold
    • Chat - Can Release Async
    • Chat - Can Release

    Configure the following options according to your environment:

  5. You can specify which Chat Server messages are included as part of the chat transcript in the interaction history. To include notices about inactivity timeout:

End

2. Enabling Chat HA

Purpose:

To enable Chat for High Availability (HA).
Prerequisites

  • Genesys Administrator 8.0.2 or higher, configured to show Advanced View.
  • A working knowledge of Genesys Administrator 8.
  • A Workspace Application object exists in the Configuration Database.
  • Workspace has a connection to Universal Contact Server and Interaction Server.
  • Chat Server 8.1.0 or higher.
  • The Procedure: Enabling agents to manage contacts.
Important
Chat Server 8.1.0 Limitation: Do not use the application cluster to connect the Web API Server Application to Chat Server.

Start

  1. Configure Chat Server for Warm Stand-by. Set the following values for the following Chat Server options for both the primary and backup Chat Servers:
    • session-restoration-mode = simple
    • transcript-auto-save = 2
    • transcript-resend-attempts = 10
    • transcript-resend-delay = 15
    • transcript-save-on-error = continue
    Refer to the EServices documentation for more information on setting up Chat Server.
  2. For the Web API Server application, add a connection to the primary Chat Server.
  3. Configure the following options in the interaction-workspace section of the Workspace Application object:
    • chat.reconnect-attempts--Defines the number of attempts to reconnect to the chat session.
    • chat.reconnect-timeout--Defines the interval between each attempt to reconnect to the chat session.
    Refer to the Chat configuration option reference for information about how to configure these options.
  4. Tip

    For information about configuring Load Balancing and Business Continuity, refer to Runtime Connection Logic in the eServices Load Balancing Business Continuity section of the Business Continuity and Disaster Recovery topic. [Added: 8.5.109.16]

End

Configuring Chat Conference and Consultation with a Skill, Group, or Interaction Queue

Agents can use the Team Communicator to find an "Instant Chat Conference" and "Start Chat Consultation" target based on a skill, group, or interaction queue instead of searching for a specific individual or DN. The system router finds the next available target from a list of targets based on the skill, group, or interaction queue that is selected by the agent. A Business Process tries to route the call based on attached data. You can configure the contact attempt interval and the number of attempts to find an available target with the specified skill or in the specified agent group or interaction queue before the request times out. The requesting agent is informed if the request has timed out.

The following attached data keys are populated by Workspace:

  • InternalConferenceInviteOwnerId—The employeeId of the agent who is requesting the conference or consultation.
  • InternalConferenceInviteOwnerInteractionId—The Interaction Id of parent Interaction.

To enable this feature, allow the following privilege:

  • Can One Step Conference

To configure the features of the Chat conference or consultation with a skill, an agent group, or an interaction queue, set the following configuration options:

Receiving Files from Contacts

[Added: 8.5.115.17]

Workspace lets your agents handled files that have been sent by contacts in chat interactions. By default, agents enabled for chat can receive files, open them in an appropriate application, and print them (if applicable). You can configure Workspace to enable agents to save files on their local workstation that have been sent through chat by a contact. To enable this feature, allow the following privilege:

  • Chat - Can Save Attached files

Configure the chat.show-attachment-image-thumbnail option to specify whether to display the icon of an attached image file in chat transcript as image thumbnail or as generic file) in the online session, the interaction history, or both.

Files are stored in the Contact History, so attached files can also be opened or saved from the Contact History view.

Warning
Workspace does not provide virus checking of files sent to your agents. You should have anti-virus software running on agent workstations to prevent infection from opening or saving infected files.

Controlling attachment read-only behavior

[Added: 8.5.118.10]

By default, all attachments opened by agents in an external program are read-only. This means that agents cannot update them and save the changes to their hard drive.

Use the general.writable-downloaded-attachment-file-types option to override this behavior for specific file types. Allowing agents to edit only certain file types preserves the data integrity of files that you do not want agents to modify. For example, you might allow agents to modify .jpg and .png files so that the orientation can be changed, but restrict the modification of .docx, .xlsx, and other file types. Or, you might want to ensure that only .xlsx files can be updated by agents.

Transferring files to contacts

[Added: 8.5.115.17]

You can enable your agents to transfer files to contacts in a chat interaction. You can specify whether agents can transfer files from their local workstation, from the Standard Response Library, or both. To enable this feature, allow one or more of the following privileges:

  • Chat - Can Transfer File From File System
  • Chat - Can Transfer File From Standard Response

A toolbar in the chat composition field enables agents to choose files from their local workstation.

Files that are transferred to a contact are also stored in the Contact History, so attached files can also be opened or saved from the Contact History view.

Use the following configuration options to control the behavior of this feature:

Enabling emojis

[Added: 8.5.115.17]

Prerequisites:

If you want your agents to be able to send and receive emojis during chat interactions you must perform the following actions:

  1. Allow the Chat - Can Use Emojis privilege.
  2. Set the value of the chat.emojis-business-attribute option to the name of a Business Attribute that defines the emojis that you want to support.
  3. Set the value of the gui.emoji-font-name option to specify which font should be used to display received emojis.

In chat interactions, emojis are handled as Unicode characters, which systems recognize and translate into an image. On computers, the image that is displayed is dependent on the font being used. Not all fonts support emojis and not all fonts support all emojis. On mobile devices, the image that is displayed is depending on the image set of the platform. Each mobile device substitutes the Unicode character with an image.

The list of emojis can be found at http://unicode-table.com/en/blocks/emoticons/. Click a Unicode character in the table to view how it looks on different platforms. For example: 1F601. Another resource for emojis can be found at http://unicode.org/emoji/charts/full-emoji-list.html.

If an emoji is not supported by the font that you are using in your environment, it will be replaced by a rectangle in the chat transcript.

Tip
For more information about emojis in Genesys solutions, see this article.

Creating the Business Attribute

Use the following steps to create a Business Attribute that defines the emojis that your agent can send:

  1. Create a new Business Attribute of type Custom with a name such as Emojis. This is the Business Attribute that you set as the value of the chat.emojis-business-attribute option.
    IW 851 GAX Emoticon Business Attribute.png
  2. In the Attribute Value tab of the Business Attribute, create one value for each emoji Unicode character that you want to support.
    IW 851 GAX Emoticon Business Attribute Values.png
  3. Name each value with a unique name, such as the code value of the Unicode character that you want to support. The Display Name that you define is displayed in a tooltip when an agent hovers their mouse pointer over an emoji before selecting it from the chat text field tools.
    IW 851 GAX Emoticon Business Attribute Values Config.png
  4. For each attribute value, configure the interaction-workspace\code option and assign to it the value of the emoji Unicode character. The value of the Unicode emoji format is 1F6nn where nn are digits in hex format; for example: 1F607
    IW 851 GAX Emoticon Business Attribute Values Config Option.png

This page was last edited on December 21, 2021, at 13:33.
Comments or questions about this documentation? Contact us for support!