Softphone24 is an extension for the Chrome browser that we have created specially for our integration of Bitrix24 and Asterisk. It is a web dialer that allows making and receiving calls right in the browser with no supplementary hardware, even if the tab with Bitrix24 portal is closed. All information about the calls is automatically saved in Bitrix24.
In this article, you can find out how to configure FreePBX and the integration module to launch the extension right away.
Please note that to configure the app, your Bitrix24 must work through HTTPS with a valid certificate.
Settings made in FreePBX
Go to the FreePBX main page, in the top menu select Admin → Certificate Manager. This tool lets you obtain a certificate in a semi-automatic mode.
Click New certificate → Generate Let’s encrypt Certificate.
To get the certificate, fill in all the necessary fields.
Check the corresponding box next to the created certificate to assign the received certificate as used by default.
In the top menu, select Settings → Advanced Settings. Set the switch to Yes next to the Enable the mini-HTTP Server and the Enable TLS for the mini-HTTP Server fields. Make sure the settings for the HTTPS Bind Address and the HTTPS Bind Port fields are correct.
SIP and PJSIP setup
Please note that the drivers for mini-HTTP server and Extensions must match. To make sure it's true, set the driver type that the web socket should work with. As an example, let's consider PJSIP.
In the top menu, select Applications → Extensions and check the driver type assigned to the numbers that will work on web sockets.
If necessary, open the extension editing window and change the driver type.
Return to the top menu, select Settings → Advanced Settings, and find out the value indicated in the SIP Channel Driver field.
If the selected option is both as shown in the screenshot above, go up the page and in the Force WebSocket Mode field set PJSIP.
If you decided to use SIP in the first place, proceed with all the same steps setting everywhere the SIP driver.
Integration module setup
Go to the InformUnity Bitrix24 integration module. On the Advanced tab, click Check next tp the Softphone Settings field. Specify an external WSS port.
Settings check
Enter the URL in the address bar following the rule: https:// + the external address of the FreePBX server by domain name + port for the web socket service + ws. As a result, you should see the following window:
Extensions Setup
Settings for PJSIP
In the top menu, select Applications → Extensions. Open the extension editing window and make sure the number uses PJSIP.
Go to the Advanced tab and put the switch to Yes next to three fields: Enable AVPF, Enable ICE Support and Enable rtcp Mux.
Then scroll down and set the DTLS parameters. Set the switch to Yes next to the Enable DTLS field and select the required certificate.
Settings for SIP
In the top menu, select Applications → Extensions. Open the extension editing window and make sure the number uses SIP.
Go to the Advanced tab and put the switch to Yes next to four fields: Enable AVPF, Force AVP, Enable ICE Support, Enable rtcp Mux.
Then scroll down and set the DTLS parameters. Set the switch to Yes next to the Enable DTLS field and select the required certificate.
Extension launch
When the settings for the extensions are made, you can proceed with the extension launch. Install Softphone24 and enter the portal address. If the settings were made correctly, the extension should work right away.
Please be noted that Softphone24 works only in conjunction with our Bitrix24 and Asterisk integration module.
If you have any questions about Softphone24, text us in Chat. We are happy to be there for you.
We have covered the most popular questions on the integration of Asterisk and Bitrix24 in a recently published FAQ. If you are just looking into our solution, read our general overview article, have a look at the new screencast and remember that all of it is not as complicated as it might seem at first glance ;). Text us — we are eager to help.
