Manual - 3CX

3cx.png

Notes

  • When using click-to-dial a popup will be shown once the call is answered. 3CX is not sending a ringing event in this scenario.
  • The 3CX call control button will not work with the 3CX softphone, 3CX does not support it.


Configuration in partner portal

To connect the 3CX telephony platform to Bubble it is necessary to add the internal phonenumbers/extensions to the user(s). In the partner portal, go to the customer you want to connect. Click on the tab User and click on the green icon next to the user to add the internal phonenumber/extension.

6024fd79-c5be-4475-b0fb-1e73f4f8818a.png

On the server

To make the integration (from V16) you need root access. Then download the correct 3CX .deb file here (see attachment) and place it on the server where the 3CX PBX is installed. At the moment we only support Linux servers (other operating systems on request). You can also go to the installation files via Bubble > 3CX > click on ‘You can download the latest software here’ at the bottom.

d699efc0-c923-4f3c-85d8-879e1b86b93b.png

Login via SSH, navigate to the folder where the deb-file is located, then run the following command to install the service.

sudo dpkg -i 3CX-Bubble-Service.1.1.0.debian.10-x64.deb*

* type in the right filename. 
Go to the Red Cactus partner portal> reseller> Customers> tab bubble> 3CX. Copy the host, username and API Key values and copy them to /var/lib/3CX-Bubble-Service/config.ini
c09b42fc-1fb5-4dfb-bb65-b00ab8775a7a.png
[bubble]
host=3cx.bubble.redcactus.nl
port=8091
username=
api_key=
secure=true
[3cx]
config_file=/var/lib/3cxpbx/Bin/3CXPhoneSystem.ini

As a final step, start the 3CX-Bubble service: 

sudo systemctl restart 3cx-bubble-service


Configuration in Bubble Software

In the Bubble software, go to Phone Connectors and activate the 3CX phone connector by double clicking on it. 3CX is now connected to Bubble.

Index

NotesWhen using click-to-dial

Configuration in partner portal

On the server

Configuration in Bubble Software

Features

Call control

Answer button
With call control you can directly answer a call via a button in the pop-up notification.

Hangup button
With call control you can directly end a call via a button in the pop-up notification.

Call initiation
Call initiation is supported by this integration. That means that you can easily start an outgoing telephone call with one mouse click (click to dial), dial button on your keybord (select to dial) or use the Bubble remote dialer.

Answer button 3CX
With call control you can directly answer a call via a button in the pop-up notification. Unfortunately 3CX doesn't support this functionality for the 3CX softphone.


Call Events

Inbound events
This allows Bubble to show data for incoming calls.

Outbound events
This allows Bubble to show data for outgoing calls.

Transfered events
This allows Bubble to show data for transfered calls.


Integration

Admin account required
Authentication based on an account with admin rights is required to activate the integration

Server plugin installation required
This integration requires additional software to be installed on the telephony server.


Integration type

Company based
This telephone system supports company-level authentication. It is only necessary to add the internal phonenumbers/extensions to the user(s) in the partner portal.


Attachments

Filename Filesize
3CX-Bubble-Service.1.1.1.debian.8-x64.deb 22022.47 kiB Download
3CX-Bubble-Service.1.1.1.debian.9-x64.deb 22018.06 kiB Download
3CX-Bubble-Service.1.1.1.debian.10-x64.deb 22021.54 kiB Download
In general it can have four causes:Cause 1The phone connector is not active yet in Bubble. Make sure you double click on the phone connector so there is a blue frame around it. Only then is the Phone...

Log in if you want to read further

Index

Cause 1

Cause 2

Cause 3

Cause 4

Yes, you can! In the Bubble software you can check under Phone Connectors if the call events are coming through. This is also an extra way of checking whether you have done the configuration correctly...

Log in if you want to read further

Not all phone systems are considering transferred calls as 'new call', i.e. incrementing the id of the call.Realworks does not handle updated phone numbers correctly for the same call id.If Realworks...

Log in if you want to read further

Note: This item applies to all phone connectors that are routing call events based on the users internal number.You can configure the default Click&Call device by marking the user's internal numbe...

Log in if you want to read further

Copyright Red Cactus B.V. © 2020 - 2023 Terms and conditions