Revision as of 15:40, November 29, 2018 by Mwest (talk | contribs)
Jump to: navigation, search

security.inactivity-alert-dialog-before-timeout

Section: interaction-workspace
Default Value: 30
Valid Values: An integer value greater than or equal to 0.
Changes Take Effect: When the session is started or restarted.
Dependencies: security.inactivity-timeout

Specifies when Workspace displays an alert dialog to warn the agent of the upcoming inactivity timeout. The value of this option, in seconds, tells Workspace how soon to display the alert before the timeout occurs. You must set this option to a value less than the value of security.inactivity-timeout.

security.inactivity-timeout

Section: interaction-workspace
Default Value: 0
Valid Values: An integer value greater than or equal to 0.
Changes Take Effect: When the session is started or restarted.
Related Options: security.inactivity-alert-dialog-before-timeout

Specifies the amount of time, in minutes, of agent inactivity (no mouse or keyboard usage) that triggers the application to log out. If the agent has been inactive longer than the number of minutes that are specified by the inactivity timeout, the agent session is ended. A value of 0 disables the inactivity timeout.

Warning
After the timeout occurs, the Worksapce login dialog should be blank; however, if the agent has allowed the browser to remember his or her password, then the login dialog will still be populated with the agent's credentials. For security, agents should not allow web browsers to remember their login credentials.

workspace.web-content

Section: interaction-workspace
Default Value:
Valid Values: A comma separated value list of option section names that correspond to the extension views, for example: Extension1,Extension2,Extention3
Changes Take Effect: When the session is started or restarted.


The list of Web Applications that are configured to be displayed at the Workspace level. Refer to the Procedure: Enabling integration of web applications in the agent interface for information about creating web application objects in the configuration layer.

interaction.web-content

Section: interaction-workspace
Default Value:
Valid Values: A comma-separated list of option section names that correspond to web extension views. For example: Extension1, Extension2
Changes Take Effect: When the session is started or restarted.


Specifies the list of Web Applications that are configured to be displayed at the Interaction level. Refer to the Enabling integration of web applications in the agent interface for information about creating web application objects in the configuration layer. This option can be overridden by a routing strategy as described in the Configuration Guide.

agent-status.enabled-actions-global

Section: interaction-workspace
Default Value: Ready,NotReady,NotReadyReason,AfterCallWork,AfterCallWorkReason,Dnd,LogOff
Valid Values: Comma-separated list of action names from the following list: Ready,NotReady,NotReadyReason,AfterCallWork,Dnd,LogOff
Changes Take Effect: When the session is started or restarted.


Specifies the available agent states in the global Status menu. The agent state commands are displayed in the order in which they appear in the list.

agent-status.enabled-actions-by-channel

Section: interaction-workspace
Default Value: Ready,NotReady,NotReadyReason,AfterCallWork,AfterCallWorkReason,Dnd,LogOff
Valid Values: CComma-separated list of action names from the following list: Ready, NotReady, NotReadyReason, AfterCallWork, Dnd, LogOn, LogOff.
Changes Take Effect: When the session is started or restarted.


Specifies the available agent state actions in the My Channels contextual menu. The actions are displayed in the order in which they appear in the list.

agent-status.enabled-actions-global

Section: interaction-workspace
Default Value: Ready,NotReady,NotReadyReason,AfterCallWork,AfterCallWorkReason,Dnd,LogOff
Valid Values: Comma-separated list of action names from the following list: Ready,NotReady,NotReadyReason,AfterCallWork,Dnd,LogOff
Changes Take Effect: When the session is started or restarted.


Specifies the available agent states in the global Status menu. The agent state commands are displayed in the order in which they appear in the list.

agent-status.enabled-actions-by-channel

Section: interaction-workspace
Default Value: Ready,NotReady,NotReadyReason,AfterCallWork,AfterCallWorkReason,Dnd,LogOff
Valid Values: CComma-separated list of action names from the following list: Ready, NotReady, NotReadyReason, AfterCallWork, Dnd, LogOn, LogOff.
Changes Take Effect: When the session is started or restarted.


Specifies the available agent state actions in the My Channels contextual menu. The actions are displayed in the order in which they appear in the list.

voice.ringing-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the path of the sound file Workspace plays when a voice interaction is ringing. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

twitter.ringing-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the path of the sound file Workspace plays when a Twitter interaction is ringing. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

outbound-callback.ringing-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.
Dependencies: privilege.outbound.can-use

Specifies the outbound callback ringing sound configuration string of a scheduled callback pushed to the agent as a preview. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

facebook.ringing-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the path of the sound file that is played when a Facebook interaction is ringing. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

email.ringing-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the path of the sound file Workspace plays when an email interaction is ringing. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

chat.ringing-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the path of the sound file Workspace plays when a chat interaction is ringing. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

chat.new-message-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the path of the sound file Workspace plays when a new chat message arrives. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

accessibility.warning-message-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the warning message sound-configuration string. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

accessibility.outbound-campaign-state-change-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the outbound campaign state change sound-configuration string. For example: 'BELL|7|0'. The value has three components that are separated by the character '|'. The first is the sound file name (BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

accessibility.interaction-state-change-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the interaction state change sound-configuration string. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

accessibility.agent-state-change-bell

Section: interaction-workspace
Default Value:
Valid Values: All special characters that are valid in a URL file path, the '|' separator, and numeric values.
Changes Take Effect: When the session is started or restarted.


Specifies the agent state change sound-configuration string. For example: 'BELL|7|0'. The value has three components that are separated by the pipe ('|') character. The first is the sound file name (the BELL, RING, CHORD or WARNING predefined aliases or an absolute URL to a MP3 file). The second is a priority — the higher the integer, the higher the priority. The last is the duration, which can have the following values:

  • -1 — play and repeat the sound until an explicit message, such as event established, causes it to stop.
  • 0 — play the whole sound once
  • an integer greater than 0 — the length of time, in milliseconds, to play and repeat the sound

intercommunication.voice.make-call-caller-id-business-attribute

Section: interaction-workspace
Default Value:
Valid Values: The name of a valid Business Attribute.
Changes Take Effect: When the session is started or restarted.


Specifies the name of the Business Attribute that contains the Attribute Values that are used as outbound caller IDs. This option is only applicable for external calls.

interaction.disposition.value-business-attribute

Section: interaction-workspace
Default Value: DispositionCode
Valid Values: The name of a valid Business Attribute.
Changes Take Effect: When the session is started or restarted.


Specifies the name of the Business Attribute that contains the Attribute Values that are used as an enumerated value for a disposition code. This option can be overridden by a routing strategy as described in the Configuration Guide.

interaction.disposition.use-attached-data

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


Specifies that attached data can be added to the interaction in UserEvent. This option can be overridden by a routing strategy as described in the Configuration Guide.

interaction.disposition.key-name

Section: interaction-workspace
Default Value: DispositionCode
Valid Values: Letters A to Z and a to z. Numbers 0 through 9. The underscore and space characters.
Changes Take Effect: When the session is started or restarted.


Specifies the key that is used to populate attached data or a user event when a disposition code is submitted to the back-end system, such as T-Server, Interaction Server, and Contact Server. This option can be overridden by a routing strategy as described in the Configuration Guide.

interaction.disposition.is-read-only-on-idle

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


If the value of this option is set to true, changes to case data after a voice interaction has been released are prevented. When values are modified or added after the voice call is released, the update is pushed to the back-end as a User Event when an agent clicks Done. This option can be overridden by a routing strategy as described in this Deployment Guide.

interaction.disposition.is-mandatory

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


Specifies 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 the Configuration Guide.

privilege.voice.show-monitoring.can-use

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


Enables agents to be notified that the current call is monitored by a supervisor.

privilege.voice.can-use

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


Enables the agent to use the Voice channel.

privilege.voice.can-send-dtmf

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


Enables agents to send DTMF during a voice call by using the on screen number keypad.

privilege.voice.can-one-step-transfer

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


Enables instant conferencing of a voice call.

privilege.voice.can-one-step-conference

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


Enables instant conferencing of a voice call.

voice.prompt-for-end

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


Specifies whether Workspace displays a confirmation message when the agent clicks End. This option can be overridden by a routing strategy as described in the Configuration Guide.

voice.mark-done-on-release

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


Specifies if an interaction should be closed automatically if a Release message is received. This option can be overridden by a routing strategy as described in the Configuration Guide.

voice.auto-answer

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


Specifies whether a voice interaction is automatically answered when a EventRinging message is received. This option can be overridden by a routing strategy as described in the Configuration Guide.

voice.auto-answer.is-enabled-on-already-in-call

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


Specifies whether a voice interaction is automatically answered if there is other active call(s) (used only with voice.auto-answer set to true). This option can be overridden by a routing strategy as described in the Configuration Guide.

voice.auto-answer

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


Specifies whether a voice interaction is automatically answered when a EventRinging message is received. This option can be overridden by a routing strategy as described in the Configuration Guide.

privilege.voice.single-step-transfer.can-use-caller-id

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


Enables agents to use caller ID for single-step transfers.

privilege.voice.single-step-conference.can-use-caller-id

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


Enables agents to use caller ID for single-step conferences.

privilege.voice.show-monitoring.can-use

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


Enables agents to be notified that the current call is monitored by a supervisor.

privilege.voice.make-call.can-use-caller-id

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


Enables agents to use caller ID for making calls.

privilege.voice.consultation.can-use-caller-id

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


Enables agents to use caller ID for consultations.

privilege.voice.can-use

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


Enables the agent to use the Voice channel.

privilege.voice.can-two-step-transfer

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


Enables two step transfer of of a voice call.

privilege.voice.can-two-step-conference

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


Enables two step conference for voice calls.

privilege.voice.can-send-dtmf

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


Enables agents to send DTMF during a voice call by using the on screen number keypad.

privilege.voice.can-release-call

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


Enables agents to manually end voice calls.

privilege.voice.can-reject-call

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


Enables an agent to reject an incoming voice call.

privilege.voice.can-one-step-transfer

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


Enables instant conferencing of a voice call.

privilege.voice.can-one-step-conference

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


Enables instant conferencing of a voice call.

privilege.voice.can-make-call

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


Enables an agent to make a new voice call from any area enabling voice calls.

privilege.voice.can-forward

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


Enables agents to forward voice calls.

privilege.voice.can-extend-after-call-work

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


Enables an agent to extend the After Call Work state.

Setting Up Agents On The System

After you have created Agent objects you can set up your agents and supervisors to use different functionality. The following procedures assume that you know how to use the Genesys Administrator Extension application to configure agent objects.

Workspace Agent Desktop functionality is configured on the WS_Cluster object in the interaction-workspace section. You must create this section and then create the individual configuration options that you need.

Tip
For agents who also handle multimedia (chat, email, and so on) interactions or for multimedia-only (non-voice) agents, refer to Handling Interactions and the individual channels in the sub-topics.

Provisioning Workspace Agent Desktop for the Voice channel

Purpose: To enable an agent to log in to the Voice channel.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A WS_Cluster object exists in the Configuration Database.
  • T-Server with the associated switch and switching office.
  • Agents with logins configured with DNs that correspond to agent devices in the switch.
  • A Place that contains one or more DNs from the switch.

Start

For each agent that you want to configure to use the Voice channel, do the following:

  1. Select at least one AgentLogin from the switch.
  2. Reference a default place.
  3. In GAX, set the value of the Agent property to True.
  4. Verify that the Voice media in Web Services is enabled.
  5. Configure the Voice options in the interaction-workspace section of the WS_Cluster object.

End

Granting Voice Privileges

Workspace Agent Desktop uses the following privileges to enable voice-related functionality:

Controlling the behavior of voice interactions

You can use the following options in the [interaction-workspace] section to configure voice interactions:

Important
Voice call monitoring is supported only for SIP Server environments

Enabling Workspace to use ring tones

Purpose: To enable Workspace Agent Desktop to use ring tones for incoming interactions and state changes. You can set different tones for different types of interactions using either absolute URLs that point to custom sounds or the set of aliases Workspace provides for standard sounds:

  • BELL
  • RING
  • CHORD
  • WARNING

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A WS_Cluster object exists in the Configuration Database.

Start

  1. In the Configuration Layer, you can set any of the following options to enable ring tones on incoming interactions and state changes:

End

Declaring and using new Not-Ready Reason codes

Purpose: To enable an agent to use custom Not-Ready Reason codes.

Custom Not-Ready Reason codes must be defined by creating an Action Code in the Action Codes folder of the Desktop folder in the Provisioning view of Genesys Administrator Extension.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A WS_Cluster object exists in the Configuration Database.

Start

  1. In the Configuration Layer, create an Action Code of type Not Ready by using the Action Codes - NotReady procedure. Each Not Ready Reason Action Code object that you create must have a unique name and a Not Ready Reason code. You can create Action Codes only for the Tenant object.
  2. Enable this feature by specifying the NotReadyReason as the value for the agent-status.enabled-actions-by-channel and agent-status.enabled-actions-global options.

End

Declaring and using new After Call Work Reason codes

Purpose: To enable an agent to use custom After Call Work Reason codes.

The only After Call Work state that Workspace Agent Desktop supports by default is After Call Work. Custom After Call Work codes must be defined by creating an Action Code in the Action Codes folder of the Desktop folder in the Provisioning view of Genesys Administrator Extension.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A WS_Cluster object exists in the Configuration Database.

Start

  1. In the Configuration Layer, create an Action Code of type Not Ready by using the Action Codes - NotReady procedure. Each Not Ready Reason Action Code object that you create must have a unique name and a Not Ready Reason code. You can create Action Codes only for the Tenant object.
  2. To define this Action Code as an After Call Work Reason code, perform the following steps:
    1. In the annex of the Action Code, create a section named: htcc
    2. In this section add the workmode option and specify the value AfterCallWork.
  3. Enable this feature by specifying the value AfterCallWork for the agent-status.enabled-actions-by-channel and/or agent-status.enabled-actions-global options.

End


Enabling integration of web applications in the agent interface

Purpose: To enable an agent to view or use a third-party web application or website in Workspace Agent Desktop as either a tab, a popup window, in the background at the interaction level, or hidden.

To avoid any conflict and security constraints between Workspace and the external website or web application, the external web site or web application is displayed in a dedicated iframe.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A WS_Cluster object exists in the Configuration Database.

Start

  1. You must create a new option section for each third-party web application that you want to use in Workspace. These sections must be created in the WS_Cluster object options, Tenant, Agent Group, or Agent annex. For example, create sections called SearchEngine, MyCompanyWebApp and SearchLocation.
  2. In each section, you must create the following options:
    • label:Specifies the label to be used for the name of the tab in the workspace or the button in multimedia interaction.
    • url: Specifies the URL of the web application. This URL can contain field codes.
      Important
      • If this attribute is left blank, Workspace does not display the web application.
      • If you configured Web Services to use HTTPS (for example, the URL for Workspace is in the following format: https://<host>:<securePort>/ui/ad/v1/index.html), then the URL for the external web application must also be in HTTPS.

      The following field codes are supported for both the label and url options:

      • Agent.FullName
      • Agent.UserName
      • Agent.LastName
      • Agent.FirstName
      • Agent.EmployeeId
      • AttachedData.Y (Note: This field code is only applicable for the interaction.web-content option.)
      • Interaction.Id (Note: This is a client-side ID that is lost on the next session or refresh. This field code is only applicable for the interaction.web-content option.)

      An external web site URL can be defined using the $AttachedData.Y$ parameter to have flexible text in the URL where Y represents an attached data name.

      Warning
      • If the $AttachedData.Y$ parameter is specified for the external website URL, and Y is not part of the attached data associated with an interaction, the external website is not displayed.
      • If an agent manually adds the attached data to the interaction (or if it's added by any other means), then the external website tab is displayed with the content of the external website.


      For example, the external website specified as follows: 

      label = Customer Location
url = http://www.bing.com/search?q=$AttachedData.CustomerLocation$

      With this URL, if an interaction is received with a CustomerLocation attached data with the value of Paris, then the external website will be displayed in a dedicated tab called Customer Location, and the external web site will be http://www.bing.com/search?q=Paris

    • mode: Specifies the mode Workspace uses to display the web application. The default value is INTERNAL. The possible values are:
      • INTERNAL: The web application is displayed in a dedicated tab in Workspace. It can be viewed and used when the agent clicks the tab to display it. This is the default behavior.
      • EXTERNAL: The web application is displayed in a popup window.
      • BACKGROUND: The web application is displayed in the background (Workspace area) when the interaction is selected. When the interaction is deselected or closed, the third-party website is replaced with the previous panel that was displayed in the background. This mode is only applicable at the interaction level.
      • HIDDEN:The web application is loaded but not displayed in Workspace. You can use this mode to integrate Workspace with a non-web application.
    • attached-data-update-handle-mode: Specifies how to handle attached data changes when an external website is configured with attached data. The possible values are:
      • 0 (default value): Specifies that when the attached data is updated or deleted, the external website is not updated.
      • 1: Specifies the following actions to occur:
        • When the attached data is updated, the external website is updated with the new URL.
        • When the attached data is deleted, the external website is not updated.
      • 2: Specifies the following actions to occur:
        • When the attached data is updated, the external website is updated with the new URL.
        • When the attached data is deleted, the external website disappears.
  3. Configure one or both of the following options in the interaction-workspace section, depending on whether the application is to be displayed in the interaction view or the workspace view:
    • interaction.web-content: Defines the list of option section names that represent Web Applications which are configured to be displayed at the interaction level. For example: SearchLocation
    • workspace.web-content: Defines the list of option section names that represent Web Applications which are configured to be displayed at the Workspace level. For example: SearchEngine, MyCompanyWebApp.

End

For example, in the tenant object, configure the following sections and options: 

[SearchEngine]
label=Bing
url=http://www.bing.com

[MyCompanyWebApp]
label=Genesys
url=http://www.genesys.com

[SearchLocation]
attached-data-update-handle-mode=1
label=Search Location
url=http://myhost/service-client-api/GoogleMaps.html?InteractionId=$Interaction.Id$&att=$AttachedData.GSW_CAMPAIGN_NAME$
mode=BACKGROUND

[interaction-workspace]
interaction.web-content=SearchLocation
workspace.web-content=MyCompanyWebApp,SearchEngine

Enabling and Disabling Agents

Purpose: To enable or disable an agent to be available for use by Web Services. Disabled Agents will not be imported into Web Services.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • An Person object exists in the Configuration Database.

Start

  1. In the configuration layer, use GAX to select State Enabled to enable an agent for use. Deselect State Enabled to disable an agent.

End

Enabling Disposition Codes

Purpose: To enable disposition codes to be presented.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A Business Attribute object containing the dispositions exists in the Configuration Database.

Start

  1. In the configuration layer, using GAX.
  2. In the annex of the Business Attribute object, in the htcc section, specify the value dispositions for the contains option.
  3. To enable hierarchical dispositions, use folders to organize the Business Attribute values.

End

Enabling Security

Purpose: To configure Workspace to log out an agent from the application if the agent has not used the keyboard or mouse for a period that you specify. When this happens, Workspace saves the agent's work, ends the session, logs out the agent on all media channels, and goes back to the login page.

Prerequisites

  • A working knowledge of Genesys Administrator Extension (GAX).
  • A WS_Cluster object exists in the Configuration Database.

Start

  1. In GAX, open the WS_Cluster application.
  2. Select the Options tab.
  3. You must configure the following options in the [interaction-workspace] section:

End

Comments or questions about this documentation? Contact us for support!