Menu
![]() |
Adds a menu of choices from which the user can select while also playing a message. This action is typically used to allow the contact to provide information that directs the way in which the interaction is handled. Examples of use cases for this action include:
Messages used in a Menu action can be pre-recorded audio files, text-to-speech (TTS) renditions of values provided in the script, or a combination of these. Supported audio file types:
|
Supported Script Types
Properties
Property | Details |
---|---|
Sequence |
Determines the order in which audio files (whether pre-recorded or TTS If you enter values in the Sequence property field, you must use the correct formatting for each item. You can specify the exact text that you want the TTS service to say, such as: "%Your account balance is". You can also include variables, such as: "${accountBalance}". If you use variables, ensure that your script passes the variable value to the action containing the prompt. |
Phrase | Use this to property to document the way the prompt should read. This property is not used by the script. Because some prompts can be complex and contain multiple segments, it can be helpful to include the text written without the formatting required by the Sequence field. |
ClearDigits | When a contact presses a key on their telephone keypad, the generated DTMF tone is stored in a buffer. When the ClearDigits property is set to True (the default value), that buffer is cleared when the action begins. Otherwise, the action would immediately detect a DTMF tone and invoke the OnDigit or OnDTMF branch even if the key press was associated with an earlier action. |
MaxDigits | The maximum number of digits that a user can provide for the action; for example, if the prompt requests the last four digits of a person's social security number, set this value to 4. The default value is 6. When the MaxDigits value is reached, the script continues to execute. Therefore, if the prompt calls for a terminator (such as the pound sign, or #), you must account for it in this value. For example, if the recorded menu message asks for the last 4 digits of the social security number "followed by the pound sign", set the value to 5. |
Terminator |
A key press that indicates the caller has finished entering digits; for example, the pound sign (#) as discussed in the preceding description of MaxDigits. If you do not want this value to be included in the Variable, type a minus sign after the terminator (for example, #-). |
Timeout |
The total number of seconds the system waits for input of any type. Time is counted beginning as soon as the Sequence message finishes playing. |
InterDigitTimeout | The amount of time the system will wait after a digit being entered to determine if another digit will be entered. |
Variable |
The name of the variable in which captured digits are saved. The default value is {MRES}, which stands for "menu response". This saved information can then be used for decision-making or other purposes in addition to triggering the appropriate branch in the menu |
Branches
Branch | Details |
---|---|
Default |
Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the other branches are not defined. |
OnTerminator |
Path taken when the caller provides the value specified in the property. |
OnMaxDigits | Path taken when the caller's input reaches the MaxDigits value. |
OnTimeout | Path taken if there is no response for the number of seconds specified. |
OnInterDigitTimeout | Path taken when the time specified in the InterDigitTimeout property is exceeded during the caller's response to a prompt. |
CustomCases |
Tips & Tricks
- When the caller presses the number on their keypad, the script follows the branch based on the selected number.
- If a caller uses a rotary phone, they will not be able to enter DTMF tones and will be stuck unless you account for this scenario in the script.
- If your script contains multiple Menu actions, make sure you rename variables from the default value so the variables from different actions do not overwrite each other.
- TTS has a limit of 300 characters.
Phone Script Example Using Menu
In this simple example, the script is triggered by a Begin action (not shown), after which a Menu action plays a message telling the caller to press 1 for Support, 2 for Sales, or 3 for Billing. Based on the button the caller presses on their phone keypad, the script executes a different Reqagent action that requests an agent from the Used to automate delivery of interactions based on agent skills, abilities, and knowledge configured in that Reqagent action.
Would you like to download this script?