Sharpen Dial Plan Help

Sharpen Dial Plan allows customers to configure and control specific dialing functions and routing, in order to meet various business needs. Sharpen Dial Plan is not required for customers to use, but is often utilized in cases where customers have configured Inbound and/or Outbound SIP trunks along with their Sharpen Org. For more information on SIP Trunk configuration, please see the Outbound and Inbound requirements docs.

The Dial Plan tool is built for maximum flexibility, allowing for sophisticated pattern matching and regex functions.

WARNING : This tool can directly affect all dialing functions in your Sharpen org and could cause undesirable effects if incorrectly configured. Please use with caution!

*Note: Changes made in the Dial Plan take effect immediately after successfully saving

Here are some common use cases, along with Dial Plan setting examples

1. Input Filter Regex (Regular Expressions)

   1. (non regex) : Simple routing, direct one to one mapping

      1. Examples: No pattern matching or capture groups used

         1. Same number forward - 5123 is entered, and 5123 is sent

         2. Different number forward - 5123 is entered and 5555 is sent

   2. # : One single-digit integer [0-9]

      1. Examples:

         1. Input Filter: 8{####}. Output to Dial: {0}. A user types in 89999 as an input. This will output 89999. Or a user types in 81234. This will output 81234. 

   3. % : One single alphanumeric character [0-9][a-Z]

      1. Examples:

         1. Input Filter: %999. Output to Dial: 123. A user types in A999 as an input. This will output 123. Or a user types in 1999. This will output 123. If the user types in 999, it will not match.

   4. ? : Zero-to-one alphanumeric characters [0-9][a-Z]

      1. Examples:

         1. Input Filter: ?8121112222. Output to Dial: 8121112222. A user types in 18121112222 as an input. This will output 8121112222. Or a user types in 81234. This will output 81234. 

   5. * : Zero-to-many alphanumeric characters [0-9][a-Z]

      1. Examples:

         1. Input Filter: *9999. Output to Dial: 8121234. A user types in 9999 as an input. This will output 8121234. Or a user types in 123459999. This will also output 8121234. 

         2. Input Filter: 9*9. Output to Dial: 8121234. A user types in 99 as an input. This will output 8121234. Or a user types in 91234567899. This will also output 8121234.

   6. { } : Capture groups

      1. Always paired with a capture group in the Number to Dial column. Always has one or more other regex characters inside (#, %, ?, *). Each set of curly braces corresponds to a number inside the braces in the Number to Dial column (the first set of braces corresponds to the {0}’s set in the Number to Dial column). Capture groups are only needed if there is something in your input which needs to be added to the output. 

      2. Examples:

         1. Input Filter: 812{*}. Output to Dial: 765{0}. A user types in 8121112222 as an input. This will output 7651112222.

         2. Input Filter: 812{####}. Output to Dial: 765{0}. A user types in 8122222 as an input. This will output 7652222.

2. Output to Dial Regex

   1. { } : capture group

      1. Notes: Always paired with a capture group in the Input Filter column. Always has integers between the braces, which corresponds to the nth capture group in the Input Filter column.

      2. Examples:

         1. Input Filter: 12{##}. Output to Dial: 12{0}. A user types in 1233 as an input. This will output 1233.

         2. Input Filter: 12{#}9{#}. Output to Dial: 12{0}{1}. A user types in 12394 as an input. This will output 1234.

         3. Input Filter:{####}. Output to Dial: 812{0}. A user types in 4567 as an input. This will output 8124567.

3. Notes:

   1. Digits in inputs will be matched directly.

   2. Letters in inputs will be converted into digits prior to evaluation. The conversion rules are:

      1. 2: a b c

      2. 3: e d f

      3. 4: g h i

      4. 5: j k l

      5. 6: m n o

      6. 7: p q r s

      7. 8: t u v

      8. 9: w x y

   3. Letters in outputs will be dialed as is. For example, 123A will be dialed out as 123A without any conversion of the A to a digit.

   4. Each row in the Input Filters column can have multiple Filters. Only one filter in a row needs to be matched for the entire rule to be considered a match.

4. UI routing of dial plan rules: