Links

System requirements

Asterisk requirements

Requirements
How to test
Asterisk version 1.8+, FreePBX, Esabel, Elastrix
$ asterisk -V
Asterisk 13 or FreePBX 14
CEL table enabled and configured to collect
data to MySQL
$ asterisk -rx 'cel show status'
CEL Logging: Enabled
CEL Tracking Event: CHAN_START CEL Tracking Event: CHAN_END CEL Tracking Event: ANSWER CEL Tracking Event: BRIDGE_START CEL Tracking Event: BRIDGE_END CEL Tracking Event: LINKEDID_END
...
CEL Event Subscriber: ODBC CEL backend
$ asterisk -rx 'odbc show'
ODBC DSN Settings
-----------------
Name: asteriskcdrdb
DSN: MySQL-asteriskcdrdb
Number of active connections: 2 (out of 5)
$ mysql -u root -D asteriskcdrdb -p
> use asteriskcdrdb;
> select eventtime from cel order by id desc limit 10;
You should see 10 lines from CEL with current date.
AMI enabled and configured
$ asterisk -rx 'manager show settings'
Manager (AMI): Yes
TCP Bind address: 0.0.0.0:5038
Call recording have to be enabled and to CDR. You have access to recording files.
$ mysql -u root -D asteriskcdrdb -p
> SELECT recordingfile FROM `cdr` ORDER BY calldate desc limit 10;
You will see 10 lines from CDR with the path to file
CURL have to be enabled in Asterisk
$ asterisk -rx 'core show function CURL'
-= Info about function 'CURL' =-

Bitrix24 requirements

Portal configuration should be done by user with administrative rights.
For the self-hosted Bitrix24:
  1. 1.
    Main module version 16.5.11 and higher
  2. 2.
    REST API (rest)
  3. 3.
    "Telephony" module
  4. 4.
    "CRM"
  5. 5.
    “Push&Pull”
Application supports any Bitrix24 cloud version with any limitations.

Network requirements

You should allow outgoing connections on the server where connector installed (it’s Asterisk server usually) to:
  1. 1.
    Your Bitrix24 (cloud or on-premise) with http or https protocols.
  2. 2.
    Bitrix24 authorization server: https://oauth.bitrix.info.
  3. 3.
    Connector license server: https://api.bx24asterisk.ru.
Outer network access (8077 and 8078 port forwarding) is required for full functionality: click-to-call functionality and call records listening by link.

Operating system requirements

Connector installation is made without problems for:
  • CentOS 6 and higher.
  • Debian 7 and higher.
Integration failed on this operating systems:
  • CentOS 5
  • Debian 6
  • Gentoo
If you have another OS, then there should be such packages in OS repositories: unixODBC, mysql-connector-odbc, mysql-server. If that packages already installed, it will simplify connector installation.