You are here: Understand Tenant Dial Plans > Create Custom Dial Plans

Create Custom Dial Plans

Creating a custom dial plan requires a good understanding of regular expressions. This section gives a brief overview of creating a custom plan. You may seek guidance from professional services for creating a custom plan from scratch.

To create a custom dial plan:

  1. From the Configuration Menu, open Home.
  2. Go to the Dial Plans tab.
  3. Click to add a new dial plan.
  4. In the Add New Dial Plan window, enter the following information:
    Dial PlansDescription
    Dial Plan Name Enter a name for the new dial plan.
    Test Number Enter a telephone number to test your plan. A indicates which rule is being applied.
    Default PlanCheck the option to mark this as the default dial plan.
    OrderIndicates the order of the rules applied to each number. You can change the order of the rules in custom plans by dragging and dropping them in the desired location.
    Dialed String Match Pattern Define a calling number pattern to apply the dial plan using regular expressions. A regular expression provides a concise and flexible means for matching strings of text, or patterns of characters. Most commonly used regular expressions are:
    ^ - Matches the starting position of the string.
    . - Matches any single character.
    * - Matches the preceding element 0 or more times.
    $ - Matches the ending position of the string.
    [ ] - Matches a single character contained within the brackets. For example, [2-9] specifies any digit from 2 through 9.
    ( ) - A marked sub-expression within which you define a string to match.
    For example, the pattern ^([2-9][0-9][0-9][0-9][0-9][0-9][0-9])$ defines a 7-digit sequence where the first digit is not 0 or 1.

    Note: Defining a dial plan requires sound knowledge of regular expressions.

    Rewrite Translation Define the treatment for the number that matches the specified calling number pattern. For example, the pattern ^([2-9][0-9][0-9][0-9][0-9][0-9][0-9])$ and treatment 1650$1 prepends a 7-digit input with "1650". $1 represents pattern within the (). If you input 5551212, the treatment converts the number to 16505551212.
    Rule CommentGives a brief description of the treatment received by the rule.
    Delete RuleAllows you to delete the rule. This applies to user-defined rules only.
    Test MatchIndicates if the rule applies to the test number.
  5. Click to add a new rule. Click to delete a rule.
    Examples of dial plan rules shown above can be interpreted as follows:
    1. The pattern ^([2-9][0-9][0-9][0-9][0-9][0-9][0-9])$ and treatment 1650$1 converts a 7 digit input to 10 digits. For example, if you input 5551212, the number gets prefixed with the area code and converts to 16505551212.
    2. The pattern ^(55[0-9][0-9])$ and treatment 1650292$1 converts all 4 digit extension number starting with 55 to 165029255XX, where X is a mandatory single digit.
  6. Enter a sequence of digits and click Test to validate the calling number pattern and treatment you defined. The first matched rule shows to indicate a match.
  7. Click Save.

Variables

We have two types of variables in dial plans:

See Also

 


Send us your Feedback