top_en
Main page

Bitrix24Care

Connect office PBX

Rating:

You can connect your office PBX to Bitrix24 (unlimited number of office PBXs can be connected to your account).

As configuring PBX connection using Rest API is mostly done in the app downloaded on Marketplace (you can learn how to connect your PBX in the app description or contact the app developer), this article is about connecting office PBX using SIP connector.

You have free minutes available to make outbound calls in order to test the functionality. If you plan to use your PBX for outbound calls, you have to pay for the license by clicking the button Buy SIP-connector. The amount of free minutes and the active license term are displayed on the Balance and Statistics page in the Telephony section.

You can accept incoming calls at no cost via your Bitrix24 SIP PBX. Use free minutes to test the service and if you like it click Buy SIP-connector button.

Important:
  • You need to buy SIP-connector only once, no matter how many SIP PBXs you need to connect.
  • SIP-connector needs to be purchased separately and is not related to Telephony balance.

Make sure that the office PBX that you want to connect to Bitrix24 supports SIP protocol.

Connection configuration in Bitrix24

  1. In Telephony section, click Connect > Connect your PBX using SIP connector.
  2. Then click Connect office PBX.
  3. Fill out the form.
    • Connection name - an arbitrary name of the connection. This field is optional.
    • Server Address is the IP address of your PBX.
    • Login and Password PBX access data.
  4. Click Connect and configure inbound call routing.

Office PBX settings

Let's consider setting up an office PBX using Asterisk as an example. For PBX setting, use the data from the Incoming calls block:

Creating trunk

The following entry must be made in the file sip.conf:

 [voximplant] dtmfmode=rfc2833; then instead of youraccount, type the name of your account in the Server field (see the figure above). fromdomain= youraccount type=friend host= youraccount; the value of the Login fromuser=asterisk username=asterisk; as a password value the value from the field Password is used secret=mypass insecure=port,invite conext=contex-internal disallow=all nat=yes allow=ulaw&alaw 
In this entry, the values must be changed only for domain, password, and the nat parameter, which must be set to yes/no, depending on whether you have a NAT network or not.

As an example, below is a sample configuration where the data from the example above are used:

 [voximplant] dtmfmode=rfc2833 fromdomain=ip.b24-2729-1386056980.voximplant.com type=friend host=ip.b24-2729-1386056980.voximplant.com fromuser=sip1 username=sip1 secret=e349429f63f7e4d7025fcd32d477ea05 insecure=port,invite conext=contex-internal disallow=all nat=yes allow=ulaw&alaw 
Attention! Earlier the settings of your Office PBX used incoming instead of ip value in the Server field (e.g.: incoming.b24-6864-1386141129.bitrixphone.com). You can continue using this value, but the module will work much slower.

The settings are applied using the command in the Asterisk console:

 sip reload 

Setting up calls from Asterisk to VoxImplant

Calls are made using the following command, which must be included in the file extensions.conf:

Dial(SIP/voximplant/${EXTEN}

In this case, call will be sent to Bitrix24 as a call to the number to which it has been originally made in Asterisk.

The settings are applied using the command in the Asterisk console:

dialplan reload

Firewall settings in the local network

By default, port 5060 is used for SIP, and ports 10000-20000 are used for media (RTP). However, there is no general recommendation for this, because port 5060 can be both TCP and UDP. It depends on the current settings of the local network.

Normally, SIP requires that the outbound traffic be permitted (from PBX, for example), and inbound connections will work automatically. RTP is usually used as UDP (so data can still be transmitted although packets are lost).

The ports themselves can be set up in the PBX properties: the port that is indicated in the properties must also be opened in Firewall.


This helped Thanks :) This didn't help Sorry :(
Could you please tell us why:
It's not what I'm looking for
It's too complicated

Did not find an answer to your question?

Send your question to the Bitrix24Care team
Access to technical support specialists requires commercial plan subscription and is not available to free account users. Free accounts are limited to self-support resources such as product manuals, helpdesk articles, video tutorials, and free webinars. Technical assistance, training, setup, customization and other value added services can also be purchased directly from local Bitrix24 partners