VOS3000 dial plan patterns
Plain prefix rules cover most jobs. These patterns cover the rest: random caller IDs, whole-number replacements and rules by number length.
Updated · By the VOS3000 Web team
Quick answer: A VOS3000 dial plan replaces an original prefix with a target prefix. Beyond plain prefixes it supports * (any number), ? (one digit, or a random digit in the target), ranges such as 8008100-8008121, several targets separated by ;, $ to keep a digit, and the L, E and G length rules. The longest matching original prefix wins and * is tried last.
- Fields
- Caller and Callee Rewrite Rule/Dial plan
- Rule text
- original:target, pairs separated by commas
- Which rule wins
- The longest matching original prefix
- Lowest priority
- The * pattern
A dial plan is set in the same fields as rewrite rules: Caller Rewrite Rule/Dial plan and Callee Rewrite Rule/Dial plan on mapping and routing gateways, and the dial plan fields of phones, bind numbers and outbound registrations. For the basic original:target format and simple prefix examples, start with rewrite rules and dial plans. This page covers the special characters from the VOS3000 2.1.9.07 manual.
How a dial plan works
Each rule has an original prefix (what the number starts with) and a target prefix (what replaces it). In the rule text the pair is written original:target, and rules are separated by commas. In the desktop client and in VOS3000 Web you can also edit them as a table with one rule per row.
Which rule wins
When several rules match, VOS3000 uses the one with the longest matching original prefix. With the rules 0 to 0 and 010 to 025, the number 01012345678 becomes 02512345678, because 010 is longer than 0. The pattern * has the lowest priority: it is used only when no other rule matches.
Pattern examples
| Original | Target | Number | Result | What it does |
|---|---|---|---|---|
| 0 | 0 | 02584316146 | 02584316146 | Leaves numbers that start with 0 unchanged. |
| 010 | 025 | 01012345678 | 02512345678 | Replaces the prefix 010 with 025. |
| 025 | 02584316146 | 84316146 | Removes the prefix 025. | |
| * | 025* | 117 | 025117 | Adds 025 in front of every number. |
| 025* | 010 | 02584316146 | 010 | Replaces the whole number with 010. |
| * | 12345678 | 02584316146 | 12345678 | Replaces every number with 12345678. |
| * | 02584316146 | Deletes the whole number. | ||
| 025* | 8008100-8008121 | 02584316146 | 8008100 … 8008121 | Replaces the number with one from the range. |
| * | 12345?78 | 02584316146 | 12345178, 12345278… | Each ? in a target becomes a random digit. |
| * | 12345678;8008100-8008121 | 02584316146 | One of the targets | Picks one of the targets, separated by ;, at random. |
| 0??8431 | 8431 | 02584316146 | 84316146 | In an original prefix, ? matches any one digit. |
| 0134 | $$$ | 0134131 | 013131 | Each $ keeps the digit in that position. |
Random caller IDs
Ranges, ? and ; are how operators rotate caller IDs from a pool on a caller dial plan. Only send numbers you have the right to use: many carriers reject or block calls with caller IDs that are not yours, and the call may end with an error from the carrier.
Rules by number length: L, E and G
A letter followed by a number in the original prefix adds a length condition:
- L: the number is shorter than the given length.
- E: the number is exactly the given length.
- G: the number is longer than the given length.
For example, an original prefix like 13E11 is meant for numbers that start with 13 and are 11 digits long. The examples in the manual are not consistent here, so test a length rule with a few calls and check the result in the CDR before you rely on it. To refuse numbers by length instead of changing them, use Number limit on the gateway's Others tab.
Test before you save
Our rewrite rule tester checks plain prefix rules such as 00:,1:001. It does not evaluate wildcards, ranges or length rules, so for those make a test call and look at the Caller and Callee columns in Recent CDR; see VOS3000 CDR.
Questions about this topic
How do I add a prefix to every number in VOS3000?
Use * as the original prefix and the prefix followed by * as the target, for example * to 025*, which turns 117 into 025117.
Which VOS3000 dial plan wins when two match?
The one with the longest matching original prefix. The * pattern is only used when nothing else matches.
How do I send a random caller ID from a range?
Use a range or ? as the target, for example 8008100-8008121 or 12345?78. Each ? becomes a random digit.
Try every step in the live demo
Each screen in this guide is in the VOS3000 Web demo, with made-up data. Sign in with demo / demo.
Keep reading
Rewrite rules and dial plans
The initial:destination format, prefix allow and forbidden lists, number lengths.
Rewrite rule tester
Paste a dial plan like 00:,1:001 and a number, and see what VOS3000 sends.
Add a routing gateway
Set up a vendor route: prefix, IP and port, priority and least-cost options.
Add a mapping gateway
Set up a customer gateway: types, IPs, line limits, prefixes and billing.