Difference between revisions of "Provider Rules"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(31 intermediate revisions by 7 users not shown)
Line 1: Line 1:
= Description =
<br><br>
<br><br>
<big><big><big>'''Provider Rules transforms E.164 compatible number to any number format Provider requires.'''</big></big></big>
<big><big><big>'''Provider Rules transforms an E.164-compatible number to any number format the Provider requires.'''</big></big></big>
<br><br>
<br><br>
= Description =


Different providers expect different number formats from you. You can send them whatever they want using Provider Rules.
Different providers expect different number formats from you. You can send them whatever they want using Provider Rules.


They can be reached pressing [[Image:rules.png]] icon next to some provider in Providers window:
Provider Rules can be reached by clicking the [[Image:rules.png]] icon next to a provider in the Providers window:
 
<br><br>
[[Image:provrules1.png]]
[[Image:provrules1.png]]
<br><br>
We see a similar window as the one in Localization. The rules to manage Provider Rules are identical to those for Localization management, which are covered [[Number Manipulation | here]].


We see similar window as with Localization. The rules to manage Provider Rules are identical to Localization management which are covered [[Number Manipulation | here]].


Let's say our provider expects to get number with technical prefix 89765#. We can do this in following way:
<br><br>
= Destination Rules =


Let's say our provider expects to get a number with the technical prefix 89765#. We can do this in following way:
<br><br>
[[Image:provrules2.png]]
[[Image:provrules2.png]]
<br><br>
That's it – very simple. Now every number that is sent to this provider will be transformed by adding our created tech. prefix.
For example, if 37063042438 should be sent to this provider, this rule will be activated and the number 89765#37063042438 will be sent to provider.
'''REMINDER''': You can check whether Provider Rules are applied correctly in [[Call Tracing]]


That's it – very simple. Now every number which will be sent to this provider will be transformed adding our created tech. prefix.
<br><br>
== Special cases ==


Example: 37063042438 should be sent to this provider, so this rule will be activated and number 89765#37063042438 will be sent to provider.
=== Cut everything till Hash ===


'''REMINDER''': You can check if Provider Rules are applied correctly in [[Call Tracing]]
With rule '''Cut: *#''' it is possible to cut everything till # (# included) in the dialed destination:
<br><br>
[[Image:provider_rules_cuttillhash.png]]
<br><br>
For example:


= Special cases =
* Dialed number:  999#37063042439.
* After transformation: 37063042439.


== Cut everything till Hash ==
This function can be used in fancy MNP (Mobile Number Portability) schemes and perhaps elsewhere.


''This option is available starting from [[MOR_9_documentation | MOR 9]]''
<br>
NOTE: ''Add'' value still can be used to add any value after ''Cut'' is used on the Destination.
<br>


With rule '''Cut: *#''' it is possible to cut everything till # (# included) in the dialed destination:
=== Destination same as received ===
 
If you want to send a number to a Provider exactly as it was received, set Cut = '-' (minus sign as shown in the screenshot).
 
That way, the same number that comes to MOR also leaves MOR:
<br><br>
[[Image:prov_rules_dst_as_received.png]]
<br>
 
===Replacement===
 
If you want to replace one prefix with another you have to ''Cut'' the original prefix and ''Add' the new one. For example:


[[Image:provider_rules_cuttillhash.png]]
If the number is 306936525113 and you want to replace 30 with 6516 this is how the rule should look:
<br><br>
[[File:Provrules replace.png]]
<br><br>
Only one rule can be applied, the one that fits the number the best.
<br><br>


Example:
===Add Suffix===


* Dialed number:  999#37063042439
Add anything to destination number.
* After Localization: 37063042439
<br><br>
[[File:Provrules_suffix.png]]
<br><br>
If the dialed number is 37012345678, then ''TEXT'' will be added to it and destination number became 37012345678TEXT. Example:
  INVITE sip:37012345678TEXT@sip.provider.com:5060 SIP/2.0
To: <sip:37012345678TEXT@sip.provider.com:5060>


This function can be used in fancy MNP (Mobile Number Portability) schemes and maybe elsewhere.
= CallerID Rules =


<br>
Source Rules manages CallerID which is sent to this particular Provider.
NOTE: '''Add''' value still can be used to add any value after '''Cut''' is used on the Destination.


In the example bellow we will add international prefix to every CallerID sent to this Test Provider:
<br><br>
[[File:Provider_src_rules_1.png]]
<br><br>
<br><br>


== CallerID overwrite for Provider ==
== Special Case ==


''(This functionality active from app_mor.so v0.7.41)''
=== CallerID transform Name part ===


Sometimes Providers only accepts calls only with some CallerID.
If Name part of CallerID should be transformed as well, then check '''Change CallerID name''' checkbox.<br>
For example, if CallerID is "00123456789" <00123456789>, then after transformation (given bellow) CallerID will look like "123456789" <123456789>


It is possible to overwrite any CallerID before sending call to such Provider.
[[File:Provider_src_rules_3.png]]


In [[Provider Rules]] (for this Provider) setup such Rule:
=== CallerID overwrite for Provider ===


[[Image:callerid_overwrite_rule_for_provider.png]]
Sometimes Providers only accept calls with CallerID.


In this example all calls going to this Provider will have CallerID = 9999999999
It is possible to overwrite any CallerID before sending a call to such a Provider.


In [[Provider Rules]] (for this Provider) set up the Rule:
<br><br>
<br><br>
== Destination same as received ==
[[Image:Provider_src_rules_2.png]]
<br><br>
In this example, all calls going to this Provider will have CallerID = 37063033333


''(This functionality active from app_mor.so v0.7.50)''
<br><br>


If you want to send exact number to Provider as received, set Cut = '-' (minus sign as shown in screenshot).
= Change Tariff =


That way same number which comes to MOR leaves MOR:
Provider Rules allow to change Provider's Tariff based on Source or Destination number


[[Image:prov_rules_dst_as_received.png]]
[[Image:Provider_src_rules_change_tariff.png]]
 
= Copy Rules to Provider =


At the top of Provider Rules page you can find '''Copy Rules to Provider''' button which allows to copy Provider Rules to any other Provider. This is convenient when you have a lot of rules which need to be applied to several providers.


<br><br>
<br><br>
[[File:Copy_provider_rules.png]]
<br><br>
= Set PAI =
Set CallerID to Anonymous. PAI will contain modified CallerID by Provider rule.
[[Image:Provider_src_rules_pai.png]]
=See also=
=See also=
* [[Number Manipulation]]
* [[Number Manipulation]]
** [[Localization]]
** [[Localization]]
** [[Device Rules]]
** [[DID handling by Localization]]
** [[DID handling by Localization]]
** [[Number Manipulation Examples]]
** [[Number Manipulation Examples]]
* [[Work flow to setup Localization and Provider Rules]]

Latest revision as of 14:23, 23 February 2021

Description



Provider Rules transforms an E.164-compatible number to any number format the Provider requires.

Different providers expect different number formats from you. You can send them whatever they want using Provider Rules.

Provider Rules can be reached by clicking the Rules.png icon next to a provider in the Providers window:

Provrules1.png

We see a similar window as the one in Localization. The rules to manage Provider Rules are identical to those for Localization management, which are covered here.




Destination Rules

Let's say our provider expects to get a number with the technical prefix 89765#. We can do this in following way:

Provrules2.png

That's it – very simple. Now every number that is sent to this provider will be transformed by adding our created tech. prefix.

For example, if 37063042438 should be sent to this provider, this rule will be activated and the number 89765#37063042438 will be sent to provider.

REMINDER: You can check whether Provider Rules are applied correctly in Call Tracing



Special cases

Cut everything till Hash

With rule Cut: *# it is possible to cut everything till # (# included) in the dialed destination:

Provider rules cuttillhash.png

For example:

  • Dialed number: 999#37063042439.
  • After transformation: 37063042439.

This function can be used in fancy MNP (Mobile Number Portability) schemes and perhaps elsewhere.


NOTE: Add value still can be used to add any value after Cut is used on the Destination.

Destination same as received

If you want to send a number to a Provider exactly as it was received, set Cut = '-' (minus sign as shown in the screenshot).

That way, the same number that comes to MOR also leaves MOR:

Prov rules dst as received.png

Replacement

If you want to replace one prefix with another you have to Cut the original prefix and Add' the new one. For example:

If the number is 306936525113 and you want to replace 30 with 6516 this is how the rule should look:

Provrules replace.png

Only one rule can be applied, the one that fits the number the best.

Add Suffix

Add anything to destination number.

Provrules suffix.png

If the dialed number is 37012345678, then TEXT will be added to it and destination number became 37012345678TEXT. Example:

INVITE sip:37012345678TEXT@sip.provider.com:5060 SIP/2.0
To: <sip:37012345678TEXT@sip.provider.com:5060>

CallerID Rules

Source Rules manages CallerID which is sent to this particular Provider.

In the example bellow we will add international prefix to every CallerID sent to this Test Provider:

Provider src rules 1.png

Special Case

CallerID transform Name part

If Name part of CallerID should be transformed as well, then check Change CallerID name checkbox.
For example, if CallerID is "00123456789" <00123456789>, then after transformation (given bellow) CallerID will look like "123456789" <123456789>

Provider src rules 3.png

CallerID overwrite for Provider

Sometimes Providers only accept calls with CallerID.

It is possible to overwrite any CallerID before sending a call to such a Provider.

In Provider Rules (for this Provider) set up the Rule:

Provider src rules 2.png

In this example, all calls going to this Provider will have CallerID = 37063033333



Change Tariff

Provider Rules allow to change Provider's Tariff based on Source or Destination number

Provider src rules change tariff.png

Copy Rules to Provider

At the top of Provider Rules page you can find Copy Rules to Provider button which allows to copy Provider Rules to any other Provider. This is convenient when you have a lot of rules which need to be applied to several providers.



Copy provider rules.png

Set PAI

Set CallerID to Anonymous. PAI will contain modified CallerID by Provider rule.

Provider src rules pai.png

See also