Read FAQ
NEW
Bitrix24 Support
Registration and Authentication
How to start
My Profile
Feed
Chats and Calls
Calendar
Bitrix24.Docs
Bitrix24.Drive
Bitrix24.Mail
Workgroups
Tasks and Projects
CRM
CoPilot - AI in Bitrix24
Contact Center
Sales Center
CRM Analytics (beta)
BI Builder
Sales Intelligence
Inventory Management
Marketing
Sites
Online Store (beta)
CRM + Online Store
CRM Store (beta)
Bitrix24.Sign
Company
Knowledge base (beta)
Automation
Workflows
Telephony
Market
Subscription
Settings
Enterprise
Mobile App
Desktop App
General questions
Bitrix24 On-Premise

Bitrix24Care

Connect office PBX

Besides cloud hosted 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 from the Market, 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.

There is the following logic of calls when using this connection type:

  1. When making outbound calls, Bitrix24 will connect to the server specified in the Outgoing calls section of the number connection parameters, and establish the connection after authorization.

  2. To accept incoming calls, you will need to configure your IP-PBX and create trunk using the parameters specified in the Incoming calls section of the number connection parameters.

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

You have free minutes available to make outbound calls and test the SIP connection. Check the number of free minutes and the active license term on the Connection page in the Balance and Statistics section.

You can accept incoming calls at no cost via your Bitrix24 SIP PBX. But to make outgoing calls or forward calls using your SIP PBX, you will need to purchase the SIP connector.

Read more in the article - What is SIP connector?

Connection configuration in Bitrix24

  1. Go to CRM > Add-ons > 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 parameters.


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 screenshot 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, change the values 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. So we recommend changing it to ip.

Apply the settings 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:

Dial(SIP/voximplant/${EXTEN}

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.

Refer to the Asterisk documentation to learn more about Dialplan configuration.

Apply the settings 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.

Note that in Bitrix24 On-premise version you need to set up the Telephony module before connecting your office PBX.
Was this information helpful?
Integration specialist assistance
That's not what I'm looking for
Complicated and incomprehensible text
The information is outdated
It's too short. I need more information
I don't like the way this tool works
Go to Bitrix24
Don't have an account? Create for free