Configuring Smart Call (Dial Plan) Settings
From Voxalot FAQ
A Smart Call Rule (dial plan) is a mechanism that allows you to tell Voxalot which providers should be used for which calls. For example, lets say that you have registered two providers' details with Voxalot, and one of them has good rates for overseas calls, and the other has good rates for domestic calls. You can use a dial plan to describe your international dialing prefix and Voxalot will select the appropriate provider for you so as to minimize your call costs.
You can have as many Smart Call Rule (dial plan) entries as you need. Each Smart Call Rule (dial plan entry) has a field called Priority that is used to determine what order the rules get evaluated by Voxalot. You can choose to use either the Basic or Advanced rule descriptions, depending on your level of technical expertise.
Contents |
Basic Smart Call Rules (Dial Plans)
- Once you are logged in, click on the Smart Call (Dial Plans) link in the right-hand menu. From there, you can either add new rules or edit existing ones.
- To add a new entry, click on the Add button.
- On this screen, you will be asked to enter some information about your rule.
|
In the example above, any number that begins with 04 will be sent to the Pennytel provider.
Advanced Smart Call Rules (Dial Plans)
To realize the true benefits of Smart Call Rules (dial plans), you need to use Advanced Rules. We will first look at how dial plans work. An advanced dial plan has 5 main sections:
- Priority - straight forward - what order is the dial plan executed.
- Pattern - a string that defines the pattern used to match dialed numbers (see below).
- Replacement - this value allows you transform the dialed number before passing it onto the corresponding voice service provider.
- Provider - which provider to use to connect the call.
- ENUM Replacement - this value allows you transform the dialed number before performing an ENUM lookup. Typically ENUM lookups require the dialed number to be prefixed with a country code.
Let's look at each section one at a time.
Priority
This is easy. It is just the numerical order in which Voxalot will search your rules trying to find a match. It will start at the lowest numbered priority rule and check for a match. If no match, it will go to the next lowest numbered priority rule, and keep going until it finds the first match.
Pattern
A pattern is a string of characters against which a dialed number will be compared. The dialed number with either "match" or "not match" the pattern. There are only a few rules for the pattern
* All dial plan patterns must begin with an underscore _
* X matches any digit from 0-9
* Z matches any digit from 1-9
* N matches any digit from 2-9
* [ ] matches any digits in the brackets. eg [25] will match 2 and 5.
* . wildcard (full stop), matches one or more characters
Here are some examples
_9XXXXXXX matches 98175555 etc
_9817XXXX matches 98175555 but not 92595555 etc
_13ZXX. matches 131241 but not 1300 123 456 (because the Z excludes 0 as an option)
Replacement
Replacement is the method to replace (or add) one or more digits to your dialed number after it has been matched.
The replacement syntax is Prefix${EXTEN:count1:count2}Suffix where count1 and count 2 are optional. Let's look at the various parts.
1. $[EXTEN} This is the default replacement string, and it IS the dialed number. eg if you dialed 98175555 and it matched your pattern, then ${EXTEN} = 98175555.
2. Count1 can be a positive integer or a negative integer. If it is a positive integer then we skip that number of digits from the left.
eg if you dialed 0298175555 and it matched your pattern, then
${EXTEN:2} = 98175555
${EXTEN:6} = 5555 etc
If Count1 is a negative integer, you drop that number of digits off of the end of the string.
eg if you dialed 0298175555 and it matched your pattern, then
${EXTEN:-4} = 029817
${EXTEN:-6} = 0298
3. Count2 can only be used if Count1 is used. Together they specify a starting point in a dialed phone number, and the number of characters to be taken. Count2 can only be a positive integer and indicates how many digits should be counted from the point indicated by Count1.
eg if you dialed 0298175555 and it matched your pattern, then ${EXTEN:2:4} = 9817
(ie skip the first 2 digits, then take the next 4 digits
4. A Prefix and/or Suffix may be added to your dialed number.
eg if you dialed 98175555 and it matched your pattern, then 612${EXTEN} = 61298175555
eg2 if you dialed 0298175555 and it matched your pattern, then 61${EXTEN:1} = 61298175555
Provider
Simply select one of the voice service providers that you have registered with Voxalot from the drop down list. This provider will be used for all calls matching the pattern you have set up (including those that matched the pattern but didn't find an ENUM match (see below).
Simplesmente selecione um dos provedores de serviço de voz que você registrou com Voxalot da gota abaixo lista. Este provedor será usado para todas as chamadas que emparelham o padrão você montou (incluindo esses que emparelharam o padrão mas não achou uma partida de ENUM (veja abaixo).
ENUM Replacement
ENUM Replacement follows exactly the same rules covered in the Replacement section above. Once defined, Voxalot will use the ENUM Replacement value to transform the dialed number before performing an ENUM lookup. Some voice service providers don't allow you to call a number with a leading country code ie 612 xxxx xxxx. However ENUM lookups must use this format. Voxalot therefore caters for both.
Substituição de ENUM segue as mesmas regras cobertas na seção de Substituição acima exatamente. Uma vez definido, Voxalot usará o ENUM Substituição valor para transformar o número discado antes de executar um lookup de ENUM. Alguns expressam os provedores de serviço não lhe permitem chamar um número com um ie de código rural principal 612 xxxx de xxxx. Porém lookups de ENUM têm que usar este formato. Voxalot satisfaz ambos então. This is how it would work:
- you dial 98175555
- It finds a match in your number pattern
- The dial plan has Replacement set as 02${EXTEN} = 0298175555
- Your Provider was set as Engin
- Your ENUM Replacement was set as 612${EXTEN} = 61298175555
Voxalot first checks to see if there is an ENUM match for 61298175555. If not, it goes ahead and routes the number 0298175555 to Engin and the call is placed as normal.
Example
1. As with the Simple plan entries, click on the Smart Call (Dial Plans) link in the right-hand menu.
2. Click on the Add button the the Advanced Settings button at the top of the rule entry panel. You will see a page like this:
3. On this screen, you will be asked to enter some information about your rule.
|
In the example above, any number that begins with 04 will be checked for a ENUM match, then sent to "Pennytel" if no match is found.
If you are unsure of what value to put in any of the fields, please feel free to visit our Support Forum
Example Dial Plans
| Pattern | Replacement | ENUM Replacement | Comments |
| _NXXXXXXX | 02${EXTEN} | 612${EXTEN} | If you call any 8 digit number starting with 2-9, then prepend 612 for ENUM and prepend 02 for your VSP. This assumes you are in the Sydney local call region. |
| _0[235-9]XXXXXXXX | ${EXTEN} | 61${EXTEN:1} | If you call any STD number, then remove the 0 from the front, prepend 61 for ENUM. If no match, pass the number as is to your VSP. |
| _1[38]00XXXXXX | ${EXTEN} | 61${EXTEN} | If you call 1300 or 1800 then prepend 61 for ENUM. |
| _04XXXXXXXX | ${EXTEN} | 61${EXTEN:1} | If you call any mobile number, then remove the 0 from the front, prepend 61 for ENUM. If no match, pass the number as is to Pennytel. |
| _0011. | ${EXTEN} | ${EXTEN:4} | If you make an international call, scrape away the 0011 |
| _XXX. | ${EXTEN} | ${EXTEN} | send any other number for ENUM then back to Engin. It is important not to use _X. in your dial plan, because the number 500 is used to check your voice mail. If you use _X. in a dial plan, all >1 digit numbers will be forwared to your VSP and you wont be able to check your voice mail. |
 |
Languages: |
English |
