Dial Permissions/Dial Translations 101

MamtaClient Success ManagerMamta has been with netsapiens for about 8 years; with a background in Organization Development. She has worked with many aspects of netsapiens; including support, training, deployment, and sales.

@BuchMamta

Buch

Agenda

• What are Dial Permissions?• Dial Permissions Best Practices• Dial Permission Chaining• What are Dial Translations?• Configuring Dial Translations• Dial Translation Chaining• Labs

Dial Permissions

What Do They Do?

Restrict dialing access• Can be created to use across the system or

just for specific domains.• Can be applied to users, domain (domain

user), and connections.• Rules can be built as “allow all but X” or

“deny all but X.”• Chaining added in 1224.• One of your best toll fraud tools!

Dial Permissions

Best Practices

• Give the least access needed for all cases• Be safe by default.• Domain user’s dial permissions will apply to

new users.• The UI Configuration parameter

PORTAL_DOMAINS_DIAL_PERMISSION sets the Domain user dial permission upon creation.

Dial Permissions

Dial Permission Chaining

• Simplifies your dial permissions.• Prevents having to duplicate a similar set of

rules just to add a few exceptions.• Changes made to dial patterns, dialing

codes etc., can be effected across the system immediately.

Dial Permissions

Dial Permission ChainingYou would like to allow a customer to dial US and Canada (but not

it’s territories), Germany and Australia ONLY.

Dial Permissions

1

2

3

Dial Permission ChainingDial Permissions

Dial Permission ChainingDial Permissions

5

7

6

Dial Translations

Dial Translations

Core Module

DialTranslations

Core of the Core

What Are They?

• Dial translations match on the from and tofields in an INVITE and then; • Enact the configured call applications and;• Can manipulate the source and destination fields

Received Packet from 20.125.49.25:5060INVITE sip:18005551212@foo.com;user=phone SIP/2.0Via: SIP/2.0/UDP 192.168.1.2;branch=z9hG4bK679d811d9968D01EFrom: "John Doe" <sip:1000@foo.com>;tag=A07CFB9B-3DFC86F2To: <sip:18005551212@foo.com;user=phone>

Dial Translations

Source & Destination Fields

• * matches anything • [*] matches a literal *• %23 is #• [2-4] matches 2, 3, or 4 (also works with

letters)• [a-Z] matches all uppercase and lowercase

letters• ? matches a single character

Dial Translations

Destination & Source Translation

• Source is the calling party, Destination is the called party.

• Syntax for Source and Destination is: user@host

• Name is for Caller ID Name• [*] leaves value as-is (not like matching!)• [!*] removes the leading character (can use

multiple ‘!’)• 1[*] adds 1 (can add leading letters or

numbers)

•Source: anything•Destination: sip:something•Application: To Connection (call out)•Dest User: add 1 and user area code

Outbound CallingDial Translations

•Source: anything•Destination: 10 digits (no sip: or @*)•Application: To Connection (call out)•Dest scheme: change to sip:•Dest User: add digits if necessary; in this case a 1

Call ForwardingDial Translations

•Source: anything•Destination: Flag name•Application: To User•Dest scheme: change to sip:•Dest User: change as needed; in this case, to operator. Other examples: ToUserNotFound, VMailEscape

System FlagsDial Translations

Translation Tokens

Caller - origination callerOwn - user associated with callTo - termination caller

<[Caller/Own/To]Dept> - user dept<[Caller/Own/To]Domain><[Caller/Own/To]Scope> - login scope<[Caller/Own/To]Site> - user site field<[Caller/Own/To]Territory> - reseller<[Caller/Own/To]User> - user extension/user component of the URI<[Caller/Own]CidName> - user CID Name field/call CID name<[Caller/Own]CidNmbr> - user CID Number field/call CID number<[Caller/Own]CidEmgr> - user CID emergency field

Dial Translations

Translation Tokens (cont.)

• <Anonymous> - Set Privacy• <ShowCallerId> - Overrides Anonymous• <OwnAreaCode> - Area code field of user

What Are The Available Dial Translation Tokens?

Dial Translations

Application Parameters

Accepted Formatting Text• <CRLF> - new line• <LT> - open bracket (Less Than) <• <GT> - close bracket (Greater Than) >

Example #1 - Adding P-Charge-Info using the To Device Add Header Responder

• <LT>sip:<OwnCidEmgr>@<OwnDomain><GT><CRLF>Alert-info: <OwnDept>

Example #2 – Adding Alert-Info using the To User Add Header Responder• Alert-Info: <LT>Internal<GT>

Example #3 – Adding Call Parks using the Call Queuing Responder• 701,702,703

This field is used to pass extra information in the Invite Header.

Common uses are the adding of:

• billing related information,

• information to allow for distinctive ringtones and,

• pre-determined call parks for dynamic call parking

Additional Info

Dial Translation Chaining

• Share common rules in one place - reduce errors and increase maintainability• Reduce ambiguity of the dial plan (i.e. is this a 3 digit

rule with a prefix or a 4 digit rule)• Separate out features by client type (Cloud PBX,

residential, SIP trunk, etc)• Make the system cleaner by keeping Dial

Translations shorter • Use PORTAL_DOMAINS_DIAL_PLAN to set the DT to

chain on new domain creation

What Is The Recommended Practice For Chaining Dial Translations?

Dial Translations

Chaining ExampleDial Translations

bobstowing.com

Shared Features(Star Codes)

Forward Blocking

Default(outbound calls)

smith-resi

ResidentialCloud PBX Features

(on-net calls)

shoebuy.com-PRI

SIP Trunks/PRI Gateway

Matching & Chaining

• A call matches the most specific rule of the dial translation, that is, a call to sip:3101@foo matches sip:3[0-9][0-9][0-9]@* and sip:????@*and * – but the first one will be used• You can chain dial translations by selecting the

application <<Dial Plan>> then create/modify, you can then enter <DP Name>. You can chain multiple sequentially by entering <DP1><DP2>• Users and connections have an associated dial

translation which is where it will start processing a call

Dial Translations

Matching & Chaining

Write very specific rules to avoid problems• [2-9]????????? as a forwarding rule also

matches• 2343@fooco• [2-9][0-9][0-9][2-9][0-9][0-9][0-9][0-9][0-9][0-9] is

a better rule• ??? as a 3 digit extension forward rule also

matches• Midcall DMTF ***• [1-8][0-9][0-9] is a better rule

Dial Translations

• Auto attendants optionally start with an Announce then go to Prompt.• During the Announce message NO input is

expected.• You can build your own Case_ statements!

– Prompt_366443.Case_22 would allow for option 22.

– This would not be shown in the Portal.

Auto AttendantsDial Translations

LabDial Translations

• Where should this dial rule be added?

• Change Source Name & Source User information

Your customer has local numbers in a variety of area codes: 425.555.1212, 206.444.1000 and 360.888.1000.

When they call a 425 area code number, they want their 425 number to be displayed, when dialing a 206 number they want their 206 number to be displayed, etc.

Changing Outbound CID

LabDial Translations

Slight Problem; it does not work!!!!

Changing Outbound CID

• The default configuration has a value of yes for the System Configuration parameter OutForcCidRplc

• This force the From-URI to be replaced by the user’s Caller ID Name and Number

• If you wish to manipulate Source Name and Source User this has to be changed to no

• This is changed in the Admin UI of the Core Module in System > Settings > Advanced > Properties

LabDial Translations

A call comes to your cell phone as part of a sim ring that has been configured.

You have now reached the office and you want to take the call from your desk phone

Continue Call from Office Phone

• Where should this dial rule be added?

• What should you make sure to avoid?

LabDial Translations

Make a number “GEEK” (4335) that any customer can dial to reach your support queue.

Prefix the Caller ID name with the Domain and Reseller Group

Support Call From Any Domain

• Where should this dial rule be added?

• What should you make sure to avoid?

Questions?

Thank You!

1. Download the presentation by visiting our event site at bit.ly/NSUGM17.

2. Make sure that your dial translations are dial permissions are working for you! Contact us for assistance.

3. Join us for Call Trace Analysis - Thursday at 1pm.