Each Dialplan procedure can contain multiple called numbers.
Trunks example:
Your company uses 3 numbers, one for technical assistance, one for sales and one for faxes - you can add all of them inside the “main” Dialplan procedure and depending on the called number, the system will route the call to the destination you indicated.
Users example:
The calls placed by users can be routed via different trunks or trunk groups depending whether it is a local call, an international call, a call to another country where you have a branch office and a PBX installed, a call to a mobile number, etc.
For instance, in Germany mobile numbers begin with 15, 16, 17 or 18. We can add “1[5-8].” as a called number inside “users” procedure and in case a user calls a number starting with 15 or 16, the system routes this call through a different trunk than a international call or a landline call.
Another example: your company has a branch office, for instance, in France, you can route all outgoing calls to France (calls with French prefix) via your remote PBX installed in France and save significantly on international calls, because they will be charged as local ones.
Called number can be:
An exact match: a simple phone number (an extension number or an external number), example: 1220.
Pattern: a sequence of numbers and special characters allowing you to match all the numbers that correspond to the specified criteria, example: 12XX - any number containing four digits which start from “12” (1200, 1211, 1245 etc)
Syntax to match a pattern:
X (uppercase X): any digit from 0 to 9
. (point): one or more characters from 0 to 9 of any length
[ ] (square brackets): any digit from those specified inside the brackets
Z (uppercase Z): any digit from 1 to 9
N (uppercase N): any digit from 2 to 9
! (exclamation point): zero or more characters
Examples:
0. – the numbers starting with 0 followed by a one digit or a sequence of digits (typically used for direct calls to the public line)
1XX – the numbers starting with 1 followed by two other digits, e.g. 125, 167
[37]2X – the numbers starting with 3 or 7, followed by 2 and by any other digit, e.g. 326, 728
X. – all the calls from any numbers
[1237-9] – matches 1,2,3,7,8,9
XXX! – all numbers containing three or more characters (while XXX. matches all numbers containing at least four characters)
“default” destination
Called number “default” is added when it’s necessary to include all the possible called numbers. Be careful using “default” destination!
Normally “default” is added to give the notification to the caller that the number dialed is incorrect (no match to a called number was found inside the Dialplan procedure)
11.4. Included procedures
The section “Included procedures” allows you to add the called numbers that must be analysed after the content of the current procedure.
In this way you can create the correct order of operations’ execution in case several patterns (called number prefixes, for instance) come into conflict within the same Dialplan procedure.
Example of how to differentiate national and international calls where “0” is the prefix for external line engagement, “000” is the prefix for international calls:
The called number “0.” for national calls and “000.” for international ones come into conflict, since “0.” is valid both for the numbers starting with 0 and for those starting with 000.
To resolve this issue:
Create a dialplan procedure “national” containing the called number “0.”
Create a dialplan procedure “international” containing the called number “000.”
Add “national” to “Included procedures” inside the “international” procedure
As a result, the system verifies if the called number matches the sequence “000.”, if not, it verifies if it matches the sequence “0.”
NOTE: The procedure “pbxinternal (Users and call features/services dialplan)” is already present on the list of Included procedures for Internal Dialplan procedure (“users”), which by default enables the users to call each other and to use the Feature Codes of the system and which is analyzed only after the content of the Dialplan procedure:
11.5. Dialplan applications
Dialplan applications are the operations (rules) executed one after another (in the priority defined by you) in case the match to the called number is found inside the Dialplan procedure.
Many Dialplan applications allow the change of the called number on the go. Many Dialplan applications require association to another Dialplan procedure.
Example:
You have the headquarters in Germany and a branch office in France. You would like to route the calls to French phone numbers through your remote PBX installed in France.
German PBX, “users” procedure:
Add the French prefix as a called number and add the Dialplan Application “Call through remote PBX” (“slave” in our example is the name of the French PBX, “users” is the name of the procedure present on the French PBX):
the call is routed through the French PBX, so inside the indicated “users” procedure on French PBX, the match for the indicated called number “00033.” must be present.
French PBX, “users” procedure:
Add the same called number “00033.” and click “set” to modify this called number:
Here is the result that we get: the call is routed to the French PBX, before dialling the trunk “local - 22” the system removes the first 5 digits from the called number (the number is normalized), so the number dialled in the international format (for example, 000331234567890), becomes a local French number (1234567890)
In the same way many other Dialplan applications allow modifying the called number or require association to another Dialplan procedure present on the same PBX (or on another PBX as in the previous example).
Modify called number
Example: the called number is 0323111
Select the Dialplan application that allows modifying the called number, for example “Dial the phone” → “Set”:
“Remove” - “2”: two first digits are removed, the number is changed to 231111
“prepend digits” - “00”: “00” is appended, the number is changed to 0023111
“Custom”: you can completely change the called number, for example, enter 1234: the number is changed to 1234
Jump to another procedure
In the same way, many Dialplan applications allow under certain conditions jumping to a different Dialplan procedure.
Example: you would like to treat incoming calls in a different way during the hours when your offices are closed.
Create a timetable “Closed” in WMS > Dialplan > Timetables / Switches and set up the state “check time”. It means that each time this Timetable is verified by the Dialplan, the system checks if your offices are closed at the moment, according to this timetable.
Edit the “main” procedure and add the application “Verify timetable” for your office phone number. In case your offices are closed, the Dialplan routes the call to another procedure called “Offices_closed”. You must separately create this Dialplan procedure in which, for example, you enable the system to play the audio message to the caller and send the call to Voicemail.
DOCUMENTATION:
Dialplan applications guide with practical examples: https://manuals.wildix.com/dialplan-applications/
PART 12. Dialplan practical examples
12.1. External Dialplan: “main”
12.1.1 Route incoming calls to call agents (call groups)
12.1.2 Record and playback audio messages
12.1.3 Create a switch
12.1.4 Create a timetable
12.1.5 Create an IVR tree
12.1.6 Incoming faxes management
12.1.7 DID and DISA
12.1.8 Mobility extension lookup
12.1.9 Example of “main” procedure configuration
12.2. Internal Dialplan: “users”
12.2.1 Example of “users” procedure configuration
In this part we will learn how to use the most popular Dialplan applications for managing outgoing and incoming calls.
Share with your friends: |