Dial Permissions/Dial Translations 101

Transcription

1 Dial Permissions/Dial Translations 101

2 Mamta Buch Client Success Manager Mamta 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

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

4 Dial Permissions

5 What Do They Do? Dial Permissions 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 One of your best toll fraud tools!

6 Best Practices Dial Permissions 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.

7 Dial Permission Chaining Dial Permissions 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.

8 Dial Permission Chaining Dial Permissions You would like to allow a customer to dial US and Canada (but not it s territories), Germany and Australia ONLY

9 Dial Permission Chaining Dial Permissions

10 Dial Permission Chaining Dial Permissions 5 6 7

11 Dial Translations

12 Dial Translations Core Module Dial Translations Core of the Core

13 What Are They? Dial Translations Dial translations match on the from and to fields in an INVITE and then; Enact the configured call applications and; Can manipulate the source and destination fields Received Packet from :5060 INVITE SIP/2.0 Via: SIP/2.0/UDP ;branch=z9hG4bK679d811d9968D01E From: "John Doe" To:

14 Source & Destination Fields Dial Translations * 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

15 Destination & Source Translation Source is the calling party, Destination is the called party. Syntax for Source and Destination is: 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)

16 Outbound Calling Dial Translations Source: anything Destination: sip:something Application: To Connection (call out) Dest User: add 1 and user area code

17 Call Forwarding Dial Translations Source: anything Destination: 10 digits (no sip: Application: To Connection (call out) Dest scheme: change to sip: Dest User: add digits if necessary; in this case a 1

18 System Flags Dial 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

19 Translation Tokens Dial Translations Caller - origination caller Own - user associated with call To - 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

20 Translation Tokens (cont.) Dial Translations <Anonymous> - Set Privacy <ShowCallerId> - Overrides Anonymous <OwnAreaCode> - Area code field of user What Are The Available Dial Translation Tokens?

21 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>Alertinfo: <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 Additional Info 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

22 Dial Translation Chaining Dial Translations 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?

23 Chaining Example Dial Translations bobstowing.com shoebuy.com-pri smith-resi Cloud PBX Features (on-net calls) SIP Trunks/PRI Gateway Residential Shared Features (Star Codes) Forward Blocking Default (outbound calls)

24 Matching & Chaining Dial Translations 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

25 Matching & Chaining Dial Translations 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

26 Auto Attendants 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_ Case_22 would allow for option 22. This would not be shown in the Portal.

27 Lab Dial Translations Where should this dial rule be added? Change Source Name & Source User information Changing Outbound CID Your customer has local numbers in a variety of area codes: , and 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.

28 Lab Dial Translations 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 Changing Outbound CID Slight Problem; it does not work!!!! This is changed in the Admin UI of the Core Module in System > Settings > Advanced > Properties

29 Lab Dial Translations Where should this dial rule be added? What should you make sure to avoid? Continue Call from Office Phone 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

30 Lab Dial Translations Where should this dial rule be added? What should you make sure to avoid? Support Call From Any Domain 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

31 Questions?

32 Thank You! 1. Download the presentation by visiting our event site at bit.ly/nsugm 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.