Подключить FreePBX к Битрикс24

Результат: звонки с FreePBX попадают в Битрикс24 с карточкой, записью и автосозданием лидов, а клик по номеру в CRM запускает звонок с телефона сотрудника.

Что потребуется

Что	Откуда
Домен портала, например company.bitrix24.ru или company.bitrix24.by	Адресная строка браузера
Публичный адрес FreePBX и пароль AMI-пользователя callbee	Настройка AMI
Ссылка на записи	Публикация записей
ID сотрудника Битрикс24, ответственного за пропущенные	Откройте профиль сотрудника в Битрикс24: число в адресе .../company/personal/user/123/ и есть ID

Шаг 0. Заполните внутренние номера в Битрикс24

Callbee узнаёт, кто из сотрудников за каким телефоном сидит, из поля «Внутренний телефон» в профиле сотрудника Битрикс24. Для каждого сотрудника, который работает со звонками:

1. Откройте Сотрудники, карточку сотрудника, Редактировать.
2. В поле «Внутренний телефон» введите его внутренний номер на FreePBX, например 101. Номер должен быть длиной от 2 до 4 цифр: более длинные номера Callbee не считает сотрудниками.
3. Сохраните.

Без номера сотрудник не увидит карточку звонка и не сможет звонить по клику. Список сотрудников интеграция читает при запуске и при каждом сохранении настроек в кабинете: если заполнили номера позже, откройте карточку интеграции и нажмите «Сохранить» в настройках, или перезапустите интеграцию.

Шаг 1. CRM & PBX

В my.callbee.io откройте Интеграции и нажмите «Создать».

Поле	Значение
Выбор CRM	BITRIX24
Bitrix24 домен	домен портала без https://, например company.bitrix24.by
Вариант установки	Приложение из маркета
PBX	ASTERISK

Нажмите «Продолжить».

Шаг 2. AMI

Поле	Значение
AMI сервер	публичный адрес FreePBX и порт через двоеточие: pbx.company.by:5038
AMI имя пользователя	callbee — имя секции в manager_custom.conf
AMI пароль	пароль из той же секции, без пробелов в начале и конце

Нажмите «Продолжить».

Шаг 3. Asterisk

Поле	Значение
Ссылка на запись разговора	адрес, по которому папка записей FreePBX открывается из интернета, например https://recs.company.by/ или http://pbx.company.by:50381/monitor
Игнорировать линии (DID)	номера, звонки на которые не нужно передавать в CRM, через пробел. Обычно пусто

Как Callbee использует ссылку: запись передаётся в Битрикс24 ссылкой, файл скачивает сам Битрикс24. Поэтому адрес должен открываться из интернета, а не только из офиса. К адресу Callbee добавляет путь файла, как он лежит на АТС внутри /var/spool/asterisk/; если в ссылке уже есть monitor, всё начиная с него Callbee отрежет и подставит сам. Подходят оба варианта из таблицы.

Нажмите «Продолжить».

Шаг 4. Все линии (DID)

Это правила для всех входящих, у которых нет своей линии; на исходящие из них действует только «Создавать лид». Отдельные линии по городским номерам добавляются после создания интеграции.

Поле	Что делает
ID пользователя (ответственный за пропущенные)	На этого сотрудника регистрируются звонки с номеров, которых нет в CRM, в том числе пропущенные. Если звонящий есть в CRM, звонок уходит ответственному за его контакт или лид
Умная маршрутизация	Если звонящий есть в CRM и у ответственного заполнен «Внутренний телефон», Callbee переводит звонок на него
Время сотрудника (учёт рабочего времени в Битрикс24)	Умная маршрутизация работает, только когда ответственный начал рабочий день в Битрикс24. Выключено — действует окно ниже
Умная маршрутизация по времени	Окно, например 09:00–18:00, в часовом поясе из шага 5. Вне окна звонок идёт по обычному маршруту АТС
Создавать лид	При входящем или исходящем звонке с номером, которого нет в CRM, Битрикс24 создаёт лид. После ответа на входящий лид переназначается на ответившего сотрудника
Добавлять в чат	После завершения звонка Битрикс24 присылает ответственному сообщение о звонке в чат

Нажмите «Продолжить».

Шаг 5. Регион

Поле	Значение
Регион	код региона, где развёрнут ваш сервис Callbee: BY — Беларусь, RU — Россия, DE — Финляндия и остальная Европа
Часовой пояс	пояс офиса, например Europe/Minsk

Часовой пояс используется для окна умной маршрутизации и расписаний сотрудников.

Нажмите «Создать».

---

После создания

Интеграция появится в списке со статусом ACTIVE. Откройте её карточку: вкладка Лицензия показывает пробный период и лимит сотрудников, вкладка Логи — журнал интеграции.

В журнале должны быть строка +++ INTEGRATION START +++ и список B24 USER ID: USER PHONE с внутренними номерами сотрудников. Если списка нет, вернитесь к шагу 0.

Интеграция сама создаёт в Битрикс24 внешнюю линию «Auto select line» и привязывает события звонков. Не удаляйте их: без них не работает звонок по клику.

Проверка

1. Позвоните с мобильного, которого нет в CRM, на городской номер компании. У сотрудника, чей внутренний номер звонит, в Битрикс24 всплывёт карточка звонка.
2. Ответьте, поговорите несколько секунд, положите трубку. В Битрикс24 у ответившего появится звонок с записью, а если включено «Создавать лид» — лид на этого сотрудника.
3. Позвоните с другого мобильного, которого тоже нет в CRM, и не отвечайте. Пропущенный звонок появится у сотрудника с ID из шага 4, в деле — «Ожидание ответа N сек». Если позвонить с номера из пункта 1, пропущенный уйдёт ответственному за уже созданный лид.
4. В Битрикс24 откройте созданный лид или контакт с номером вашего тестового мобильного и нажмите на номер. Внутренний телефон сотрудника зазвонит, после ответа АТС соединит с клиентом. Если включён автоответ, телефон снимет трубку сам.

Общий чек-лист после первого звонка: Первый звонок.

Если что-то не работает

Симптом	Причина, куда смотреть
Журнал пуст, нет строки INTEGRATION START	Интеграция не может подключиться к AMI: неверный адрес или пароль, либо порт 5038 закрыт для IP Callbee (permit в конфиге или firewall FreePBX). Отдельного текста ошибки в журнале не будет. Проверьте адрес и пароль в карточке интеграции и настройку AMI, IP-адреса
В журнале список B24 USER ID пуст или без нужного сотрудника	Не заполнен «Внутренний телефон» в Битрикс24 или он не совпадает с номером на АТС. Шаг 0
Карточка не всплывает у конкретного сотрудника	Та же причина: номер в Битрикс24 не совпадает с номером, на который звонит АТС
Звонок есть, записи нет; в журнале attach record bitrix24 error или no the call recording file	Ссылка на записи не открывается из интернета или файл по ней не найден. Публикация записей
Умная маршрутизация не переводит	У ответственного нет внутреннего номера; сейчас вне окна; включено «Время сотрудника», а рабочий день в Битрикс24 не начат; звонящего нет в CRM
Клик по номеру не звонит; в журнале CLICK TO CALL - USER (ID N) NUMBER IS NONE	У сотрудника нет «Внутреннего телефона», он уволен в Битрикс24, или сотрудников больше лимита лицензии (вкладка Лицензия): лишние с конца списка не обслуживаются
Клик по номеру не звонит, в журнале Bitrix24 error	Callbee не может вызвать Битрикс24: перезапустите интеграцию, при повторе переустановите приложение Callbee в Битрикс24
В журнале LICENSE NOT VALID или LICENSE NOT ACTIVE	Закончился пробный период или лицензия, интеграция остановлена. Продление: support@callbee.io

Другие случаи: Решение проблем.

Что дальше

• Линии по городским номерам. В карточке интеграции на вкладке Линии добавьте линию с DID и своими правилами: ответственный, создавать лид, умная маршрутизация, окно времени. Звонки на DID без своей линии обрабатываются по настройкам шага 4.
• Управление пользователями. Если удобнее вести внутренние номера, мобильные и расписания сотрудников в кабинете, а не в профилях Битрикс24, включите этот режим на вкладке Пользователи.
• По запросу в поддержку для FreePBX доступны: отключение карточки для всех или для списка номеров, вебхук о пропущенных в вашу систему, пауза перед отправкой записи.