Коннектор AsterX для интеграции IP-телефонии на Asterisk с CRM Битрикс24

asterx_logo_1

Работа коннектора AsterX основана на взаимодействии с АТС через управляющий интерфейс AMI (Asterisk Manager Interface), соответственно, возможна интеграция Битрикс24 с любой АТС, работающей на Asterisk

Программные АТС:

  • FreePBX (самый распространенный и с GUI)
  • Issabel (Elastix-Style)
  • VitalPBX
  • Asterisk в "чистом" виде (ручное конфигурирование)
  • и другие

Аппаратные решения на Asterisk с поддержкой AMI (зависит от моделей)

  • Yeastar
  • Grandstream
  • OpenVox
  • и другие

Требования к инфраструктуре и сети:

  • Для программных АТС установку коннектора рекомендуется производить на самом сервере, для аппаратных платформ нужно использовать внешний сервер так как нет возможности установить коннектор AsterX непосредственно на АТС
  • Для коробочных версий Битрикс24 необходимо разрешить исходящее соединение на наш сервер
  • Так же для АТС (или для сервера на котром будет установлен AsterX) необходимо разрешить исходящее соединение на наш сервер
  • Актуальный IP адрес можно узнать командой ping gulin.kz

Поддерживаемые коннектором функции

  • Удобная фильтрация звонков по принадлежности к контекстам;
  • Синхронизация звонков в реальном времени;
  • Загрузка файлов записей разговоров;
  • Событие OnExternalCallStart - набор номера по клику. Оператор кликает по номеру клиента в интерфейсе Битрикс24, после чего сначала звонит его телефон, после того как оператор возьмёт трубку начинается набор клиенту;
  • Событие OnExternalCallBackStart - набор номера при заполнении формы обратного звонка в Битрикс24. После того как клиент отправит форму коннектор сначала найдет в CRM ответственного за этот контакт менеджера (отвественный указывается в настройках формы обратного звонка), после чего продолжит работу по сценарию набора по клику;
  • Отображение карточки клиента (отключить / при звонке / при ответе);
  • Автоматическое создание сделки или лида (да/нет);
  • Загрузка файлов голосовой почты в Битрикс24 (да/нет);

Процесс установки

  1. Установить приложение AsterX в маркете Битрикс24
  2. В открывшемся интерфейсе нажать кнопку "Добавить АТС"
  3. Скопировать полученый PBX-ID: XXXXXX
  4. В АТС создать AMI пользователя asterx с правами на чтение и выполнение команд

Установка AsterX на сервер:

git clone https://github.com/estvita/asterx.git
cd asterx
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements/local_sql.txt
nano config.ini

В конфигурационный файл config.ini вписать следующие данные:

[asterisk]
pbx_id=XXXXXX
username=asterx
secret=asterx_secret

где:

  • pbx_id - ID сервера, полученный в приложении AsterX в интерфейсе Битрикс24
  • username - логин AMI пользователя, созданного в АТС
  • secret - пароль этого пользователя

Запустить в тестовом режиме

python main.py

После авторизации коннектора на нашем сервере в базу коннектора будут переданы ключи и базовые настройки.

К одному порталу Битрикс24 можно подключить несколько серверов телефонии.

Настройки для конкрентного портала осуществляются непосредственно в интерфейсе Битрикс24 в приложении AsterX и применяются одновременно ко всем привязанным к порталу серверам телефонии

Screenshot from 2025-08-02 18-50-09

Коннектор, в свою очередь, отправит на сервер список контекстов, из которых в настройках АТС в интерфейсе битрикс24 нужно выбрать внешние, внутренние и игнорируемые.

Важно помнить, что во входящем или исходящем звонке участвует два контекста, соотвественно, в настройках должно быть как минимум по одному для внешней и внутренней линии.

Screenshot from 2025-07-29 10-32-21

Для исключения звонков из статистики нужно выбрать "Исключить"

Для сопоставления звонков между пользователми битрикс24 и АТС в настройках пользователей телефонии каждому необходимо присвоить номер, которым он пользуется в АТС и, для того чтобы работал набор номера по клику, в качестве номера по умолчанию установить приложение AsterX

После любых ихменений с настройками пользователей в списке АТС в иитерфейсе приложения необходмио нажать "Обновить" - будет пересоздана локльаная база пользователей в коннекторе

Screenshot from 2025-07-29 10-30-44

Для автоматического запуска коннектора используйте Systemd

# /etc/systemd/system

[Unit]
Description=AsterX Connector
After=network.target

[Service]
User=asterx
WorkingDirectory=/opt/asterx
Environment="PATH=/opt/asterx/.venv/bin"
ExecStart=/opt/asterx/.venv/bin/python main.py

[Install]
WantedBy=multi-user.target