Установка и настройка

Подключение занимает около 30 минут при готовой АТС. Программист не нужен: установка выполняется мастером, диалплан руками править не придётся.

Что понадобится

  • Собственный сервер Asterisk с FreePBX 16 или 17 и Node.js версии 18 и выше.
  • Битрикс24 на тарифе, поддерживающем телефонию и приложения Маркетплейса.
  • Права администратора Битрикс24 — для установки приложения и настройки телефонии.
  • Права root на сервере FreePBX — для установки модуля.
  • Исходящий доступ с сервера АТС к сервису подключения Algomix по HTTPS (порт 443). Белый IP и внешний HTTPS не нужныподробнее.
  • Для коробочной версии Битрикс24 — действующий лицензионный ключ и валидный SSL-сертификат портала.

Шесть шагов подключения

  1. Установите приложение на портал Битрикс24

    После установки откроется мастер подключения. Он проведёт по всем шагам настройки со стороны портала.

  2. Получите код подключения портала

    Мастер выдаст одноразовый код — он свяжет ваш портал с АТС. Код действует ограниченное время; если истёк, просто получите новый.

  3. Установите модуль на сервере FreePBX

    Скачайте файл модуля «Bitrix24 Bridge» на странице загрузки и установите его в панели FreePBX: Admin → Module Admin → Upload. Установщик выполнит предварительные проверки окружения и сообщит, если чего-то не хватает.

  4. Введите код подключения

    Откройте настройки модуля в панели FreePBX и введите код из мастера — АТС и портал свяжутся автоматически через сервис подключения Algomix.

  5. Сопоставьте сотрудников

    Свяжите внутренние номера АТС с пользователями Битрикс24 — вручную или по внутреннему номеру из профиля сотрудника на портале.

  6. Проверьте связь тестовым звонком

    Позвоните на свой номер: карточка звонка появится в Битрикс24, а после разговора в таймлайне клиента появится дело с записью.

Переходите с ранее установленного модуля интеграции? В модуле есть мастер переноса настроек — сопоставления сотрудников и параметры подключения переедут без ручного ввода. Если нужна помощь — напишите в поддержку.

Типовые ситуации при установке

Сколько времени занимает установка?

Около 30 минут при готовой АТС: установка приложения на портал, установка модуля в FreePBX, ввод кода подключения и сопоставление сотрудников. Установщик модуля выполняет предварительные проверки окружения и сразу сообщает, если чего-то не хватает.

Нужно ли менять настройки транков и маршрутов?

Нет. Модуль не меняет транки, номера и правила маршрутизации — телефония продолжает работать как раньше. Интеграция подключается к событиям звонков, не вмешиваясь в существующий диалплан.

Что делать, если карточка звонка не всплывает?

Чаще всего внутренний номер сотрудника не сопоставлен с пользователем Битрикс24. Откройте раздел сопоставления в панели модуля и проверьте, что номер связан с нужным пользователем портала. Если сопоставление есть — проверьте статус связи с порталом в панели модуля.

Модуль не подключается к порталу — куда смотреть?

Проверьте, что с сервера АТС разрешён исходящий HTTPS-доступ (порт 443) к сервису подключения Algomix, а код подключения введён без опечаток и не истёк. Код одноразовый: если подключение прервалось, получите новый код в приложении на портале.

Запись разговора не прикрепляется к делу

Убедитесь, что запись разговоров включена на АТС и файл действительно создаётся в каталоге записей. Модуль передаёт в Битрикс24 ссылку на файл — сам файл остаётся на вашем сервере, поэтому каталог записей должен быть доступен модулю на чтение.

Не нашли ответ? Посмотрите документацию или напишите в поддержку — по вопросам установки помогаем в рамках любого тарифа.

Готовы подключить?

Скачайте модуль и пройдите шесть шагов — первые звонки появятся в CRM уже сегодня.