Dial plan syntax

Numbers 0 to 9

To match a specific number, enter that number.

Example: to match calls to "001234", type 001234. The condition will match that and only that number.

S

To match an * (known as an asterisk or star), enter an S.

Example: to match calls to "**1234", type SS1234. The condition will match that and only that number.

P

To match a # (known as a pound or hash), enter a P.

Example: to match calls to "#1234", type P1234. The condition will match that and only that number.

D

To match any digit, use the wildcard character D

Example: to match any number that starts with "623" followed by exactly two more digits, type 623DD. This condition will match "62300", "62323", "62355", "62399", etc. but not "623" or "623233".

?

To match once or zero times, use ?

Example: "6?" means match one 6 or no 6s, and is useful when used with the wildcard "D" where you do not know how long a number will be. The expression: "67800D?" will match "67800" and "678004" but not "67800666".

+

To match once or more, use +

Example: "5+" means "match at least one 5, but possibly more".

*

To match zero or more times, use *. This is useful when used with the wildcard: "D*" means "match any digit, any number of times".

Example: to match any number that starts with "01", has any amount of digits in the middle, and ends with "5", type 01 D* 5.

()

Parentheses indicate substitution groups. To include any of the incoming called digits in the outgoing called number, enclose them in parentheses. Note that if you wish to include the complete number, you do not need to enclose the whole expression in parentheses.

Example: to match any number starting with "678", then followed by a number of other digits, and you wish the final digits to form part of the called number, type the expression: 678 (D*). This will match "6780000", "678123", "6789999" etc. but not "775000".

Letters and numbers for address

To call a specific number (you can also specify an IP address or hostname), type that number (or IP address or hostname).

Example: to specify that when this rule is invoked, the MCU with hostname my_mcu is called, type my_mcu.

!

To call a specific extension, separate the number/address from the extension by typing an exclamation mark (!).

Example: to call the Codian MCU with IP "10.2.1.33", and try to join a conference with numeric identifier "00000", type 10.2.1.33 ! 00000.

$

To include any of the digits from the incoming called number in the outgoing number, specify a substitution, by typing the dollar sign ($), followed by a index. Valid indices are:
A: substitute the entire incoming called number.
1 to 9 : substitute the digits enclosed in the nth set of parentheses of the condition.

Example: for all calls matching the condition of "55 (DDDD)", set an action to call the MCU with name "my_mcu" and join the call to the conference with identifier that matches "(DDDD)". For this example, type the action of my_mcu ! 00 $1. In this case, an incoming call to "551234" will attempt to join conference with numeric identifier "001234" on the Codian MCU with the name "my_mcu".

Note that if the substitution creates an empty number, the call will be rejected; in the above example, an incoming call to 55 would result in an empty substitution.