VX has the ability to translate incoming calling names and numbers. Name and Number translation can be useful for normalizing all incoming calls to a particular type of Calling Number (turning all displayed numbers into their corresponding extension numbers), etc.

To substitute a user's AD Display Name as the Calling Name, add the attribute displayName to the ActiveDirectory | Attributes section in VXbuilder.

To substitute a user's AD Display Name as the Calling Name, you must also supply a user-friendly name for the displayName AD Attribute. Select displayName from the AD Field pull-down and supply your own user-friendly name in the Description field.

Example AD Attributes

The following AD Attributes have been used in the Calling Name and Number translation examples.


AD Attribute Fields

AD Attribute fields

AD Attribute values

Display name

Troy

Telephone Number

+15105741114

E-mail

trop@vx.net

Mobile

+14083489775

Fax

+15105744064

Number Translation

Configure the InNum Using AD Field to select the AD Attribute to search using the Calling Number.

Configure the OutNum Using AD Fieldto select the AD Attribute used for the translated Calling Number. The Calling Number will only be translated if the Input Number find an AD match.

Given a call from phone number +14083489775, and the above AD Attribute settings, the Calling Number will go through the following translation:

Incoming Invite

INVITE sip:+9998@10.1.1.75 SIP/2.0

Via: SIP/2.0/UDP 10.1.1.30:5060;branch=z9hG4bK-2c8e66e6-683063.859

From: <sip:+14083489775@10.1.1.75>;tag=3ff0b5ff

To: sip:+9998@10.1.1.75

Outgoing Invite

INVITE sip:9998@demo4.vx.net;user=phone SIP/2.0

Via: SIP/2.0/TCP 10.1.1.75:5060;branch=z9hG4bK7479ac933e56

Max-Forwards: 69

To: <sip:9998@demo4.vx.net;user=phone>

From: <sip:+15105741114@demo4.vx.net>;tag=6fcb000e

The mobile number in the Incoming From: has been translated to outgoing Telephone Number in AD.

An OCS > PBX/PSTNcall may have a calling number that includes a +. A calling number preceded by a + may cause the calling name not to be displayed. In these cases, using a calling name translation to remove the + may result in the restoration of the calling name.

Name Translation

In addition to the InNum and OutNum Using AD Fields, translating the Calling Name requires the OutName Using AD field to be set.

Given a call from phone number +14083489775, and the above AD Attribute settings, the Calling Number and Name will go through the following translation:

IP address shown in Incoming/Outgoing Invites are IPv4 addresses. Both IPv4 and IPv6 are supported.

Incoming Invite
INVITE sip:+9998@10.1.1.75 SIP/2.0
Via: SIP/2.0/UDP 10.1.1.30:5060;branch=z9hG4bK-511e850c-692051.329
From: <sip:+14083489775@10.1.1.75>;tag=6e83ad93
To: *sip:+9998@10.1.1.75*
Outgoing Invite
INVITE sip:9998@demo4.vx.net;user=phone SIP/2.0
Via: SIP/2.0/TCP 10.1.1.75:5060;branch=z9hG4bK444f99a05e40
Max-Forwards: 69
To: <sip:9998@demo4.vx.net;user=phone>
From: "Troy" <sip:+15105741114@demo4.vx.net>;tag=2a5b0010