Connect office PBX

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 number of free minutes and the active license term is 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.

  • 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 the Telephony section, click Connection > Office PBX.
  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 the connection settings.

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 type=friend 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.: 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

First, you need to configure your Dialplan, which must be included in the file extensions.conf. When configuring your Dialplan, enter the command:


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

Please refer to the Asterisk documentation to learn more about Dialplan configuration.

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

dialplan reload

Firewall settings in the local network

By default, the following ports are used:

  • For calls from a browser: 443 TCP, 3478 TCP/UDP, 8000-48000 UDP.
  • For calls from a SIP device: 5060 TCP/UDP, 3478 TCP/UDP, 8000-48000 UDP.

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.

Was this information helpful?
Article feedback
Could you please tell us why:
Article feedback
Integration specialist assistance
Go to Bitrix24
Don't have an account? Create for free