Extension Dialing
The Extension Dialing Node
Category - Call Connection
The Extension Dialing node prompts users to enter an extension number to be connected to.
The collected digits, along with the prefix, are stored in an internal buffer for the number to be connected to if checks succeed.
Should the user enter a number that is allowed, the call will
be connected. If the call completes successfully, the flow
ends. Otherwise, the Busy/No Answer
exit is taken.
When the user does not enter an allowed number, the node will
reprompt the user to enter a number until Max. Iterations
is reached.
If Max Iterations
is exceeded, the flow will exit down the
appropriate branch for the most recent failure condition, i.e.
Insufficient Digits
or No Match
.
Announcements must be selected for the Main
announcement,
as well as the Reprompt
announcement.
The minimum and maximum number of digits that are allowed to be entered must also be specified.
The prefix that is prepended to the entered digits may optionally be specified.
If additional configuration options are required, select the arrow icon in the header to display them:
Max. Iterations
refers to the total number of attempts the
user is permitted before the failure branches are followed.
Both the End Char
and the Cancel Char
may be disabled if
required.
Additionally, the timeout value may be specified in order to override the SRF default timer.
Destination Patterns
One or more extension dialing pattern must be defined in the extension dialing node. Extension patterns are used to verify that an extension number entered by the user is allowed to be used, and what prefix to the extension dialled should be used.
For example, this may verify that the entered extension is 3 digits long and the first digit is 1.
Destination patterns are a form of regular expressions. Pattern matching rules are:
Character | Description | |
---|---|---|
[123] | Match one of any character defined in the set, or within any defined range in the set. For example: [0-9] will match all digits 0-9. |
|
^121 | The ^ indicates the start of the extension digits. This pattern will match any digits beginning with 121. |
|
9$ | The $ indicates the end of the extension digits. This pattern will match any digits ending with 9. | |
9? | The ? represents matching "zero or one" of the preceding character. |
|
123* | The * matches zero or more of the preceding character. This example matches 12 and then any number of 3's (including 0). |
|
123+ | The + matches one or more of the preceding character. This example matches 123 and then any number of additional 3's (including 0). |
|
. | Match any value. This example would match any digit. |
Examples:
Example Pattern | Description | Example Matches |
---|---|---|
121 | Match 121 somewhere in the extension dialled. The digits can appear anywhere in the entered extension string. |
121 |
^121 | Match when the extension digits start with 121 . The digits after the 121 is not verified/checked. |
1211 |
^12[1-4] | Match when the extension digits start with (or are exactly) 121 , 122 , 123 , or 124 . |
1211 |
^12[1-4]$/td> | Match when the extension dialled is exactly 121 , 122 , 123 , or 124 . |
121 |
^02[1-4].$ | Match when the extension dialled starts with 121 , 122 , 123 , or 124 , and is at least four digits long. |
1211 , 1219 |
Configuration
To configure the node:
- Select the
Main
announcement that is played to the user when the node is first encountered. - Select the
Reprompt
announcement that is played to the user after an incorrect code is entered. - Enter the minimum number of digits that the entered number must be.
- Enter the maximum number of digits that the entered number may be.
- If required, enter the
Prefix
to be prepended to the entered digits. - If required, add or remove
Destination pattern
entries. - If required, set a new value for
Max Iterations
. - If required, set a new value for
Timeout
. - If required, set a new value for
End Char
. - If required, set a new value for
Cancel Char
.
Note that both announcements and minimum and maximum digits must be selected.