Инструкция для установки модуля FBX24 для интеграции FreePBX и Битрикс24 Корпоративный портал или облачная версия.

Предварительная подготовка. Для полноценной работы интеграции сервер, на котором будет работать интеграция, то есть инстанс FreePBX должен быть доступен из той сети, в которой будут работать пользователи Битрикс24. Если FreePBX не будет доступен, то некоторые функцию будут работать некорректно. При этом FreePBX должен быть доступен по протоколу HTTPS с валидным SSL сертификатом (Let’sEncrypt вполне достаточно). Для настройки вам понадобятся:

1. URL вашего сервера с FreePBX 2. URL вашего сервера с Битрикс24 3. Удостовериться, что домен Битрикс24 внесен в список разрешенных в сервисе FBX24.com 4. URL вашего GoIP устройства и логин и пароль пользователя, которому разрешено отправлять

SMS и USSD запросы (В случае, если вы планируете подключать GoIP для телефонии и использовать исходящие и входящие СМС)

5. Token авторизации от Tinkoff STT или Token авторизации от Google STT (В случае, если вы планируете использовать распознавание речи)

6. Проверить установлены ли пакеты ffmpeg, sox, python3

Настройка приложения в Битрикс24:

Шаги: 1. Установить Sangoma FreePBX c Asterisk 13 версии. 2. В Битрикс24 создать локальное приложение с разрешениями доступа к 


CRM (crm)
 Телефония (telephony)
 Телефония (совершение звонков) (call)
 Задачи (task)
 Встраивание приложений (placement) Пользователи (user)
 Чат и уведомления (im)


И Ссылками для приложения:
 адрес [https://адрес_вашего_pbx/fbx24/app.php]
 установка [https://fbx24.com/pbx/install.php]

3. После сохранения приложения, вам выдаст код и ключ приложения.

Сохраните их.

4. Кликните на меню созданного приложения ( ) и выберите Переустановить.

https://www.btrixsoft.com/pbx/install.php

5. Введите сохраненные значения в соответствующие поля.

6. Сохраните код, который вам выдаст система:

7. Обязательно нажмите кнопку “завершить установку”.

Установка модуля Для установки модуля перейдите в Module Admin в FreePBX /admin/config.php?display=modules&action=upload https://fbx24.com/pbx/fbx24_module.zip

Базовые установки После настройки приложения в Битрикс24, переходите к настройкам в FreePBX по ссылке /admin/config.php?display=fbx24&view=settings

Заполните своими данными все поля:

Bitrix24 domain - адрес вашего портала на Битрикс24. Важно, чтобы он был с https и БЕЗ слеша в конце.

Redirect URL - адрес вашего FreePBX. Этот адрес будет использоваться для доступа пользоталей битрикс24 к функциям, которые предоставляет интеграция, поэтому жтот адрес должен быть доступен из той сети, в которой будут пользователи битрикс24. Если биткикс24 испольуется через открытый интернет - то этот адрес тоже должен быть доступен через открытый интернет. Recordings URL - этот адрес может быть таким же, как и предыдущий. Но если ваш битрикс24 и FreePBX находятся в одной сети, можно этот адрес указать локальный, тогда записи в конце разговора будут быстрее попадать в битрикс24 через локальную сеть минуя WAN. Licensekey - Ключ, который вам выдал Битрикс24 при установке приложения FBX24.

Сохраните настройки нажав на кнопку Update Integration Settings После этого перейдите в раздел Status, чтобы проверить, работает ли интеграция.

Если все ОК, продолжайте настройку в разделе Options

Опции интеграции с Битрикс24

Activate Click2Call Event - создавать в Битрикс24 привязку события Click2Call. Если установить Yes, при клике на номере телефона в битрикс24 будет иницироваться входящий вызов на внутренний текущего пользователя Битрикс24, а после поднятия трубки, инициируется звонок клиенту. В статистику этот звонок попадает как исходящий. Activate Callback Event - создавать в Битрикс24 привязку события CallBack. Используется для обратного звонка на сайте. Callback destination - как обрабатывать обратный звонок. По какому именно сценарию в Астрериск. Default user - Очень важная настройка! Определяет, на какой номер направлять звонки и входящие SMS, если номер телефона, от которого поступило событие не был найден в базе битрикс24 (в Контактах, Сделках или Лидах). Call to assigned user first - Звонить в первую очередь ответственному, за которым закреплен данный клиент в Битрикс24. Change assigned user after answer - если при входящем звонке трубку взял кто-то другой, не ответственный за данного клиента - то заменять ответственного на того, кто взял трубку.

Enable Bitrix24 transfer

Настройки пользователей “Users”

Extension - присваивает локальный номер конкретному пользователю Битрикс24. Transcrib. Language - язык, на котором инициировать распознавания для данного пользователя. Выбор других языков, кроме русского действует только для Google STT. Эта настройка используется, если кто-то из сотрудников разговаривает на ином языке, чем язык по умолчанию, который установлен в разделе STT. Также этой настройкой можно принудительно отключить распознавание речи для конкретного сотрудника.

Настройки интеграции с GoIP и шаблоны номеров телефонов

Phone number format templates - Устанавливает форматирование номера для телефонов, которые попадают в Битрикс24. Также с учетом этих шаблонов производится поиск по базе телефонов в битрикс24. Для битрикс24 телефон +7495….. И 7295…. - это разные телефоны, поэтому стоит приводить телефоны к одному формату. Формат шаблона: 12(количество цифр номера):+(что добавить спереди)############(знак решетки в количестве цифр номера);11:+7###########;10:+70##########; В шаблоне не должно быть пробелов и других лишних знаков.

GoIP Host - IP или URL вашего GoIP устройства GoIP username и GoIP password - логин и пароль к GoIP GoIP sim card count - количество симкарт в GoIP (1,4,8,32); Phone numbers of simCards - номера телефонов каждой симкарты перечисленные через “;”. Если какой-то слот пропущен - введите две точки с запятой подряд. Check simcard ballance in Status tab - включить проверку баланса в разделе Status. Проверка баланса через USSD команды не быстрый процесс, который занимает от 5 секунд и больше, в зависимости от количества симкарт, соответсвенно, раздел Status может загружаться достаточно долго, поэтому, на время настройки системы, стоит выключить проверку статуса. USSD commands for ballance - USSD команды для проверки баланса отличаются у разных операторов. Здесь нужно ввести команды получения баланса для каждой симкарты через “;”. Если вам необходимо пропустить какую-то из симкарт, введите два или более символов “;” подряд.

Прием входящих SMS от GoIP

Для получения входящих SMS от GoIP необходим SMS сервер. В данной интеграции есть встроенный SMS сервер, к которому подключается GoIP и в последствии все входящие смс попадают в хранилище в базе данных FreePBX. В момент получения входящего сообщения, FBX24 обращается к Битрикс24, ищет клиента по номеру входящего сообщения, и если находит, то прикрепляет смс-ку как комментарий к контакту. Также, если у контакта есть установлен ответственный, ему в чат приходит сообщение о входящем SMS.

GoIP SMS Server IP - укажите IP адрес вашего FreePBX сервера. Если у него есть насколько адресов, укажите тот, к которому будет присоединяться ваш GoIP. GoIP SMS Server username и GoIP SMS Server password - логин и пароль, который будет использовать GoIP для подключения в к SMS серверу. GoIP SMS server port - порт, на котором стартовать SMS сервер. Default Bitrix24 user ID for SMS - ID пользователя битрикс24, на какой слать уведомление о входящем SMS, если исходящий номер не был найден в базе Битрикс24. Enable GoIP SMS server - включение и выключение SMS сервера. Для того, чтобы эта функция работала корректно, в crontab нужно вставить строку, которые есть в подсказке: * * * * * nohup php /var/www/html/admin/modules/fbx24/bin/sms_server.php & Важно, чтобы в конце был символ “&”.

Интеграция исходящих SMS и стоимость исходящих звонков.

Active sms - Выбор Yes добавляет в битрикс24 обработчик исходящих SMS используя GoIP. GoIP line # for outgoing SMS - определяет номер исходящей линии для отправки SMS из Битрикс24. Outgoing call price - Цена минуты исходящего звонка. Используется для того, чтобы рассчитывать примерную стоимость звонка. Currency of price - валюта цены, может быть в виде: USD, RUB, EUR,UAH и .т.д.

Меню Status Если вы настроили все корректно, то у вас должно получиться что-то похожее:

Преобразование речи в текст

Для настройки преобразования речи в текст (Speech to Text, STT) вам необходимо настроить Python3 на сервере, где работает FreePBX. Для этого вам необходимо в консоли из под пользователя root выполнить следующие команды: yum install centos-release-scl yum install rh-python36 easy_install-3.6 pip pip3 install --upgrade protobuf google-cloud google-cloud-speech google-cloud-storage Если все прошло успешно, выполните команду: whereis python3.6 Вам отобразится что-то вроде “/usr/bin/python3.6” Этот путь вам понадобится, чтобы ввести его в форме раздела STT. Также вам необходимо будет оставить заявку на сайте https://voicekit.tinkoff.ru/ В течении нескольких часов вы получите токены для подключения к STT Tinkoff. Если вы планируете использовать распознавание речи от Google, вам понадобятся ключи доступа к Google API. Select STT Engine - выберите движок для распознавания речи. Default recognition Language - Язык по умолчанию, который используется для STT. Если вы выберете “Don't transcribe” , по умолчании речь не будет трансрибироваться, можно будет включить распознавание только для отдельных пользователей. Это может оптимизировать использование распознавания. Python3 path - для работы FreePBX использует Python2. То есть, нельзя перевести систему на использование Python3, без вреда для системы. Поэтому необходимо установить отдельную версию Python3. В этом поле необходимо ввести путь интерпретатору python3. Time limit, seconds - Часто не стоит распознавать слишком длинные разговоры с клиентами, потому что это может оказаться чрезмерно дорого. Для этого, вы можете установить верхний порог длительности разговора, после достижения которого, разговор уже не будет распознаваться. 0 - без лимитов. Transcribtion price for 1 sec - цена одной секунды транскрибирования. Currency of price - валюта цені одной секунды транскрибирования. Может быть в виде: USD, RUB, EUR,UAH и .т.д. Tinkoff STT integration API KEY и API SECRET - ключи, которые были получены после регистрации на сайте https://voicekit.tinkoff.ru/ Google STT integration API KEY - ключ для google API - это JSON файл, который вы скачаете в течении настройки API. Вам необходимо скопировать содержимое этого файла, и вставить в поле этого пункта.

https://voicekit.tinkoff.ru/https://voicekit.tinkoff.ru/

Ускорение Click2Call Каждый раз, когда вы кликаете на номер телефона в битрикс24, происходит длинная цепочка событий:

1. Клик отсылается на сервер битрикс24, 2. Он обрабатывается на сервере битрикс24 3. Данные отсылаются на сервер авторизации oauth.bitrix.info 4. Там данные обрабатывается 5. Данные отсылаются на сервер FreePBX для инициализации звонка. 6. И только тогда Астериск получает команду на совершение звонка.

Иногда на на разных шагах возникают задержки, которые влияют на отзывчивость системы. С помощью кода, приведенного ниже мы можем убрать шаг 3 и 4, что на практике приводит к значительному ускорению инициализации звонка, и повышает анонимность, потому что история ваших звонков не уходит в компанию Битрикс. Использовать такой хак можно только на коробочной версии битрикс24. Необходимо добавить строки в битрикс24 в файл: /bitrix/php_interface/dbconn.php if($_REQUEST['COMMAND'] === 'startCallViaRest' || $_SERVER['REQUEST_URI'] === '/rest/voximplant.call.startViaRest.json') { define('BITRIXREST_URL', 'http://192.168.1.76'); } Вместо 192.168.1.76 указать IP адресе сервера с FreePBX, где установлен модуль FBX24. Если битрикс24 в локальной сети с FreePBX можно добавить запись в /etc/hosts 192.168.1.14 demo.bitrix.site Это позволит направить трафик вызовов в локальную сеть, без выхода наружу.

Отслеживание звонков модулем FBX24. Для того, чтобы звонки попадали в Битрикс24, необходимо выбрать, что именно будет отслеживаться с помощью модуля. FBX24 поддерживает отслеживание Inbound (/admin/config.php?display=did) и Outbound (/admin/config.php?display=routing) направлений. Для этого необходимо активировать в соответствующих направлениях модуль FBX24.

Важно! Если вы используете функцию folowMe для вызова сотрудника через исходящий транк, нужно создать дополнительный исходящий маршрут с дополнительным префиксом, на который будут отправляться звонки из FolowMe. Для этого маршрута не надо активировать FBX24, потому что на один звонок модуль будет активироваться дважды, и в результате вы получите некорректное поведение модуля.

Лог событий Если вы зайдете в меню Log, то там найдете лог событий, которые происходят в системе. Его удобно использовать для поиска причин неполадок, и в период настройки системы.