You can connect a cloud PBX to Bitrix24 using either the REST API or the SIP connector.

For REST API connections, install an app from the Bitrix24 Market. Check the app documentation or contact the developer if you need help.
Bitrix24 Market

This article explains how to connect a cloud PBX using the SIP connector.

Before you start

Keep these points in mind:

• Make sure your PBX supports the SIP protocol.
• You can receive incoming calls for free through the Bitrix24 SIP PBX. You need the SIP connector for outgoing calls and call forwarding.
  SIP connector
• Bitrix24 provides free minutes to test outbound calls and the SIP connection. Check your available minutes and license status under Connection > Balance and Statistics.
• You only need one SIP connector, even if you connect multiple PBXs.
• The SIP connector is a separate purchase and is not tied to your telephony balance.
• Do not use both a Market app and a SIP connection from the same provider at the same time. This can cause issues such as duplicate calls or a missing Answer button.

Connect a cloud PBX

1. Go to the CRM section > Sales > Sales channels > Telephony.
2. Click Cloud PBX.
3. Select Connect cloud PBX.
4. Fill in the connection details:
• Connection name: Set a connection name (optional).
• Server Address: Specify the IP address of your PBX.
• Login and Password: Enter your PBX access data.

Some PBXs require additional settings:

• Log in as user: Use the value from the auth user field in your PBX settings.
• Proxy server: Use the value from the SIP outbound proxy field.

Click Save. Bitrix24 will create the connection and show its status.

Connection statuses

After you connect a PBX, you may see these statuses:

• In progress: The system is setting up the connection. You can receive incoming calls in a few minutes.
• Getting data: Bitrix24 is checking the connection status.
• Error: The connection failed. Check your settings and try again.
• Connected: The PBX is ready. You can configure phone numbers.
  Configure numbers

Firewall settings

By default, Bitrix24 uses these ports:

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

Allow outbound traffic from your PBX. Inbound traffic usually works automatically.

RTP typically uses UDP. Some packet loss is acceptable and does not block transmission.

If you change ports in your PBX settings, open the same ports in your firewall.