VOS3000 how-to

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

OriginalTargetNumberResultWhat it does
000258431614602584316146Leaves numbers that start with 0 unchanged.
0100250101234567802512345678Replaces the prefix 010 with 025.
0250258431614684316146Removes the prefix 025.
*025*117025117Adds 025 in front of every number.
025*01002584316146010Replaces the whole number with 010.
*123456780258431614612345678Replaces every number with 12345678.
*02584316146Deletes the whole number.
025*8008100-8008121025843161468008100 … 8008121Replaces the number with one from the range.
*12345?780258431614612345178, 12345278…Each ? in a target becomes a random digit.
*12345678;8008100-800812102584316146One of the targetsPicks one of the targets, separated by ;, at random.
0??843184310258431614684316146In an original prefix, ? matches any one digit.
0134$$$0134131013131Each $ 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.