Configuring Redirect Number Manipulation

Each redirect number manipulation table lets you configure up to 20 rules for manipulating the redirect number received in SIP messages. The redirect number manipulation tables include:

Redirect Number IP-to-Tel table: (Applicable only to ISDN) Defines IP-to-Tel redirect number manipulation. You can manipulate the value of the received SIP Diversion, Resource-Priority, or History-Info headers, which is then added to the Redirecting Number Information Element (IE) in the ISDN Setup message sent to the Tel side. This also includes the reason for the call redirection.
Redirect Number Tel-to-IP table: Defines Tel-to-IP redirect number manipulation. You can manipulate the prefix of the redirect number received from the Tel side, in the outgoing SIP Diversion, Resource-Priority, or History-Info headers sent to the IP side.

Configuration of redirect number manipulation rules includes two areas:

Match: Defines the matching characteristics of an incoming call (e.g., prefix of redirect number).
Action: Defines the action that is done if the incoming call matches the characteristics of the rule (e.g., removes a user-defined number of digits from the left of the redirect number).

The device searches the table from top to bottom for the first rule that matches the characteristics of the incoming call. If it finds a matching rule, it applies the manipulation configured for that rule.

If the device copies the received destination number to the outgoing SIP redirect number (enabled by the CopyDest2RedirectNumber parameter), no redirect number Tel-to-IP manipulation is done.
The manipulation rules are done in the following order: 'Stripped Digits From Left', 'Stripped Digits From Right', 'Number of Digits to Leave', 'Prefix to Add', and then 'Suffix to Add'.
The device uses the 'Redirect Prefix' parameter before it manipulates the prefix.

The following procedure describes how to configure redirect number manipulation rules through the Web interface. You can also configure these rules using the following management tools:

Redirect Number IP-to-Tel table: ini file [RedirectNumberMapIp2Tel] or CLI (configure voip > gateway manipulation redirect-number-map-ip2tel)
Redirect Number Tel-to-IP table: ini file [RedirectNumberMapTel2Ip] or CLI (configure voip > gateway manipulation redirect-number-map-tel2ip)
To configure a redirect number manipulation rule:
1. Open the required redirect number manipulation table (Setup menu > Signaling & Media tab > Gateway folder > Manipulation > Redirect Number Tel > IP or Redirect Number IP > Tel).
2. Click New; the following dialog box appears (e.g., Redirect Number Tel-to-IP table):

3. Configure a manipulation rule according to the parameters described in the table below.
4. Click Apply.

Redirect Number Manipulation Tables Parameter Description

Parameter

Description

General

'Index'

[Index]

Defines an index number for the new table row.

Note: Each row must be configured with a unique index.

'Name'

manipulation-name

[ManipulationName]

Defines a descriptive name, which is used when associating the row in other tables.

The valid value is a string of up to 40 characters.

Note: The parameter value can't be configured with the character string "any" (upper or lower case).

Match

'Destination Phone Pattern'

dst-pattern

[DestinationPrefix]

Defines the destination (called) telephone number.

You can use special patterns (notations) to denote the number. For example, if you want to match this rule to a number whose last four digits (i.e., suffix) are 4 followed by any three digits (e.g., 4008), then configure this parameter to "(4xxx)". For available patterns, see Patterns for Denoting Phone Numbers and SIP URIs.

The default value is the asterisk (*) symbol, meaning any destination number.

For manipulating the diverting and redirected numbers for call diversion, you can use the strings "DN" and "RN" to denote the destination prefix of these numbers. For more information, see Manipulating Redirected and Diverted Numbers for Call Diversion.

'Redirect Phone Pattern'

redirect-pattern

[RedirectPrefix]

Defines the redirect telephone number.

You can use special patterns (notations) to denote the number. For example, if you want to match this rule to a number whose last four digits (i.e., suffix) are 4 followed by any three digits (e.g., 4008), then configure this parameter to "(4xxx)". For available patterns, see Patterns for Denoting Phone Numbers and SIP URIs.

The default value is the asterisk (*) symbol, meaning any redirect number.

'Source Trunk Group ID'

src-trunk-group-id

[SrcTrunkGroupID]

Defines the Trunk Group from where the Tel call is received.

To denote any Trunk Group, leave this field empty. The value -1 indicates that this field is ignored in the rule.

Note: The parameter is applicable only to the Redirect Number Tel-to-IP table.

'Source IP Address'

src-ip-address

[SourceAddress]

Defines the IP address of the caller. The IP address appears in the SIP Contact header of the incoming INVITE message.

The default value is the asterisk (*) symbol (i.e., any IP address). The value can include the following wildcards:

"x": represents single digits, for example, 10.8.8.xx denotes all addresses between 10.8.8.10 and 10.8.8.99.
"*": represents any number between 0 and 255, for example, 10.8.8.* denotes all addresses between 10.8.8.0 and 10.8.8.255.

Note: The parameter is applicable only to the Redirect Number IP-to-Tel table.

'Source Host Pattern'

src-host-pattern

[SrcHost]

Defines the URI host part of the caller. The host name appears in the SIP From header of the incoming SIP INVITE message.

You can use special patterns (notations) to denote the host part. For example, if you want to match this rule to host parts that end (suffix) in ".com", then configure this parameter to "(.com)". For available patterns, see Patterns for Denoting Phone Numbers and SIP URIs.

The default value is the asterisk (*) symbol, meaning any source host part.

Note:

The parameter is applicable only to the Redirect Number IP-to-Tel table.
If the P-Asserted-Identity header is present in the incoming INVITE message, the value of the parameter is compared to the P-Asserted-Identity URI host name (instead of to the From header).

'Destination Host Pattern'

dst-host-pattern

[DestHost]

Defines the Request-URI host part, which appears in the incoming SIP INVITE message.

You can use special patterns (notations) to denote the host part. For example, if you want to match this rule to host parts that end (suffix) in ".com", then configure this parameter to "(.com)". For available patterns, see Patterns for Denoting Phone Numbers and SIP URIs.

The default value is the asterisk (*) symbol, meaning any destination host part.

Note: The parameter is applicable only to the Redirect Number IP-to-Tel table.

Action

'Stripped Digits From Left'

remove-from-left

[RemoveFromLeft]

Defines the number of digits to remove from the left of the redirect number prefix.

For example, if you enter 3 and the redirect number is 5551234, the new number is 1234.

'Stripped Digits From Right'

remove-from-right

[RemoveFromRight]

Defines the number of digits to remove from the right of the redirect number prefix.

For example, if you enter 3 and the redirect number is 5551234, the new number is 5551.

'Number of Digits to Leave'

num-of-digits-to-leave

[LeaveFromRight]

Defines the number of digits that you want to retain from the right of the redirect number.

'Prefix to Add'

prefix-to-add

[Prefix2Add]

Defines the number or string that you want added to the front of the redirect number.

For example, if you enter 9 and the redirect number is 1234, the new number is 91234.

'Suffix to Add'

suffix-to-add

[Suffix2Add]

Defines the number or string that you want added to the end of the redirect number.

For example, if you enter 00 and the redirect number is 1234, the new number is 123400.

'TON'

ton

[NumberType]

Defines the Type of Number (TON).

[-1] = (Default) Not configured
[0] Unknown (default)
[1] International-Level2 Regional
[2] National-Level1 Regional
[3] Network-PSTN Specific
[4] Subscriber-Level0 Regional
[6] Abbreviated

The applicable values depend on the NPI value:

If NPI is set to Unknown, you can set TON to Unknown.
If NPI is set to Private, you can set TON to one of the following:
Unknown
International-Level2 Regional
National-Level1 Regional
Network-PSTN Specific
Subscriber-Level0 Regional
If NPI is set to E.164 Public, you can set TON to one of the following:
Unknown
International-Level2 Regional
National-Level1 Regional
Network-PSTN Specific
Subscriber-Level0 Regional
Abbreviated

For more information on available NPI/TON values, see Numbering Plans and Type of Number.

'NPI'

npi

[NumberPlan]

Defines the Numbering Plan Indicator (NPI).

[-1] Not Configured = (Default) Value received from PSTN/IP is used
[0] Unknown
[1] E.164 Public
[9] Private

For more information on available NPI/TON values, see Numbering Plans and Type of Number.

Note: The parameter is applicable only to digital interfaces.

'Presentation'

is-presentation-restricted

[IsPresentationRestricted]

Enables caller ID.

[0] Allowed = Sends Caller ID information when a call is made using these destination / source prefixes.
[1] Restricted = Restricts Caller ID information for these prefixes.

Note: If you configure the parameter to Restricted and the 'AssertedIdMode' parameter to Add P-Asserted-Identity, the From header in the INVITE message includes the following:

From: 'anonymous' <sip: anonymous@anonymous.invalid> and 'privacy: id' header.