Модуль интеграции Bitrix24 позволяет интегрировать FreePBX c СРМ Битрикс24 (облачная/коробочная версии). Модуль без абонентской платы. Оплата разовая, без ограничений по времени и операторам.
Вид модуля
В входящем роуте (Inbound Routes) указываем направить в интеграцию с Битрикс24
Основные возможности:
- Показать карточку звонящего
2.Прикрепить запись к звонку
3. Маршрутизация звонка на основе — Учета рабочего времени Bitrix24.
4. Настройка добавочный номеров
В Bitrix24 одному сотруднику можно назначить только один внутренний номер( это минус), если у сотрудника две или более сип учеток, то интеграция уже не будет работать.
Данный функционал позволяет обойти это ограничение. Информация будет прикрепляться к нужному сотруднику, не зависимо на какой из своих внутренних, он взял трубку.
5.Дополнительные возможности приведены на скрине
Звонить согласно рабочему графику в Bitrix24 — если настроена интеграция рабочего времени с Bitrix24, то можно маршрутизировать входящий звонок на того сотрудника или сотрудников, у которых открыт рабочий день. Если сотрудников несколько, то звонок распределяется сразу на всех, как будто это ринг-группа.
Отображать карточку — показывать всплывающее окошко
- Нет — не показывать карточку в Б24.
- При ответе — показать в момент ответа на звонок. Только у того кто ответил на звонок.
- При звонке — показать карточку у тех операторов, у которых звонит сип телефон/софтфон.
Создавать лид — если номер не известный будет создан лид, если номер известен, то будет создано дело
Перенаправить на ответственного — если номер закреплен за ответсвенным в Битриксе, то будет попытка набрать ответсвенного 15 сек, если он не отвечает, то звонок пойдет по дефолтному маршруту.
Пользователь по умолчанию — Входящие звонки будут назначаться данному пользователю. Если звонок будет отвечен, то пользователь переопределяется на ответившего.
Ответственный за пропущенный звонок — за пропущенных звонок можно назначить отвественного менеджера или менеджера по-умолчанию. Этот параметр позволяет перекреплять ответственного за пропущенный звонок на пользователя в маршруте.
Отправить уведомление о пропущенном в чат — Если включено. То информация по пропущенным вызовам будет направляться в чат Битрикса. В этот чат можно добавить нужное количество сотрудников, которые будут мониторить пропущенные звонки.
Чат ID — Номер чата. Узнать можно, отправив в чат команду — /getChatId .
Системное сообщение — Если отключено, то сообщение будет отправлено от пользователя, под которым работает интеграция. При этому будут накручены счетчики сообщений у данного пользователя. По-умолчанию отправляется как системное.
Список пропущенных — Модуль позволяет фиксировать пропущенные звонки и подсчитывать их количество по каждому клиенту. Если параметр включен, то в чат кроме информации о пропущенном звонке, будет отправляна информация о всех пропущенных, с момента работы модуля. Это необходимо, чтобы всегда понимать сколько остальсно пропущенных и от каких клиентов. Если клиент дозвонился или оператор набрал клиента, то информация удаляется из списка пропущенных.
Пример как выглядит информация в чате о пропущенных звонках
В чате работают ссылки. Можно открыть карточку клиента или сделать звонок на номер клиента. Все для того чтобы не терять клиентов.
Обновлять статус пропущенного звонка — при пропущенному звонке битрикс создает не закрытое дело. Статус — Запланировано. Как на скрине.
Включение данного параметра, позволяет сразу закрывать дело по пропущенному звонку. По-умолчанию — включено.
Куда направить — цель входящего маршрута. Выбор перехода в любую точку FreePBX. Логика такая же, как при создании цепочки маршрута.
Можно прописать городские номера, чтобы отображать в PopUp окошке
Можно фиксировать исходящие звонки в Б24
Список исходящих маршрутов — это ссылка на исходящие маршруты(Outbound Routes) в FreePBX. Можно фиксировать исходяшие звонки в Bitrix24, только по нужным маршрутам.
Чтобы активировать маршрут, нужно нажать Статус — пиктограмму Play. Чтобы отключить — пиктограмму Stop.
Параметры исходящего маршрута.
Параметры похожи на входящие.
При успешном звонке обновлять список пропущенных — Если оператор дозвонился до пропущенного клиента, то из списка пропущенных будет удалена информация об этом номере. А так же в чат будет отправлено уведомление, что пользователь Bitrix24 дозвонился до клиента. 
Есть шаблон правил замены номера.
Если номер попадает под указанные правила, то номер будет форматироваться и передан в Битрикс24.
Решение состоит из двух частей
- Модуль интеграции Bitrix24 на FreePBX
- Настройка вебхуков в Bitrix24
Модуль устанавливается стандартно в меню Администратор -> Управление модулями.
Настройки модуля логически разбиты на 4 меню
- Список Входящих маршрутов
- Список Исходящих маршрутов
- Список городских линии
- Настройки подключения к Bitrix24
Настраивать начинаем с п4.
Секретный токен — код авторизации исходящего вебхука
URL Bitrix24 — URL REST входящего вебхука до /profile
URL вашего FreePBX — адрес АТС. Адрес нужно заполнить индивидуально под ваш случай. Если у вас облачный битрикс и АТС за NAT, то делаем проброс любого порта на веб порт АТС. и указываем внешний IP:port
Callback URL — адрес обработчика в Исходящем вебхуке (генерируется автоматически)
URL записи разговоров — адрес по которому можно будет прослушать ваши записи (генерируется автоматически)
Пользователь под которым работает интеграция — после того как будет настроена связка с Вебхуками, можно будет получить список пользователей. Рекомендуется для интеграции создать отдельного пользователя с нужными правами. Под этим пользователем нужно создать вебхуки.
Заходим в Битрикс, меню Приложения -> Вебхуки.
Создаем Входящий Вебхук. 
Название — указываем произвольное
Права доступа указываем как на скрине.
Копируем адрес URL для вызова REST до слова /profile и вставляем в поле URL Bitrix24 в настройках модуля интеграции.
Переходим к созданию Исходящего вебхука.
Адрес указываем произвольный, потом его переопределим
Название произвольное.
Тип события указываем как на скрине
На данном этапе нас интересует Код авторизации. Его нужно скопировать в поле Секретный токен в настройках модуля интеграции
После сохранения настроек модуля, будет сгенерирован Callback URL. Его нужно скопировать(переопределить) в Адрес обработчика Исходящего вебхука
Затем нужно проверить что связка с Вебхуками работает. Для этого нажимаем — Очистить кэш пользователей. Затем — получить пользователей Bitrix24.
Если связка настроена верно, то в выпадающем списке можно выбрать юзера Bitrix24.
В Битриксе указываем новое приложение — Asterisk CallBack, созданный исходящий вебхук, в качестве основного (https://our_domainbitrix.ru/telephony/configs.php)
