Подключение к порталу
Связь настраивается мастером по одноразовому коду подключения из приложения на портале. Статус связи отображается в панели модуля; при обрыве соединение восстанавливается автоматически.
Документация
Требования, настройка и эксплуатация модуля «Bitrix24 Bridge» для FreePBX. Пошаговая установка вынесена на отдельную страницу — Установка и настройка.
Системные требования
| Компонент | Требование |
|---|---|
| FreePBX | версия 16 или 17 |
| Asterisk | совместимость проверена вплоть до версии 22 |
| Node.js | версия 18 или новее |
| Права на сервере АТС | root — для установки модуля |
| Сеть | исходящий HTTPS (порт 443) к сервису подключения Algomix; входящие соединения не требуются |
| Битрикс24 | тариф с поддержкой телефонии и приложений Маркетплейса; права администратора портала |
| Коробочная версия Битрикс24 | действующий лицензионный ключ и валидный SSL-сертификат портала |
Установщик модуля перед установкой выполняет серию предварительных проверок окружения и сообщает о несоответствиях до внесения изменений.
Настройка модуля
Сопоставление сотрудников
Внутренние номера АТС связываются с пользователями Битрикс24 в разделе сопоставления. Доступна синхронизация по внутреннему номеру из профиля сотрудника на портале.
Записи разговоров
Модуль читает файлы из каталога записей АТС и передаёт в Битрикс24 ссылку на файл. Записи хранятся на вашем сервере; каталог должен быть доступен модулю на чтение.
Несколько порталов
Каждый портал подключается собственным кодом. Внутренние номера распределяются между порталами; события звонков доставляются на тот портал, за которым закреплён сотрудник.
Правила и автоматизация
Администратор настраивает автосоздание лидов, задачи по звонкам, оценку качества и правила подмены переменных канала — из панели модуля, без правки диалплана.
Обновления
Обновления модуля выходят в рамках подписки и устанавливаются через панель FreePBX так же, как первоначальная установка. Настройки при обновлении сохраняются.
Вопросы по эксплуатации
Как проверить, что связь с порталом активна?
Откройте панель модуля в FreePBX — статус подключения к порталу отображается на главном экране. Там же видно, какая линия зарегистрирована и когда было последнее событие.
Что происходит при перезагрузке АТС?
Служба модуля стартует автоматически вместе с системой и восстанавливает соединение с порталом. Звонки, прошедшие во время недоступности портала, фиксируются на АТС штатными средствами.
Как добавить нового сотрудника?
Создайте внутренний номер на АТС как обычно, затем свяжите его с пользователем Битрикс24 в разделе сопоставления. С этого момента звонки сотрудника попадают в CRM.
Влияет ли модуль на качество звука или маршрутизацию?
Нет. Модуль подключается к событиям звонков и не участвует в передаче голосового трафика. Транки, кодеки и маршруты работают как раньше.
Как удалить модуль?
Через панель FreePBX: Module Admin → Bitrix24 Bridge → Remove. Деинсталлятор останавливает службу модуля и удаляет его компоненты; настройки телефонии не затрагиваются.
Вопрос не раскрыт? Напишите в поддержку — ответим по регламенту и дополним документацию.
Исходный код и лицензия
Условия использования решения — в лицензионном соглашении, состав обрабатываемых данных — в политике конфиденциальности. Дистрибутив и контрольная сумма — на странице загрузки.