VOS3000 rewrite rules and dial plans
Change the numbers your switch sends and receives, and control which numbers a gateway accepts.
Updated · By the VOS3000 Web team
Quick answer: A VOS3000 rewrite rule (dial plan) is a comma-separated list of initial:destination pairs: when a number starts with the initial prefix, VOS3000 replaces it with the destination prefix. For example 00: removes a leading 00 and 0:44 turns a leading 0 into 44. Set them in a gateway's Additional Settings, on the Mapping prefix or Routing prefix tab.
- Format
- initial:destination, separated by commas
- Where
- Additional Settings, Mapping or Routing prefix tab
- Prefix lists
- Allow or Forbidden, comma-separated
- Number length
- Others tab, Number limit
Where they are
Open a gateway's Additional Settings (the sliders icon in the gateway list in VOS3000 Web, or the Additional settings column in the desktop client).
- Mapping gateway, Mapping prefix tab: Mapping caller prefix, Mapping callee prefix, Caller Rewrite Rule/Dial plan and Callee Rewrite Rule/Dial plan.
- Routing gateway, Routing prefix tab: Routing caller prefix, Routing callee prefix, Forwarding prefix, Call restriction on caller, and Caller and Callee Rewrite Rule/Dial plan.
The rewrite rule format
A rewrite rule (dial plan) is a list of pairs: an initial prefix and a destination prefix, written initial:destination. Pairs are separated by commas. When a number starts with the initial prefix, that prefix is replaced by the destination prefix.
| Rule | Effect |
|---|---|
| 00: | Removes a leading 00: 0044207… becomes 44207… |
| :44 | Adds 44 in front of every number. |
| 0:44 | Replaces a leading 0 with 44: 0207… becomes 44207… |
| 00:,1:001 | Two rules: removes a leading 00, and replaces a leading 1 with 001. |
In VOS3000 Web, click the … button next to the field to edit the rules as a table with Initial prefix and Destination prefix columns, and Add, Delete, Copy and Paste buttons. The panel writes the comma-separated text for you.
Use caller rules to change the calling number (CLI), for example to add a country code, and callee rules to change the called number, for example to strip a carrier's technical prefix.
Prefix lists: Allow or Forbidden
Each prefix list (Mapping caller prefix, Mapping callee prefix, Routing caller prefix, Routing callee prefix, Forwarding prefix) is a comma-separated list of number prefixes with an Allow or Forbidden switch. Allow means only numbers starting with one of the prefixes pass; Forbidden means those numbers are refused. In the editor each prefix is one row.
Call restriction on caller
On a routing gateway, Call restriction on caller takes pairs of caller and callee prefixes, written caller:callee and separated by commas, with an Allow or Forbidden switch. For example 025:010,021:023.
Number length limits
On the Others tab, Number limit sets the caller and callee number lengths a gateway accepts. Leave it empty for any length, enter lengths like 11,12, or a range like 10-13. Lengths from 1 to 31 are possible. Calls with other lengths are refused, usually with NumberLengthRestricted (-35).
Test your rules
After saving, make a test call and open it in Recent CDR: the Caller and Callee columns show the numbers as VOS3000 handled them. Calls refused by a prefix list end with reasons like CallerPrefixRestricted (-32) or CalleePrefixRestricted (-29); see termination reasons.
Questions about this topic
How do I remove a prefix in VOS3000?
Add a rewrite rule with the prefix as the initial part and nothing as the destination, for example 00: to remove a leading 00.
How do I add a prefix to every number?
Use a rule with an empty initial part, for example :44 adds 44 in front of every number.
What is the difference between Allow and Forbidden?
Allow lets only numbers that start with a listed prefix through. Forbidden refuses numbers that start with a listed prefix.
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
Dial plan patterns
Wildcards, number ranges, random digits, kept digits and length rules in VOS3000 dial plans.
Rewrite rule tester
Paste a dial plan like 00:,1:001 and a number, and see what VOS3000 sends.
Add a mapping gateway
Set up a customer gateway: types, IPs, line limits, prefixes and billing.
Add a routing gateway
Set up a vendor route: prefix, IP and port, priority and least-cost options.