Secure Session Get Key

This Telephony tool is similar to Extended Get Key except that Secure Session Get Key allows additional checks within Telephony Services and provides secure storage within the Telephony Services subsystem. To prevent logging of secure data, the tool does not return any data to handlers.

Inputs

Call Identifier

The unique identifier for a call.

Name

A label used when sending data for a validation step.

Regular Expression

A regular expression in the Boost.Regex format. The tool performs a check against this regular expression.

Additional Checks

An input string that contains "Luhn". This parameter currently supports only the Luhn algorithm check. For more information, search for "Luhn algorithm" on the Internet.

Valid Keys

0,1,2,3,4,5,6,7,8,9 are the keys a caller may enter. You can change these keys using the Expression Editor Assistant.

Escape Keys

"*" is the escape key. When a caller presses the escape key, this step stops accepting caller input and takes the Escape exit path. Change these keys using the Expression Editor Assistant.

Termination Keys

"#" is the termination key for this step. This step immediately stops waiting for key input when this key is pressed and exits through the Success exit path. If the caller presses the termination key before entering any other keys, this tool takes the Success exit path. The termination key appears in the Digits output key if it was included in the Valid Keys input. Otherwise, the  Digits output variable is empty.

Maximum number of Keys

The maximum number of keys this step accepts before taking the Successful exit path.

Maximum Inter-Digit Delay

The number of seconds to allow between key presses before this step takes the Success exit path. The default is 2.5 seconds. The Inter-Digit delay is not counted until the caller presses the first key. If the inter-digit delay expires, the tool will exit via the Success exit path with an output of whatever digits the caller pressed up to that point.

Note for the following Tone Detection parameters: The default values for the next 8 settings recognize a standard fax tone. In almost all cases, you do not need to change the default settings. If you want to detect a tone other than a fax device, refer to the documentation for the device generating the tone. Also see the topic on Tones.

Tone Detection Frequency 1 in Hertz

1100

To disable Fax tone detection, set this to 0.

Permissible deviation in Tone Detection Frequency 1

50

Tone Detection Frequency 2 in Hertz

Use 0 to disable.

Permissible deviation in Tone Detection Frequency 2 (in Hertz)

50

Time in seconds which tone must be on

Amount of time that the tone must last.

Permissible deviation in tone on time

The number of seconds that the tone on time can deviate from the value in the Time in seconds which tone must be on setting.

Time in seconds which tone must be off

Amount of time that the tone must last.

Permissible deviation in tone off time

The number of seconds that the tone off time can deviate from the value in the Time in seconds which tone must be off setting.

Number of tone on/off repetitions required for detection

0

Timeout (seconds)

The total number of seconds after audio is played for any keys to be entered before this tool takes the Timeout exit path. The default for this parameter is 20 seconds. If you are using this Extended Get Key step simply to flush any queued audio, set this value to 0 seconds. You should not set this value to zero unless you are flushing audio. The maximum value for this tool is 600 seconds. Any value specified greater than 600 will cause this tool to wait for 600 seconds.

This tool accepts a caller's key presses while the audio is being played.

Attribute to monitor as a termination event

This optional parameter specifies the name of an attribute to be monitored during the operation of this tool. If the value of this attribute changes during the Extended Get Key operation, the tool will exit taking the Attribute exit path.

Interaction ID for the attribute monitor

This optional parameter specified the interaction ID associated with the attribute to monitor.

Repeat queued plays if audio interruption is encountered?

If set to true, queued plays are repeated if audio is interrupted (a voice mail greeting is detected).

Outputs

Failed Input Checks

A string that specifies regex or Luhn to indicate failure details on Failure exit path.

Exit Paths

Success

This step takes the Success exit path if it does not take one of the exits below. If the caller pressed the termination key (#) without entering any digits, this tool takes the Success exit path and the Digits output variable is empty.

Escape

This step takes the Escape exit path if the caller presses an escape key.

Tone

This step takes the Tone exit path if it detects the tone specified by the Tone parameters on the Inputs pages.

Timeout

This step takes the Timeout exit path if no keys are pressed within the amount of time allotted in the Timeout parameter on the Inputs page.

Failure

This tool can take the Failure exit path for several reasons. Failure can occur if the call disconnects, if the call is picked up by a user (and is no longer under the control of the handler), the call ID is no longer valid (if the call is deallocated), or system resource limitation.

Attribute

This path is taken if an attribute that has been set to be monitored changes during the operation of this tool.