dial translations permissions 101 · •what are dial permissions? ... just for specific domains....
Post on 21-Jun-2018
283 Views
Preview:
TRANSCRIPT
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.
top related