If you don’t feel like wasting time on instructions or they didn’t help, contact our support. We will quickly help you set everything up and answer all questions!
Contact us in any convenient way:
Online chat (quick and easy; there are no bots, but live people))
Working hours: 08:00 - 17:00 Moscow Time (UTC+3). Weekends: Saturday, Sunday.
Install this application: https://www.bitrix24.com/apps/?app=itgro.asteriskbx24free If this app isn’t available in your country, please, write to support
You should provide permissions to use application for all authorized users. Applications → Installed→ Access permissions. Then select “Other”, and select “All authorized users”.
Asterisk server is the best place to install connector according to the requirements. If it’s not possible to install connector to the Asterisk server, then you can install it on another server, that confirms technical requirements.
Open the Console (Terminal), log in to the Asterisk server:
ssh ipasterisk -l root
ipasterisk is the ip-address of the Asterisk server. Then enter the password.
2. Download the application distribution package, run the following command:
Run the installation with the following command:
3. Create a new login and password for login in the setup interface like this :
You can change this data later in the config file:
/etc/bx24asterisk/config.json. (‘Webserver’ section)
After installing copy the link and paste into address bar in browser for redirecting to Setup wizard (link is like on picture).
We recommend doing further configuration using setup master in Bitrix24 interface:
<ipasterisk> - ip-address of your asterisk server.
*Itgrix has the own web-server, and self writing ssl-certificate. Allow your browser to connect to this web-server.
Input the login and password, which you created during app installation.
Setup master steps: 1. Database connection. The master will find DB credentials. Also, it will check availability of CEL and CDR tables.
If credentials was not found, you can get it from
You can create new MySQL-user if you want. He will have read and write permissions in CEL and CDR tables.
2. Asterisk connection. Choose an existing user or create new. The connector will be sending request to AMI using this user.
If the connector was installed on the other server (not Asterisk), then create a user manually:
1. Change file
secret = asterisksecret (create your own)
deny = 0.0.0.0/0.0.0.0
permit = 127.0.0.1/255.255.255.0
read = cdr,reporting,originate
write = reporting,originate
2. Reload asterisk manager:
asterisk -rx 'manager reload’
3. Bitrix24 connection. Copy your portal address with protocol and paste at first input field. Enter the administrator’s login and password. The connector will send REST requests using that user.
Click Finish if all steps were completed successfully.
Click Finish and you will be redirected to business logic settings page.
4. Business logic settings
To save settings press ‘Save’ button on every changed page.
Make sure that all Bitrix24 users who use telephony have their internal phone number (extension numbers) in the user profile. If the user haven’t the extension number in Bitrix24 the connector don’t find them and the call will be skipped.
First way - add internal phones using Telephony configuration:
Telephony → Configure telephony → Telephony users
Second way - add an internal phone number in each user profile.
Use our test procedure for testing your connection.
Contact us in case you have questions.