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

From Kolmisoft Wiki
Jump to navigationJump to search
Line 1: Line 1:
=To connect the multitenant 3CX PBX with MOR you should do these steps on the MOR:=
=Single-trunk=
------------------------------------------------------------------------------------------
 
==Adding once==
If each of your clients has a separate 3CX instance with a unique IP address, follow these steps:
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>
<br><br>
3. Create an Interconnection User with Tariff and LCR from 1 and 2.
[[File:MOR_Device_Settings_Trunk_Yes.png|500px]]
<br><br>
<br><br>
==Adding for each whole  3CX PBX server==
* 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.
1. Create a device for the Interconnection user with the IP of the 3CX PBX server - type Trunk Yes with Ani
* 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>
-------------------------------------------------------------------------------------------
[[File:Add_CLI.png|500px]]
<br><br>
* Fill in the field “CLI or "Domain" (for example, demo.kolmisoft.com).
<br><br>
[[File:Add_CLI_-_CLI_or_Domain.png|500px]]


=Adding a new tenant on the 3CX PBX=
<br><br>
==Configurations in 3CX PBX==


==Steps in the MOR==
* 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.
1. Add new user (name of the tenant)
<br><br>
<br><br>
2. Add to this user regular tariff and the LCR with providers assigned to have the possibility to make calls
[[File:3cx trunk config.jpg|500px]]
<br><br>
<br><br>
3. Add a Virtual Device to this user
 
=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.
<br><br>
<br><br>
4. Add CLI to this Virtual Device (as on the screenshot )


[[File:3cx cli.jpg]]
==Configurations in MOR==


==Steps in the 3CX PBX==
* 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.).


1. Add trunk (as on the screenshot)
<br><br>
==Configurations in 3CX==


[[File:3cx trunk config.jpg]]
* 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.
<br><br>
[[File:3cx trunk config.jpg|500px]]
<br><br>

Revision as of 11:28, 4 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.).



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