UCC Application Options
Configure these options in Genesys Administrator or Configuration Manager.
UC-Connector Section
Configure these options in the UC-Connector section of the UCC Application object.
audio-on-preview
Default Value: No default value
Valid Values: URL or file name
Changes Take Effect: Immediately
Specifies the location of the audio file that will be played when the Preview pop-up window is displayed.
audio-on-ring
Default Value: No default value
Valid Values: URL or file name
Changes Take Effect: Immediately
Specifies the location of the audio file that will be played when the Ringing pop-up window is displayed.
chat-title
Default Value: Chat
Valid Values: Any string
Changes Take Effect: Immediately
Specifies the name used for the Chat window. By default, the window uses the name Chat. You can use any other name for this section by changing the value of this option.
chat-consult-title
Default Value: Consulting Chat
Valid Values: Any string
Changes Take Effect: Immediately
Specifies the name used for the Chat window that opens for consultation chat interactions. By default, the window uses the name Consulting Chat. You can use any other name for this section by changing the value of this option.
dnd-off-timeout
Default Value: 300000
Valid Values: Any positive integer
Changes Take Effect: Immediately
Specifies the duration, in milliseconds, that UC Connector will set an agent to Do-Not-Disturb (DND) if the Knowledge Worker rejects the Preview Notification.
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether the log out menu item is displayed in the UC Connector GUI for the particular user, if no UC system configuration annexes are present in the Person configuration in CME.
enable-preview-reporting
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Related Feature: How It Works Reporting Events
When set to true, UC Connector creates records in ICON for the interaction Preview events accept, reject, timeout, or withdrawn due to another user in the group accepting the interaction.
gla-call-match-window
Default Value: 4000
Valid Values: 20001500
Changes Take Effect: Immediately
Specifies the time window, in milliseconds, in which a T-Lib call is matched against a Lync call reported by GLA. Lync and T-Lib call events do not have a common reference and can only be matched by co-incidence in time.
gla-kpl-time
Default Value: 30
Valid Values: 4Integer greater than the value of gla-kpl-response-time
Changes Take Effect: Immediately
Specifies the interval, in seconds, between GLA keep alive messages being sent to UC Connector.
gla-kpl-response-time
Default Value: 4
Valid Values: 3Integer less than the value of gla-kpl-time
Changes Take Effect: Immediately
Specifies the expected time, in seconds, for UC Connector to respond to the keep alive messages sent by GLA.
|
help-callcontrol-url
- Default Value: No default value
- Valid Values: a valid path to an .html file
- Changes Take Effect: Immediately
- Specifies the URL path to the .html help file that appears when the user clicks the Help button on the Call Control or Preview windows. For example, if you copy the sample Call Control Help file from the CD to the UC Connector installation folder, enter a path something like the following:
help/callcontrol.html
If you do not configure this option, the Help button does not appear.
If you are hosting your help file externally, use a fully qualified URL as the value for this option. For example:
http://www.companyhelp.com
help-interaction-url
Default Value: No default value
Valid Values: a valid path to an .html file
Changes Take Effect: Immediately
Specifies the URL path to the .html help file that appears when the user clicks the Help button on the Interaction window. For example, if you copy the sample Help file from the CD to the UC Connector installation folder, enter a path something like the following:
help/interaction.html
If you do not configure this option, the Help button does not appear.
If you are hosting your help file externally, use a fully qualified URL as the value for this option. For example:
http://www.companyhelp.com
help-login-url
Default Value: No default value
Valid Values: a valid path to an .html file
Changes Take Effect: Immediately
Specifies the URL path to the .html help file that appears when the user clicks the Help button on the Login screen. For example, if you copy the sample Call Control Help file from the CD to the UC Connector installation folder, enter a path something like the following:
help/login.html
If you do not configure this option, the Help button does not appear.
If you are hosting your help file externally, use a fully qualified URL as the value for this option. For example:
http://www.companyhelp.com
itx-window-close-timeout
Default Value: 9000
Valid Values: Any positive integer
Changes Take Effect: Immediately
Specifies the length of time you want the interaction to remain open after the Knowledge Worker interaction is released or abandoned.
locale
Default Value: en
Valid Values: A two-character country code
Changes Take Effect: Immediately
Related Feature: How It Works Customized Languages
Specifies the default language to be used in the UC Connector user interface, if not otherwise specified by the integrated web browser. By default, UC Connector uses English (en) for all the labels and buttons in the user interface. To set UC Connector to a different default language, enter one of the supported two-character country codes listed in Supported Languages.
If you set this option to default, then the language of the local operating system where the UC Connector is running will be used. If you do not configure this option at all, then English is used as the absolute default language.
login-queue
Default Value: Blank
Valid Values: A valid DN
Changes Take Effect: Immediately
Specifies the value used to populate the agent login request parameter queue. SIP Server can use this value for default routing in case of URS failure. The effects of this parameter depend on the T-Server and other solution components. See the deployment guide for your T-Server/SIP Server for information on whether it supports this feature.
popup-udata-key
Default Value: Blank
Valid Values: A string representing a User Data Key
Changes Take Effect: Immediately
If the value is blank, UC Connector will display the third-party call control window to the user for all arriving calls. If the option value contains a User Data Key, UC Connector will only display the call control window for calls with the specified User Data Key present in the User Data of the call.
presence-gateway-mode
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether UC Connector prevents sending invite messages to Lync when there is no web client UI connected for the corresponding user, and a new call or preview call is delivered. If true, UC Connector does not send SIP "INVITE" to Lync; otherwise, sending the invite is controlled by the invite-message option.
presence-location
Default Value: blank
Valid Values: string format, URL or file location
Changes Take Effect: Immediately
Specifies the location of the XML presence configuration file.
- The configuration file is only reloaded when the option changes.
- The default definitions will be used if the option is empty.
- If the XML is not valid, the current definition in use will remain in effect.
- If the resource directory location is specified, then all the files the presence.xml file requires must be in the same directory.
preview-info-keys
Default Value: UCC_ConnId,UCC_UserId,UCC_AgentId,UCC_Reason
Valid Values: A comma-separated list of four identifiers: <keyname>,<keyname>,<keyname>,<keyname>
Changes Take Effect: Immediately
Related Feature: Reporting Events
Specifies the ordered list of key names used for reporting the UC Connector Preview offer parameters.
preview-itx-arrival-timeout
Default Value: 9000
Valid Values: Any positive integer
Changes Take Effect: Immediately
Specifies the length of time, in milliseconds, that the UC Connector will wait for the interaction to arrive after the Preview Notification was accepted by the Knowledge Worker.
preview-expiration-timeout
Default Value: 15000
Valid Values: Any positive integer
Changes Take Effect: Immediately
Specifies the length of time, in milliseconds, that the UC Connector will wait for the Knowledge Worker response (accept or reject) to the Preview Notification.
A countdown timer in the preview window shows how much time is remaining. If the timer runs out, the call is returned to the URS routing strategy.
preview-state-name
Default Value: 3721,UCC_Preview
Valid Values: A string in the format <number>,<keyname>
Changes Take Effect: Immediately
Related Feature: Reporting Events
Specifies the numeric identifier and the key name of the custom state associated with the UC Connector Preview offer.
preview-shortkey-accept
Default Value: Blank
Valid Values: A string in alpha-numeric or ASCII decimal number format
Changes Take Effect: After Restart
Specifies the hotkey used to accept a call when the Preview window is displayed. If left blank, the shortcut key is disabled.For details on the ASCII and alpha-numeric formats, see Configuring Hotkeys for Interaction Preview.
preview-shortkey-reject
Default Value: Blank
Valid Values: A string in alpha-numeric or ASCII decimal number format
Changes Take Effect: After Restart
The hotkey used to reject a call when the Preview window is displayed. If left blank, the shortcut key is disabled. For details on the ASCII and alpha-numeric formats, see Configuring Hotkeys for Interaction Preview.
redirect-setup-enabled
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
This global option enables all users to set and enable a redirect number. This value can be overwritten by the Person-level redirect-setup-enabled option.
sync-when-logout
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Controls whether UC Connector logs in a user when only the Lync presence is available (that is, there is no independent login from a Genesys desktop client). In general, set this option to true in a back-office environment with complete Smart Link functionality. Set it to false when integrating with Lync Voice in the contact center.
- Also see Free Seating.
userdata-preview-format<n>
Default Value: title: <UserData_DisplayName>, value: [UserData_Key]
Valid Values: title: <UserData_DisplayName>, value: [UserData_Key]
Changes Take Effect: Immediately
Specifies which UserData key-value pair will be displayed in the Preview window, as well as how it will be displayed. For example, to display the UserData kvp custname with the title Customer Name in the Interaction window, configure the option as follows:
- title: Customer Name, value: [custname]
- You can name the <n> variable in this option in numerical order (1, 2, 3) as you add more kvps, or you can leave it empty.
user-unregister-timeout
Default Value: 60000 (1 minute)
Valid Values: Any positive integer
Changes Take Effect: Immediately
Specifies the length of time, in milliseconds, that UC Connector will wait after Knowledge Worker has closed all browser sessions before it unregisters the Knowledge Worker DN with T-Server/SIP Server.
userdata-call-format<n>
Default Value: title: <UserData_DisplayName>, value: [UserData_Key]
Valid Values: title: <UserData_DisplayName>, value: [UserData_Key]
Changes Take Effect: Immediately
Specifies which UserData key-value pair will be displayed in the Interaction window, as well as how it will be displayed. For example, to display the UserData kvp cust-account with the title Account in the Interaction window, configure the option as follows:
- title: Account, value: [cust-account]
- You can name the <n> variable in this option in numerical order (1, 2, 3) as you add more kvps, or you can leave it empty.
userdata-contact-format
Default Value: title: Contact, value: [USER-ID]
Valid Values: title: Contact, value: [USER-ID]
Changes Take Effect: Immediately
Specifies whether the Customer field will be displayed in the Interaction window
- If this option is enabled (with valid values), UC Connector checks the UserData attribute for the key name customer. If found, UC Connector includes the value for this key in the Contact field of the Preview Notification and Interaction windows.
- For example, if the key-value pair customer=Bank of Nova Scotia is found in the UserData, then UC Connector will display Customer Bank of Nova Scotia in the Preview Notification and Interaction windows.
userdata-note-key
Default Value: KW_ITX_NOTES
Valid Values: Any text
Changes Take Effect: Immediately
Specifies the key-name to be used for the notes taken by by the Knowledge Worker during the interaction, and returned to the contact center as user data.
By default, the key name for Know edge Worker notes in the user data is KW_ITX_NOTES.
userdata-onringing
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether UC Connector will display UserData when the call to the Knowledge Worker is in the ringing state.
userdata-note-onpreview
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether UC Connector will display the UserData Notes (configured in userdata-note-key) when the Preview Interaction is initially presented to the Knowledge Worker.
- Limitation: For agent notes that will appear in the Preview window, the text cannot contain a single (") mark. URS does not process this quotation mark as regular text, but as a text delimiter. In other words, any text after this quotation park will not be included in the Preview window.
userdata-note-onringing
Default Value: false
Valid Values: true, false</tt
Changes Take Effect: Immediately
Specifies whether UC Connector will display the UserData Notes (configured in userdata-note-key) when the call to the Knowledge Worker is in the ringing state.
userdata-contact-onpreview
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether UC Connector will display the contact information for the caller in the Preview Notification sent to the Knowledge Worker.
userdata-contact-onringing
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Specifies whether UC Connector will display the contact information for the caller when the call to the Knowledge Worker is in the ringing state.
userdata-title
Default Value: Case data
Valid Values: Any text
Changes Take Effect: Immediately
Specifies the title for the user data that is displayed in the Knowledge Worker Call Control or Preview window. By default, this part of the client UI uses the title Case data. You can use any other name for this section by changing the value of this option.
userdata-note-title
Default Value: Notes
Valid Values: Any text
Changes Take Effect: Immediately
Specifies the title for the section of the UC client interface where the Knowledge Worker can input notes about the interaction. By default, this area is named Notes. You can use any other name for this section by changing the value of this option.
user-auto-registration
Default Value: false
Valid Values: true, false
Changes Take Effect: At application restart
Enables automated DN registration of all Knowledge Workers configured in the Genesys environment, at the moment the UC Connector application starts. If set to true, UC Connector will begin monitoring all user DNs and their presence on the UC platform automatically, without requiring individual Knowledge Workers to log in to Genesys. For example, in integrations with Microsoft Lync Server, no custom tab is available for Knowledge Worker log in; in this case, this option must be set to true.
- Also see Free Seating.
Microsoft-OCS Section
Configure these options in the Microsoft-OCS section of the UCC Application object. This section must be created using the correct syntax for the supported UC platform you are integrating with: Microsoft-OCS.
agent-onnote-tstatus<x>
Default Value: No default value
Valid Values: <tserver status>, <note>
Changes Take Effect: Immediately
Only for Knowledge Workers using Smart Link, ignored for presence-only integration. Specifies the text for the triggering note, as well as the corresponding Genesys status. If enabled, when the Knowledge Worker enters a note that matches the text configured in this option, UC Connector will change the status for this Knowledge Worker to the specified Genesys agent state. To configure this option, enter the value <tserver status>, <note> in the following pattern:
| <tserver status> | Enter the Genesys status that the note will trigger. It can be any of the following Genesys states: ready, not ready, logout. |
| <note> | Enter the text for the triggering note. |
- For example, if you configure agent-onnote-tstatus1 to the value NotReady, I am busy, when the Knowledge Worker enters "I am busy" in the Lync / Skype for Business client, the Genesys agent state is changed to NotReady.
agent-status-ready
Default Value: 3500, 0-4499
Valid Values: Any valid MS-PRES protocol interoperability code. See Interoperability Values for Lync Skype for Business Presence States
Changes Take Effect: Immediately
Used for both UC Connector integration with Lync or Skype for Business Enterprise Voice, and for Enterprise Knowledge Workers. Specifies the presence status on the Microsoft side that will be mapped to the Genesys status of Ready.
agent-status-notready
Default Value: 6500, 4500-17999
Valid Values: Any valid MS-PRES protocol interoperability code. See Interoperability Values for Lync Skype for Business Presence States
Changes Take Effect: Immediately
Used for both UC Connector integration with Lync or Skype for Business Enterprise Voice, and for Enterprise Knowledge Workers. Specifies the presence status on the Microsoft side that will be mapped to the Genesys status of NotReady. You can map several status codes to the NotReady state, by adding a comma-separate list of status codes. For example, 6500, 9500, 12500, 15500.
agent-status-logout
Default Value: 18500,18000-
Valid Values: Any valid MS-PRES protocol interoperability code. See Interoperability Values for Lync Skype for Business Presence States
Changes Take Effect: Immediately
Used for both UC Connector integration with Lync or Skype for Business Enterprise Voice, and for Enterprise Knowledge Workers. Specifies the presence statuses on the Microsoft side that will be mapped to the Genesys status of Logout. Typically, you will map several Microsoft presence statuses to match the Genesys Logout status.
contact
Default Value: No default value
Valid Values: Valid SIP URI
Changes Take Effect: Immediately
Used for both UC Connector integration with Lync or Skype for Business Enterprise Voice, and for Enterprise Knowledge Workers. Specifies the Knowledge Worker name for the UC Connector as configured in Microsoft. This value matches the sign-in name for the Knowledge Worker in Microsoft Lync / Skype for Business. For example,
sip:sfb-ucc@your-sfb-address.com
enable-push-oncall-status
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Only for Knowledge Workers using Smart Link, ignored for presence-only integration. Enables the overall Push On Call Status feature. If enabled, when the Knowledge Worker receives a call from the Genesys environment, the Microsoft status is set on the Lync / Skype for Business side, according to the value of the oncall-status option.
invite-message
Default Value: "Please use the window on the right to access data about current interactions"
Valid Values: Any text string
Changes Take Effect: Immediately
Only for Knowledge Workers using Smart Link, ignored for presence-only integration. Specifies the text that will be presented to the Knowledge Worker in the "conversation extension" window when an interaction arrives. The window will only be enabled if this option is present and has a value configured.
oncall-status
Default Value: 9500 (recommended 6500)
Valid Values: Any valid MS-PRES protocol interoperability code. See Interoperability Values for Lync Skype for Business Presence States
Changes Take Effect: Immediately
Only for Knowledge Workers using Smart Link, ignored for presence-only integration. Specifies the status to be updated in the Lync / Skype for Business client when a Knowledge Worker receives a call from the Genesys environment.
presence-acw-note
Default Value: Working after call
Valid Values: Any string
Changes Take Effect: Immediately
Used for Lync / Skype for Business Enterprise Voice Integration only. Specifies the presence note that UC Connector uses when an agent enters the After Call Work state. For Lync / Skype for Business voice terminals, UC Connector uses this value for the presence update to Lync when the agent enters the After Call Work phase. Note: Smart Link does not support After Call Work (ACW).
presence-acw-status
Default Value: 6500
Valid Values: Any valid MS-PRES protocol interoperability code. See Interoperability Values for Lync Skype for Business Presence States
Changes Take Effect: Immediately
Used for Lync / Skype for Business Enterprise Voice Integration only. Specifies the presence state that UC Connector uses when an agent enters the After Call Work state. UC Connector uses this value for the presence update to Lync / Skype for Business when an agent enters the After Call Work phase. Note: Smart Link does not support After Call Work (ACW).
presence-lg-note
Default Value: Statutory pause
Valid Values: Any string
Changes Take Effect: Immediately
Used for Lync / Skype for Business Enterprise Voice Integration only. Specifies the presence note that UC Connector uses when an agent exits the After Call Work state and enters the Legal Guard state. UC Connector uses this value for the presence update to Lync / Skype for Business when an agent exits the After Call Work state and enters the Legal Guard state. Note: Smart Link does not support After Call Work (ACW).
presence-lg-status
Default Value: 6500
Valid Values: Any valid MS-PRES protocol interoperability code. See Interoperability Values for Lync Skype for Business Presence States
Changes Take Effect: Immediately
Used for Lync / Skype for Business Enterprise Voice Integration only. Specifies the presence state that UC Connector uses when an agent exits the After Call Work state and enters the Legal Guard state. UC Connector uses this value for the presence update to Lync / Skype for Business when an agent exits the After Call Work state and enters the Legal Guard state. Note: Smart Link does not support After Call Work (ACW).
presence-sync-mode
Default Value: pull
Valid Values: push, pull
Changes Take Effect: After restart
Introduced in UCC 8.0.3. Used for both UC Connector integration with Lync or Skype for Business Enterprise Voice, and for Enterprise Knowledge Workers. Use this option for Presence Connector Mode.
- If set to pull, UCC uses Presence Integration.
- If set to push, UCC uses Presence Connector Mode.
When UC Connector is working in "push" (Presence Connector) mode, synchronization of Microsoft presence states (Presence Integration mode) is disabled. Instead, UC Connector pushes Microsoft presence states to Lync / Skype for Business when the Genesys agent state changes. UC Connector will push the Microsoft presence state to Lync / Skype for Business regardless of the current Lync / Skype for Business user state, so will push even if the Lync / Skype for Business user is in a signed-out state.
TLib Agent State Push
UC Connector pushes the Microsoft presence state to Lync / Skype for Business based on the following TLib events and options:
| TLib Event | Option | Default Value |
|---|---|---|
| EventAgentNotReady | agent-status-notready | 6500,4500-17999 |
| EventAgentReady | agent-status-ready | 3500,0-4499 |
| EventAgentLogout | agent-status-logout | 18500,18000- |
- UC Connector uses first value from the range for making a presence update request. For example, UC Connector will use 6500 for the EventAgentNotReady event.
- For disabling push, set the value of the corresponding option to -1. For example, agent-status-logout=-1.
- UC Connector cannot sign-out or sign-in a Lync / Skype for Business user. Assuming that option agent-status-logout has a value of 18000 or greater then UC Connector updates the Microsoft presence state to "Offline", but the Lync / Skype for Business client will remain in a signed-in state.
On Call, After Call Work States Push
The option enable-push-oncall-status controls the push of the above states.
Multiple DNs Push
If a Knowledge Worker is logged into multiple DNs, the Lync contact presence is pushed based on the following table:
| DN State | Presence |
|---|---|
| All DNs in state Ready | Available |
| One DN state is Not Ready | Busy |
| One DN state is On Call | Busy + note |
registrar-uri
Default Value: No default value
Valid Values: Valid SIP URI
Changes Take Effect: Immediately
Used for both UCC configuration and Lync / Skype for Business Enterprise Voice integration. Specifies the URI that UC Connector uses to connect with the Microsoft Front End Server. For example,
sip:pool01.server-address.com
subscribe-batch-size
Default Value: 5
Valid Values: Range from 1 to 100
Changes Take Effect: After restart
Starting with release 8.0.300.43, UC Connector can now subscribe agents in batches using the above option. this option specifies the number of agents that are subscribed at one time.