Dual-Tone Multi Frequency
Also known as DTMF. A signaling system that sends pairs of audio frequencies to represent digits on a telephone keypad. Often, it is used interchangeably with the term Touchtone (an AT&T trademark).
Glossary
(Update with the copy of version: 8.5.2DRAFT) |
(Update with the copy of version: 8.5.2DRAFT) |
||
Line 4: | Line 4: | ||
Workspace Web Edition provides the following options for integrating WebRTC: | Workspace Web Edition provides the following options for integrating WebRTC: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
====web-rtc.enable-dtmf-tone==== | ====web-rtc.enable-dtmf-tone==== | ||
*Default Value: <tt>true</tt> | *Default Value: <tt>true</tt> | ||
Line 34: | Line 9: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: When this option is true, a tone is played when the agent selects a DTMF key. | *Description: When this option is true, a tone is played when the agent selects a DTMF key. | ||
− | |||
====web-rtc.gateway-uri==== | ====web-rtc.gateway-uri==== | ||
*Default Value: | *Default Value: | ||
Line 40: | Line 14: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Defines the host for the WebRTC gateway. | *Description: Defines the host for the WebRTC gateway. | ||
− | |||
====web-rtc.identifier.x-last-digit-displayed==== | ====web-rtc.identifier.x-last-digit-displayed==== | ||
*Default Value: <tt>10</tt> | *Default Value: <tt>10</tt> | ||
Line 46: | Line 19: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Specifies the number of digits of the WebRTC identifier to display in Workspace. The WebRTC identifier is generated based on the user ID — for example, a user ID of a78b5fc6bc7742fb9802958c985098e3 is converted to 977898510299698997742102989802958999850981013. You can use this option to make the number a more user-friendly size when it's displayed in the interaction for the toolbar, parties in Case Information, and in Team Communicator. For example, if you leave the option at the default value, the WebRTC identifier above would be displayed as 9850981013 in Workspace. | *Description: Specifies the number of digits of the WebRTC identifier to display in Workspace. The WebRTC identifier is generated based on the user ID — for example, a user ID of a78b5fc6bc7742fb9802958c985098e3 is converted to 977898510299698997742102989802958999850981013. You can use this option to make the number a more user-friendly size when it's displayed in the interaction for the toolbar, parties in Case Information, and in Team Communicator. For example, if you leave the option at the default value, the WebRTC identifier above would be displayed as 9850981013 in Workspace. | ||
− | |||
====web-rtc.quality-alert-timeout==== | ====web-rtc.quality-alert-timeout==== | ||
*Default Value: <tt>30</tt> | *Default Value: <tt>30</tt> | ||
Line 52: | Line 24: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Time in seconds that passes before an alert is displayed to notify that timeout occurred during a test call. | *Description: Time in seconds that passes before an alert is displayed to notify that timeout occurred during a test call. | ||
− | |||
====web-rtc.quality.score.key-name==== | ====web-rtc.quality.score.key-name==== | ||
*Default Value: <tt>callQualityScore</tt> | *Default Value: <tt>callQualityScore</tt> | ||
Line 58: | Line 29: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Specifies the key in the UserEvent that Workspace should use for the call quality score set by the agent. The agent only provides this score if the WebRTC API detects low quality of audio for the call. | *Description: Specifies the key in the UserEvent that Workspace should use for the call quality score set by the agent. The agent only provides this score if the WebRTC API detects low quality of audio for the call. | ||
− | |||
====web-rtc.quality.statistics.key-name==== | ====web-rtc.quality.statistics.key-name==== | ||
*Default Value: <tt>callQualityStatistics</tt> | *Default Value: <tt>callQualityStatistics</tt> | ||
Line 64: | Line 34: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Specifies the key in the UserEvent that Workspace should use for the call quality statistics it receives from the WebRTC API. | *Description: Specifies the key in the UserEvent that Workspace should use for the call quality statistics it receives from the WebRTC API. | ||
− | |||
====web-rtc.request-quality-interval==== | ====web-rtc.request-quality-interval==== | ||
*Default Value: <tt>2</tt> | *Default Value: <tt>2</tt> | ||
Line 70: | Line 39: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Specifies the interval, in seconds, to request audio call quality from the [[Documentation:WRTC:Developer:Welcome|Genesys WebRTC JavaScript API]]. | *Description: Specifies the interval, in seconds, to request audio call quality from the [[Documentation:WRTC:Developer:Welcome|Genesys WebRTC JavaScript API]]. | ||
− | |||
====web-rtc.ringing-bell==== | ====web-rtc.ringing-bell==== | ||
*Default Value: | *Default Value: | ||
Line 79: | Line 47: | ||
**<tt>0</tt> — play the whole sound once | **<tt>0</tt> — play the whole sound once | ||
**an integer greater than <tt>0</tt> — the length of time, in milliseconds, to play and repeat the sound | **an integer greater than <tt>0</tt> — the length of time, in milliseconds, to play and repeat the sound | ||
− | |||
====web-rtc.stun-uri==== | ====web-rtc.stun-uri==== | ||
*Default Value: | *Default Value: | ||
Line 85: | Line 52: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: The URI to the STUN server. | *Description: The URI to the STUN server. | ||
− | |||
====web-rtc.troubleshooting.enable-feedback==== | ====web-rtc.troubleshooting.enable-feedback==== | ||
*Default Value: <tt>true</tt> | *Default Value: <tt>true</tt> | ||
Line 91: | Line 57: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: Enables WebRTC to send a user event that contains diagnostic information. | *Description: Enables WebRTC to send a user event that contains diagnostic information. | ||
− | |||
====web-rtc.turn-password==== | ====web-rtc.turn-password==== | ||
*Default Value: | *Default Value: | ||
Line 97: | Line 62: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: The password for the TURN server. | *Description: The password for the TURN server. | ||
− | |||
====web-rtc.turn-username==== | ====web-rtc.turn-username==== | ||
*Default Value: | *Default Value: | ||
Line 103: | Line 67: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: The username for TURN server. | *Description: The username for TURN server. | ||
− | |||
====web-rtc.turn-uri==== | ====web-rtc.turn-uri==== | ||
*Default Value: | *Default Value: | ||
Line 109: | Line 72: | ||
*Changes take effect: When the session is started or restarted. | *Changes take effect: When the session is started or restarted. | ||
*Description: The URI to the TURN server. | *Description: The URI to the TURN server. | ||
+ | ====privilege.web-rtc.can-mute-microphone==== | ||
+ | *Default Value: <tt>false</tt> | ||
+ | *Valid Values: <tt>true</tt>, <tt>false</tt> | ||
+ | *Changes take effect: When the session is started or restarted. | ||
+ | *Description: Allows an agent to mute and unmute the microphone. Depends on [[Voice#privilege.voice.can-use|privilege.voice.can-use]] and [[WebRTC#privilege.web-rtc.can-use|privilege.web-rtc.can-use]]. | ||
+ | ====privilege.web-rtc.can-mute-speaker==== | ||
+ | *Default Value: <tt>false</tt> | ||
+ | *Valid Values: <tt>true</tt>, <tt>false</tt> | ||
+ | *Changes take effect: When the session is started or restarted. | ||
+ | *Description: Allows an agent to mute and unmute the speaker. Depends on [[Voice#privilege.voice.can-use|privilege.voice.can-use]] and [[WebRTC#privilege.web-rtc.can-use|privilege.web-rtc.can-use]]. | ||
+ | ====privilege.web-rtc.can-send-dtmf==== | ||
+ | *Default Value: <tt>true</tt> | ||
+ | *Valid Values: <tt>true</tt>, <tt>false</tt> | ||
+ | *Changes take effect: When the session is started or restarted. | ||
+ | *Description: Specifies if {{Glossaryterm|term=Dual-Tone Multi Frequency|text=DTMF|addlink=true}} is available for WebRTC calls. Depends on [[Voice#privilege.voice.can-use|privilege.voice.can-use]] and [[WebRTC#privilege.web-rtc.can-use|privilege.web-rtc.can-use]]. | ||
+ | ====privilege.web-rtc.can-use==== | ||
+ | *Default Value: <tt>false</tt> | ||
+ | *Valid Values: <tt>true</tt>, <tt>false</tt> | ||
+ | *Changes take effect: When the session is started or restarted. | ||
+ | *Description: Enables WebRTC in Workspace. Depends on [[Voice#privilege.voice.can-use|privilege.voice.can-use]]. | ||
[[Category:V:HTCC:8.5.2]] | [[Category:V:HTCC:8.5.2]] |
Revision as of 16:28, February 2, 2018
Contents
- 1 WebRTC
- 1.1 web-rtc.enable-dtmf-tone
- 1.2 web-rtc.gateway-uri
- 1.3 web-rtc.identifier.x-last-digit-displayed
- 1.4 web-rtc.quality-alert-timeout
- 1.5 web-rtc.quality.score.key-name
- 1.6 web-rtc.quality.statistics.key-name
- 1.7 web-rtc.request-quality-interval
- 1.8 web-rtc.ringing-bell
- 1.9 web-rtc.stun-uri
- 1.10 web-rtc.troubleshooting.enable-feedback
- 1.11 web-rtc.turn-password
- 1.12 web-rtc.turn-username
- 1.13 web-rtc.turn-uri
- 1.14 privilege.web-rtc.can-mute-microphone
- 1.15 privilege.web-rtc.can-mute-speaker
- 1.16 privilege.web-rtc.can-send-dtmf
- 1.17 privilege.web-rtc.can-use
WebRTC
Important
login.voice.prompt-dn-less-phone-number is mandatory for WebRTC.Workspace Web Edition provides the following options for integrating WebRTC:
web-rtc.enable-dtmf-tone
- Default Value: true
- Valid Values: true, false
- Changes take effect: When the session is started or restarted.
- Description: When this option is true, a tone is played when the agent selects a DTMF key.
web-rtc.gateway-uri
- Default Value:
- Valid Values: A valid URI
- Changes take effect: When the session is started or restarted.
- Description: Defines the host for the WebRTC gateway.
web-rtc.identifier.x-last-digit-displayed
- Default Value: 10
- Valid Values: A positive integer
- Changes take effect: When the session is started or restarted.
- Description: Specifies the number of digits of the WebRTC identifier to display in Workspace. The WebRTC identifier is generated based on the user ID — for example, a user ID of a78b5fc6bc7742fb9802958c985098e3 is converted to 977898510299698997742102989802958999850981013. You can use this option to make the number a more user-friendly size when it's displayed in the interaction for the toolbar, parties in Case Information, and in Team Communicator. For example, if you leave the option at the default value, the WebRTC identifier above would be displayed as 9850981013 in Workspace.
web-rtc.quality-alert-timeout
- Default Value: 30
- Valid Values: A positive integer
- Changes take effect: When the session is started or restarted.
- Description: Time in seconds that passes before an alert is displayed to notify that timeout occurred during a test call.
web-rtc.quality.score.key-name
- Default Value: callQualityScore
- Valid Values: Any string
- Changes take effect: When the session is started or restarted.
- Description: Specifies the key in the UserEvent that Workspace should use for the call quality score set by the agent. The agent only provides this score if the WebRTC API detects low quality of audio for the call.
web-rtc.quality.statistics.key-name
- Default Value: callQualityStatistics
- Valid Values: Any string
- Changes take effect: When the session is started or restarted.
- Description: Specifies the key in the UserEvent that Workspace should use for the call quality statistics it receives from the WebRTC API.
web-rtc.request-quality-interval
- Default Value: 2
- Valid Values: A positive integer
- Changes take effect: When the session is started or restarted.
- Description: Specifies the interval, in seconds, to request audio call quality from the Genesys WebRTC JavaScript API.
web-rtc.ringing-bell
- Default Value:
- Valid Values: All special characters that are valid URL file path, '|' separator and numeric values.
- Changes take effect: When the session is started or restarted.
- Description: Specifies the voice channel ringing 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
web-rtc.stun-uri
- Default Value:
- Valid Values: A valid URI
- Changes take effect: When the session is started or restarted.
- Description: The URI to the STUN server.
web-rtc.troubleshooting.enable-feedback
- Default Value: true
- Valid Values: true, false
- Changes take effect: When the session is started or restarted.
- Description: Enables WebRTC to send a user event that contains diagnostic information.
web-rtc.turn-password
- Default Value:
- Valid Values: A valid password
- Changes take effect: When the session is started or restarted.
- Description: The password for the TURN server.
web-rtc.turn-username
- Default Value:
- Valid Values: A valid username
- Changes take effect: When the session is started or restarted.
- Description: The username for TURN server.
web-rtc.turn-uri
- Default Value:
- Valid Values: A valid URI
- Changes take effect: When the session is started or restarted.
- Description: The URI to the TURN server.
privilege.web-rtc.can-mute-microphone
- Default Value: false
- Valid Values: true, false
- Changes take effect: When the session is started or restarted.
- Description: Allows an agent to mute and unmute the microphone. Depends on privilege.voice.can-use and privilege.web-rtc.can-use.
privilege.web-rtc.can-mute-speaker
- Default Value: false
- Valid Values: true, false
- Changes take effect: When the session is started or restarted.
- Description: Allows an agent to mute and unmute the speaker. Depends on privilege.voice.can-use and privilege.web-rtc.can-use.
privilege.web-rtc.can-send-dtmf
- Default Value: true
- Valid Values: true, false
- Changes take effect: When the session is started or restarted.
- Description: Specifies if DTMF is available for WebRTC calls. Depends on privilege.voice.can-use and privilege.web-rtc.can-use.
privilege.web-rtc.can-use
- Default Value: false
- Valid Values: true, false
- Changes take effect: When the session is started or restarted.
- Description: Enables WebRTC in Workspace. Depends on privilege.voice.can-use.
Comments or questions about this documentation? Contact us for support!