Revision as of 21:00, November 14, 2016 by Olena (talk | contribs) (Update with the copy of version: DRAFT)
Jump to: navigation, search

timeout-close

Section: inactivity-control
Default Value: 45
Valid Values: Any integer from 1-86400
Changes Take Effect: Immediately
Modified: 8.5.301.06

Specifies, in seconds, a timeout that starts after "timeout-alert" or "timeout-alert2" (if specified) expires. If any qualifying activity occurs, (see "timeout-alert" or "timeout-alert2" for a description of what qualifies as activity), the timeout stops and both "timeout-alert" and "timeout-alert2" timers are reset. If qualifying activity does not occur, Chat Server:

  • Sends the IDLE_CONTROL_CLOSE notice with a message specified by the value of the "message-close" option.
  • Closes the chat session.

timeout-alert

Section: inactivity-control
Default Value: 255
Valid Values: Any integer from 1-86400
Changes Take Effect: Immediately
Modified: 8.5.301.06

Specifies an inactivity alert timeout, in seconds. The inactivity timeout is set (or reset) for a session after any of the following activities: chat participant joined or left, chat participant sent a message or a notice (as defined by "include-notices"). If no qualifying activity is detected during this timeout, Chat Server:

  • Sends the IDLE_CONTROL_ALERT notice with a message specified by the value of the "message-alert" option.
  • Starts the timeout specified by the value of the "timeout-alert2" (if specified) or "timeout-close" option.

message-close

Section: inactivity-control
Default Value: Chat session closed due to inactivity of chat participants.
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the message sent to chat participants upon expiration of the timeout specified by the option "timeout-close". If an empty string is specified, no message is sent.

message-alert

Section: inactivity-control
Default Value: Chat session will be closed soon due to inactivity of chat participants.
Valid Values: Any string
Changes Take Effect: Immediately


Specifies the message sent to chat participants upon expiration of the timeout which is specified by the option "timeout-alert". If an empty string is specified, no message is sent.

include-notices

Section: inactivity-control
Default Value: major
Valid Values: none, major, major2, typing, all
Changes Take Effect: Immediately
Modified: 8.5.310.09

Specifies which notifications count as chat session activity for the purpose of inactivity control.

  • all: All user notifications are included (custom, push URL, typing on/off, update nickname).
  • major: Only major notifications are included (push URL, file uploaded, file deleted).
  • major2: Extends the major value with custom notifications.
  • none: All notifications are excluded.
  • typing: Only major and "typing on" notifications are included.

enabled

Section: inactivity-control
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately


Enables (true) or disables (false, the default) chat session inactivity control by Chat Server. For active sessions, enabling or disabling of inactivity control takes effect only after some activity of chat participants occurs, or after the current inactivity timeout (specified by the "timeout-alert", "timeout-alert2" and "timeout-close" options) expires.

How to Send Message or Notice to Chat Session from Workflow

Introduction

Genesys allows to send messages and notices (types are limited) to chat session from a workflow (an URS/ORS strategy).

For example, when a customer starts a chat session from the web page, the chat session is created in Chat Server and corresponding interaction is submitted in Interaction Server. At some point, the interaction is processed by the workflow, which can send a message like "agent will be with you shortly... " and then the routing starts (to find an agent to serve this chat communication).

Prerequisites

Interaction Server application (in configuration) must be connected to Chat Server application's "ESP" port.

How to Implement

The following steps are necessary in order to send a message or notice from the URS strategy:

  1. Verify that the interaction is still online by checking that UData['IsOnline'] != '0'. If the interaction is offline, which means that the chat session is closed, there is no sense to send messages into it.
  2. Extract from the interaction properties the name of the Chat Server application which is processing/handling the ongoing chat session. This can be achieved by assigning UData['ChatServerAppName'] to a local variable.
  3. Use the External Service block in the Data and Services palette in IR Designer (or the External Service block in the Server Side palette in Composer) to send a request. The following general parameters must be specified:
  • The Application type must be set to ChatServer.
  • The Application name must be set to a value obtained from the user data in step 2.
  • The Service name is set to Chat.
  • The Don't send user data must be unchecked.
  • Set the corresponding Method name to send one of the following requests:
    • Message – submits a text message to a chat session. Provide the following parameters:
    Parameter Mandatory Value Description
    MessageText yes Message text to submit to a chat session
    MessageType optional Specify any arbitrary text as message type (transparent for Chat Server).
    Nickname optional Specify a nick name of a participant on behalf of whom the message will be shown in a chat session.
    Visibility optional Possible values:
    • ALL – message will be visible to all chat participants (default value)
    • INT – message will be visible to agents and supervisors only
    • VIP – message will be visible to supervisors only

    Use visibility wisely as not all components (including Genesys Workspace) may show it correctly.

    • Notice – sends a notification of the specified type to a chat session. Provide the following parameters:
    Parameter Mandatory Value Description
    NoticeType yes Possible values:
    • USER_PUSHED_URL – to implement the "push URL" functionality (NoticeText must contain valid URL).
    • USER_CUSTOM – could be used for any custom purpose (completely transparent for Chat Server).
    NoticeText optional Any arbitrary text.
    Nickname and Visibility The same as in the Message Method.
    • IdleControlConfigure – allows to change the configuration for inactivity control monitoring for a given chat session. Provide the following parameters (while all parameters are optional, at least one parameter must be provided):
    Parameter Mandatory Value Description
    reset-parameters optional Resets all inactivity control parameters to values provided in the Chat Server application configuration.
    Valid values: true / false (default).
    enabled optional See the inactivity-control section in Chat Server Options Reference
    include-notices optional See the inactivity-control section in Chat Server Options Reference
    message-alert optional See the inactivity-control section in Chat Server Options Reference
    message-close optional See the inactivity-control section in Chat Server Options Reference
    timeout-alert optional See the inactivity-control section in Chat Server Options Reference
    timeout-close optional See the inactivity-control section in Chat Server Options Reference
    Comments or questions about this documentation? Contact us for support!