Quick start

Welcome to our installation guide!
Installation in 4 steps

Contact us instead of reading the instructions

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:

Working hours: 08:00 - 17:00 Moscow Time (UTC+3). Weekends: Saturday, Sunday.

1. Install application at Bitrix24 Marketplace.

1.1 Install Asterisk-connector Itgrix from B24 marketplace

Install this application: https://www.bitrix24.com/apps/?app=itgro.asteriskbx24free If this app isn’t available in your country, please, write to support

1.2 Access permissions for application using

You should provide permissions to use application for all authorized users. Applications → Installed→ Access permissions. Then select “Other”, and select “All authorized users”.

2. Install server part.

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.

Install connector

Video-instruction
  1. Open the Console (Terminal), log in to the Asterisk server:

ssh ipasterisk -l root

where ipasterisk is the ip-address of the Asterisk server. Then enter the password.

2. Download the application distribution package, run the following command: wget https://bx24asterisk.ru/download/autoinstaller_bx.sh

Run the installation with the following command: bash autoinstaller_bx.sh

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).

If connector is not started. The connector will start automatically after installation, but use commands - to start it manually: service bx24asterisk start - to check status: service bx24asterisk status

3. Configure Asterisk-connector

We recommend doing further configuration using setup master in Bitrix24 interface: https://<ipasterisk>:8078/config/master, where <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.

The logic of the module

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 /etc/asterisk/res_odbc.conf or /etc/asterisk/res_odbc_additional.conf

For example: [asteriskcdrdb] username=>freepbxuser password=>mysqlsecret

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 /etc/asterisk/manager_custom.conf [bx24] 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.

Connector have 1-week trial. After it restricted mode will turn on The limitations : 2 users and 1 trunk. You can choose the responsible user and operator on this page To get unlimited users pay the licence fee, please. Contact us to receive the bill.

Configuration is completed!

4. Bitrix24 user profile configuring

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

B24 telephony settings

Second way - add an internal phone number in each user profile.

B24 user profile

Important: If you use FollowMe in Asterisk (transfer of an incoming call to a cell phone), add the cell phone number to user profile too. In this way connector can find user by cell phone number.

Installation is completed! Now you can finally start using Asterisk-connector!

Use our test procedure for testing your connection.

Contact us in case you have questions.