Difference between revisions of "3CX PBX interconnection with MOR"

From Kolmisoft Wiki
Jump to navigationJump to search
Tag: Manual revert
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Important!!! Manual is not finished !!=
=Single-trunk=


=To connect the multitenant 3CX PBX with MOR you should do these steps on the MOR:=
If each of your clients has a separate 3CX instance with a unique IP address, follow these steps:
------------------------------------------------------------------------------------------
==Adding once==
1. Create the Tariff without rates
<br><br>
<br><br>
2. Create LCR without providers
 
==Configurations in MOR==
 
* Create [[How to create User and Device|a User and a SIP device]] for this User.
* In [[Device settings]] [[Image:icon_trunk.png]] '''Trunk''' choose “Yes” and mark “check” next to the 3CX.
* The "3CX" option adds ''rinstance parameter'' to R-URI which is used on 3CX authentication (more information here: https://www.3cx.com/docs/sip-trunk-registration-authentication/.
<br><br>
[[File:MOR_Device_Settings_Trunk_Yes.png|500px]]
<br><br>
<br><br>
3. Create an Interconnection User with Tariff and LCR from 1 and 2.
* You can also select [[Image:icon_trunk_with_ani.png]] Trunk with ANI if you want to do an additional authorization by CLI or Domain.
* If you choose [[Image:icon_trunk_with_ani.png]] Trunk with ANI, click on [[Image:icon_clis.png]] CLIs, then “Add new CLI”
 
<br><br>
<br><br>
==Adding for each whole  3CX PBX server==
[[File:Add_CLI.png|500px]]
1. Create a device for the Interconnection user with the IP of the 3CX PBX server - type Trunk Yes with Ani
<br><br>
* Fill in the field “CLI or "Domain" (for example, demo.kolmisoft.com).
<br><br>
[[File:Add_CLI_-_CLI_or_Domain.png|500px]]
 
<br><br>
<br><br>
-------------------------------------------------------------------------------------------
==Configurations in 3CX PBX==


=Adding a new tenant on the 3CX PBX=
* Create a new trunk and enter the IP address of MOR.
* If you entered some hostname name in MOR CLI > Domain settings, add the same hostname here.
<br><br>
[[File:3cx trunk config.jpg|500px]]
<br><br>


==Steps in the MOR==
=Multi-trunk=


1. Add new user (name of the tenant)
If you want to host a few clients on the same 3CX instance and multiple clients will share the same IP address, you’ll need a few additional steps.
<br><br>
<br><br>
2. Add to this user regular tariff and the LCR with providers assigned to have the possibility to make calls
 
==Configurations in MOR==
 
* Create an ''Interconnection User'' with an empty Tariff (without rates) and empty LCR (without providers). If multiple clients use the same IP address and MOR cannot do proper authorization through the domain, it will bill one of your users. To avoid this, you must create a “fake” ''Interconnection User'' that will be used in all cases, where authorization cannot be done (e.g. your users are sending calls from a domain that is not defined in MOR).
* Create a SIP device for the ''Interconnection User'' with the IP address of the 3CX PBX server.
* Choose [[Image:icon_trunk.png]] '''Trunk''' --> “Yes” or [[Image:icon_trunk_with_ani.png]] Trunk with ANI.
* Create a regular User (that represents your client on 3CX) in MOR. Assign a proper Tariff and LCR for this User.
* Add a Virtual Device for this User and in the top settings click on [[Image:icon_clis.png]] CLIs and then “Add new CLI”.
* Fill in the field "Domain" (for example, demo.kolmisoft.com). Each subdomain represents your client/tenant in 3CX PBX (e.g. user1.kolmisoft.com, user2.kolmisoft.com, etc.).
<br><br>
<br><br>
3. Add a Virtual Device to this user
[[File:Add_CLI_-_CLI_or_Domain.png|500px]]
 
<br><br>
<br><br>
4. Add CLI to this Virtual Device (as on the screenshot )
==Configurations in 3CX==
==Steps in the 3CX PBX==


1. Add trunk (as on the screenshot)
* Create a new trunk for each user/tenant and enter the IP address of MOR.
[[File:3cx trunk config.jpg|thumb]]
* The hostname in the field "Registrar/Server/Gateway Hosted or IP" should match what you entered in the "Domain" field in MOR, e.g. user1.kolmisoft.com, user2.kolmisoft.com, etc.
<br><br>
[[File:3cx trunk config.jpg|500px]]
<br><br>

Latest revision as of 06:12, 11 October 2023

Single-trunk

If each of your clients has a separate 3CX instance with a unique IP address, follow these steps:

Configurations in MOR



MOR Device Settings Trunk Yes.png

  • You can also select Icon trunk with ani.png Trunk with ANI if you want to do an additional authorization by CLI or Domain.
  • If you choose Icon trunk with ani.png Trunk with ANI, click on Icon clis.png CLIs, then “Add new CLI”



Add CLI.png

  • Fill in the field “CLI or "Domain" (for example, demo.kolmisoft.com).



Add CLI - CLI or Domain.png



Configurations in 3CX PBX

  • Create a new trunk and enter the IP address of MOR.
  • If you entered some hostname name in MOR CLI > Domain settings, add the same hostname here.



3cx trunk config.jpg

Multi-trunk

If you want to host a few clients on the same 3CX instance and multiple clients will share the same IP address, you’ll need a few additional steps.

Configurations in MOR

  • Create an Interconnection User with an empty Tariff (without rates) and empty LCR (without providers). If multiple clients use the same IP address and MOR cannot do proper authorization through the domain, it will bill one of your users. To avoid this, you must create a “fake” Interconnection User that will be used in all cases, where authorization cannot be done (e.g. your users are sending calls from a domain that is not defined in MOR).
  • Create a SIP device for the Interconnection User with the IP address of the 3CX PBX server.
  • Choose Icon trunk.png Trunk --> “Yes” or Icon trunk with ani.png Trunk with ANI.
  • Create a regular User (that represents your client on 3CX) in MOR. Assign a proper Tariff and LCR for this User.
  • Add a Virtual Device for this User and in the top settings click on Icon clis.png CLIs and then “Add new CLI”.
  • Fill in the field "Domain" (for example, demo.kolmisoft.com). Each subdomain represents your client/tenant in 3CX PBX (e.g. user1.kolmisoft.com, user2.kolmisoft.com, etc.).



Add CLI - CLI or Domain.png



Configurations in 3CX

  • Create a new trunk for each user/tenant and enter the IP address of MOR.
  • The hostname in the field "Registrar/Server/Gateway Hosted or IP" should match what you entered in the "Domain" field in MOR, e.g. user1.kolmisoft.com, user2.kolmisoft.com, etc.



3cx trunk config.jpg