Вы находитесь на странице: 1из 20

Настройка модуля интеграции

Битрикс24 и Asterisk
1. Требования к системе 2
1.1 Требования к Asterisk 2
1.2 Требования к Битрикс24 2
1.3 Требования к сети 3
1.4 Требования к операционной системе сервера 3

2. Установка модуля интеграции Битрикс24 и Asterisk 4


2.1 Установка и настройка модуля в Битрикс24 4
2.1.1 Установка приложения 4
2.1.2 Передача прав на использование приложения всем авторизованным
пользователям 5
2.2 Установка модуля на сервер Asterisk 6
2.2.1 Установка модуля на сервер 6
2.2.2 Запуск модуля 6
2.3 Настройка модуля интеграции 6
2.4 Настройка профилей пользователей Битрикс24 12
2.5 Настройка click-to-call в Битрикс24 13
2.5.1 Определить формат ссылки callto 13
2.5.2 Задать приложение по умолчанию для исходящих звонков 14
2.5.3 Особенности настройки click-to-call в коробочной версии 1С-Битрикс24 15
2.6 Настройка автоматического распределения вызовов на ответственных сотрудников
15
2.7 Особенности настройки бесплатного режима приложения. 16

3. Проверка работы модуля интеграции 17


3.1 Исходящий звонок на неизвестный номер с ответом 17
3.2 Входящий отвеченный звонок с известного номера 17
3.3 Исходящий отвеченный звонок на известный номер кликом в Битрикс 17

Наши контакты 19

1
1. Требования к системе
1.1 Требования к Asterisk
Настройка производится под ​пользователем с правами:
➔ Просмотр и редактирование конфигурационных файлов Asterisk
➔ Установку дополнительного ПО на сервере, настройку его работы в качестве сервиса

Обязательные требования Как проверить

1. Asterisk 1.8​и выше (после стали $ asterisk -V


называть двузначными версиями 10-15)
Ответ: Asterisk 13, FreePBX 14

2. В ​Asterisk​включен и настроен ​AMI $ asterisk -rx 'manager show settings'

Ответ:
Manager (AMI): ​Yes
TCP Bindaddress: 0.0.0.0:​5038

3. Важно!​В Asterisk ​подключен​​CEL​с 1. Проверяем статус работы CEL:


хранением в MySQL и списком $ asterisk -rx 'cel show status'
необходимых ивентов:
CHAN_START Ответ:
CHAN_END CEL Logging: ​Enabled
ANSWER CEL Tracking Event: CHAN_START
LINKEDID_END CEL Tracking Event: CHAN_END
BLINDTRANSFER CEL Tracking Event: ANSWER
ATTENDEDTRANSFER CEL Tracking Event: BLINDTRANSFER
CEL Tracking Event: ATTENDEDTRANSFER
CEL Tracking Event: LINKEDID_END
...
CEL Event Subscriber: ​ODBC CEL backend

2. Проверяем информацию о последних событиях:


$ mysql
> use asteriskcdrdb;
> select id, eventtype, eventtime,
cid_num, exten, uniqueid, linkedid,
channame from cel order by id desc
limit 10;

Таблица должна быть не пустая, в ней должны


отображаться события звонка.

Логин/Пароль для подключения к mysql обычно


находится в /etc/astreisk/res_odbc_additional.conf

4.​Включена запись​разговоров и в CDR > select recordingfile from cdr order


есть информация об имени файла записи. by calldate desc limit 10;

Если через АТС были звонки, то в ответе должны


быть последние 10 названий файлов записей.

2
1.2 Требования к Битрикс24
Настройка портала производится пользователем, обладающим административными правами.
Для​коробочной версии 1С-Битрикс24 ​должны быть установлены и иметь актуальную
версию следующие модули:
1. Главный модуль Битрикс24 версии 16.5.11 и выше
2. Модуль “REST API (rest)”
3. Модуль “Телефония”
4. Модуль “CRM”
5. Модуль “Push&Pull”

К ​облачной версии Битрикс24​специфичных требований нет - модуль работает на любой


редакции.

1.3 Требования к сети


На сервере с модулем (обычно это сервер Asterisk), нужно разрешить исходящие запросы к:
1. Вашему порталу​Битрикс24​(облачному или локальному) по протоколу https или http.
2. Серверу авторизации Битрикс24​https://oauth.bitrix.info​(не важно, облачный у вас
Битрикс24 или коробочный!).
3. Cерверу лицензирования модуля ​ https://api.bx24asterisk.ru​.
Для полного функционала (click-to-call и прослушивания записей) - нужен доступ из внешней
сети на сервер с модулем (проброшен порт 8077 и 8078).

1.4 Требования к операционной системе сервера


Для проверки введите в командной строке ​# uname -a.
Хорошо проходит установка модуля на операционных системах:
● CentOS 6 и выше, настоятельно рекомендуем версию 7.
● Debian 7 и выше.
Мучительно проходит ​установка на FreeBSD​.
Не удалось провести интеграцию на операционных системах:
● CentOS 5
● Debian 6
● Gentoo
Если вы используете другую операционную систему, то для установки модуля необходимо,
чтобы в репозиториях ОС были пакеты: unixODBC, mysql-connector-odbc, mysql-server. Если
они уже установлены в ОС, то это сильно упростит установку модуля.

3
2. Установка модуля интеграции Битрикс24 и
Asterisk
Модуль состоит из приложения, устанавливаемого на портал Битрикс24, и серверного
приложения.

2.1 Установка и настройка модуля в Битрикс24

2.1.1 Установка приложения


Если приложение у вас уже открыто в портале ,то нажмите ​Установить​.

Если у вас ​облачная версия Битрикс24​, то установить приложение можно по прямой ссылке
https://www.bitrix24.ru/apps/?app=asterisk_bx24

Если у вас ​коробочная версия, ​обращаем ваше внимание, что для коробки есть 2
маркетплейса:
Первый, как и для облака, располагается в основном портале в разделе Приложения. Там так
же есть Интеграция с Asterisk (зеленая аватарка). Оно так же работает в коробка.
Второй маркетплейс располагается в разделе Администрирование, в нем размещаются
приложения только для коробочной версии.
Установив приложение Интеграция с Asterisk c оранжевой аватаркой, вы автоматически
установите нужное приложение из первого маркетплейса. Но статус приложение в разделе
Администрирование останется “Не установлен”. Это нормально )

4
2.1.2 Передача прав на использование приложения всем авторизованным
пользователям
Предоставьте всем пользователям портала права на использование приложения.
Приложения→ Установленные→ Права доступа.

В появившемся окне нужно выбрать раздел другое и отметить “Все авторизованные


пользователи”. Сохранить изменения.

2.2 Установка модуля на сервер Asterisk


Удобнее всего установить модуль на сервер с Asterisk, при выполнении требований, указанных
выше. Если нет возможности установить модуль на сервер с Asterisk, то можно установить его
на сервер с коробочным Битрикс24, либо на сторонний сервер, подходящий ​по техническим
параметрам.

5
2.2.1 Установка модуля на сервер
В том случае, если вы устанавливаете модуль в операционной системе ​Linux​, воспользуйтесь
автоматической системой установки:

# curl -O https://bx24asterisk.ru/download/autoinstaller.sh
# bash autoinstaller.sh

В конце установки ​задайте login/password​для входа в ​админку ​модуля.


В дальнейшем эти данные можно будет изменить в разделе Webserver конфиг файла
/etc/bx24asterisk/config.json

2.2.2 Запуск модуля


Если в операционной системе установлена ​служба systemctl​, то ​модуль запуститься
автоматически​,
либо запускаем его вручную:
service bx24asterisk start
service bx24asterisk status

2.3 Настройка модуля интеграции


Далее настройку мы рекомендуем производить через ​мастер настройки​, используя интерфейс
в вашем Битрикс24.
Введите адрес сервера, где установлен модуль и порт 8078. (см. рисунок)
При необходимости примите в браузере сертификат подлинности (SSL сертификат).

Вам откроется интерфейс мастера настройки (см.рисунок). Для входа используйте логин и
пароль установленные на шаге 2.2.1.

6
Если в интерфейсе не удалось открыть, то мастер настройки доступен по ссылке
https://<ipasterisk>:8078/config/master
(вместо <​ipasterisk> введите адрес сервера с установленным модулем интеграции).

Шаг 1. Подключение к Базе данных. ​Мастер найдет доступы к БД. Также будет проверена
доступность таблиц CEL (call event log) и наличие в ней записей в течение последнего часа.
Наличие табилцы CDR (call detail record) и названия файлов записей в ней.

Если данные не найдены, их можно найти следующим образом:


Смотрим файлы: /etc/asterisk/res_odbc.conf или /etc/asterisk/res_odbc_additional.conf.
Находим:
[asteriskcdrdb]
username=>freepbxuser

7
password=>mysqlsecret
Вы можете создать своего пользователя в MySQL. Потребуются права на чтение таблиц с
данными CDR и CEL.

Шаг 2. Подключение к Астериск.​Выберите существующего пользователя или создайте


нового, от имени которого модуль будет отправлять команды в AMI.

Если модуль установлен на сервер с Астериск, то имеющиеся пользователи отобразятся


автоматически.
Если модуль установлен не на сервер с Астериск, то для создания пользователя сделайте:
1) внести изменения нужно в файл ​/etc/asterisk/manager_custom.conf
(если его нет, правим файл /etc/asterisk/manager.conf):
[bx24]
secret=asterisksecret ​(укажите свой)
deny=0.0.0.0/0.0.0.0
permit=127.0.0.1/255.255.255.0
read=cdr,reporting,originate
write=reporting,originate
2) После добавления нового пользователя нужно перегрузить Asterisk командой:
asterisk -rx 'manager reload’

Шаг 3. Подключение к Битрикс24​.


Укажите здесь доменное имя портала, просто ​скопировав ​его из адресной строки (например,
https://portal.bitrix24.ru).
Если у вас не выбрано на портале другое, должен быть указан протокол ​https​.
Укажите ​логин и пароль администратора ​портала, от имени которого модуль будет посылать
команды в Битрикс24 (см. рисунок).

8
Важно.​В ​тарифах Битрикс24​есть ограничение на количество администраторов портала. Не
превышайте это количество, иначе новый администратор не будет функционировать и модуль
не сможет осуществлять запросы к порталу.
К сожалению, текущий уровень развития API Битрикса разрешает отправку нужных запросов по
телефонии только пользователю с полными правами администратора. Для корпоративных
порталов важно, чтобы пользователь был в составе компании (не экстранет).

Если все этапы пройдены успешно, завершите настройку. Вы будете перенаправлены в раздел
настройки Бизнес-логики.
Для сохранения настроек нажмите ​кнопку Сохранить​​на каждой измененной странице​ .

9
Важно:​Настройте в первую очередь режим работы CRM:
● Если выбран “Режим без лидов”, то в CRM будут создаваться контакты и сделки, что
соответствует режиму “Простая CRM” в Битрикс24.
● Если этот пункт не выбран, то в CRM будут создаваться лиды, что соответствует режиму
“Классическая CRM”.
Проверить режим работы в вашем Битрикс можно так:

10
2.4 Настройка click-to-call
Битрикс24 поддерживает функцию click-to-call, когда при нажатии на телефонный номер в
портале совершается звонок.
Технически это выглядит так:
После нажатия на телефон модуль посылает команду originate в Asterisk (параметры можно
скорректировать в конфиг файле и кастомизаторе).
Asterisk дозванивается сначала до оператора. Когда тот поднимет трубку, Asterisk отправит
звонок наружу - клиенту.

Для того, чтобы click-to-call заработал, нужно определить формат ссылок callto в портале и
задать приложение “Интеграция с Asterisk” для обработки этих ссылок.

2.4.1 Определить формат ссылки callto


Путь до настройки: CRM → Настройки → Другое → Прочие настройки → Форматирование (см.
рисунок)

Там для “Формат вывода ссылок "callto" выбрать “Вызов через телефонию Битрикс24”

11
2.4.2 Задать приложение по умолчанию для исходящих звонков
Телефония → Настройки телефонии → Общие настройки (см. рисунок)
в поле “Номер для исходящего звонка по-умолчанию” выбрать пункт: “Приложение:
Интеграция с Asterisk”
Если приложения нет в списке, то скорее всего не установилась связь с серверной частью:
либо модуль не запущен, либо модуль не авторизовался в портале и нужно проверить через
админку.

В старом интерфейсе настройки были тут

12
2.4.3 Настройка click-to-call в админке модуля
Существует два варианта включения: открыть порт на маршрутизаторе для приема внешних
запросов из Битрикса, либо использование нашего click-to-call сервера для передачи запросов.

Для первого варианта:


1) укажите ваш внешний ip-адрес в поле “Адрес для запросов из Битрикса” в разделе
админки Настройка → Модуль (см. рисунок);
2) пробросьте порт 8077 на маршрутизаторе.

13
Если вы не хотите открывать порт, то можно использовать внешний click-to-call сервер.
Для этого включите опцию в разделе админки Настройка → Битрикс24 (см. рисунок).

2.5 Настройка профилей пользователей Битрикс24


Для корректной работы модуля у пользователей должен быть указан внутренний номер
телефона на портале. Именно по нему модуль определяет кому показать карточку и
зафиксировать ответственность за лида или контакт.
Если у пользователя нет внутреннего номера, то звонки и лиды этого пользователя не будут
попадать в портал.

Первый быстрый способ​указать внутренние номера через список пользователей


телефонии: Телефония →Настройки телефонии→Пользователи телефонии.

14
У пользователя нужно указать только внутренний номер. Приложение используется
по-умолчанию, Телефонный аппарат оставить не подключенным.

В старом интерфейсе настройка пользователя здесь (см.рисунок)

Второй способ​- добавить внутренний номер напрямую через профиль сотрудника.

15
Важно:​Если вы используете функцию ​FollowMe ​(перевод входящего звонок на сотовый
телефон), то этот сотовый телефон должен быть указан в профиле.

2.5.3 Особенности настройки click-to-call в коробочной версии


1С-Битрикс24
Для возможности совершения звонков (click-to-call) из коробочной версии Битрикс24
необходимо внести изменения в файл /home/bitrix/www/bitrix/php_interface/dbconn.php,
который можно найти через административный интерфейс 1С-Битрикс24 в разделе
Контент → Структура сайта → Файлы и папки → bitrix → php_interface → dbconn.php,
В файл добавьте код (где вместо ​ipasterisk:8077​введите адрес и порт сервера с
установленным модулем интеграции):

if($_REQUEST['COMMAND'] === 'startCallViaRest' || $_SERVER['REQUEST_URI']


=== '/rest/voximplant.call.startViaRest.json') {
define('BITRIXREST_URL', '​ipasterisk:8077​');
}

2.6 Настройка автоматического распределения вызовов на


ответственных сотрудников
Подробно о том, как создать дополнительный контекст для перевода звонка на ответственного
сотрудника описано в статье на нашем ​сайте​.

2.7 Особенности​настройки бесплатного режима приложения.


Бесплатное приложение​работает с одним транком и с двумя пользователями, указанными в
конфиге в настройках

16
Важно:​если указать несколько транков, то приложение будет работать только с первым,
идущем по возрастания.

На этом настройка интеграции Астериск и Битрикса в целом закончена и можно


переходить к тестированию звонков.

2.8 Прочие настройки​.


Проверьте правильность указания ​пути до записей​в разделе админки Настройка → Asterisk.
По умолчанию путь такой: ​/var/spool/asterisk/monitor

17
3. Проверка работы модуля интеграции

3.1 Исходящий звонок на неизвестный номер с ответом


Совершите исходящий звонок с внутреннего номера на внешний номер телефона, ответьте,
поговорите 6-10 секунд, положите трубку.
Имейте в виду, что внешний номер не должен быть указан как телефон у сотрудника, иначе
звонок будет считаться как вызов на сотрудника и лид создан не будет.

Результат:
1. Во время звонка и разговора отобразилось всплывающее окно.
2. Создан лид, ответственный за лид - сотрудник, совершивший исходящий звонок.
3. Создано дело “звонок исходящий”, ответственный - сотрудник, совершивший звонок.
4. В деле звонка прослушивается запись разговора.

Если не сработало:
Решение проблем с запуском приложения
Решение проблем с записью звонков
Не показывается карточка звонка звонка во время разговора

3.2 Входящий отвеченный звонок с известного номера


Совершите входящий звонок с известного внешнего номера (для которого в CRM есть Контакт)
на ваш внутренний, ответьте и поговорите 6-10 секунд, положите трубку.

Результат:
1. Если вы настроили автоматическое соединение с ответственным менеджером, вызов
направлен на ответственного за контакт сотрудника.
2. Во время звонка и разговора отобразилось всплывающее окно с информацией о
позвонившем Контакте.
3. Создано дело “Входящий звонок”, ответственный - сотрудник, принявший звонок.
4. В деле звонка прослушивается запись разговора.

Если не сработало:
Решение проблем с запуском приложения
Решение проблем с записью звонков
Не показывается карточка звонка звонка во время разговора

3.3 Исходящий отвеченный звонок на известный номер кликом в


Битрикс
Совершите исходящий звонок с внутреннего номера на внешний номер телефона, кликнув на
трубку/номер в Контакте - будет отправлена команда в астериск на исходящий звонок. На
внутренний телефон с номером кликнувшего пользователя придут звонок, после поднятия
трубки звонок уйдет на внешний номер.
Ответьте, поговорите 6-10 секунд, положите трубку.

Результат:
1. Во время звонка и разговора отобразилось всплывающее окно с информацией о Контакте.
18
2. Создано дело “звонок исходящий”, ответственный - сотрудник, совершивший звонок.
3. В деле звонка прослушивается запись разговора

Если не сработало:
Решение типичных проблем со звонком по клику

Дополнительная техническая и вспомогательная информация для


администраторов и интеграторов перенесена в ​
специальный
документ

Дополнительные статьи по решению проблем и кастомизаций можно


найти на нашем сайте в разделе Поддержка:
https://bx24asterisk.ru/support

19
Наши контакты
Если что-то пошло не так - напишите или позвоните нам
● Телефоны:
+7 499 350-88-90
+7 343 272-30-33
● E-mail: ​
bx24@itgro.ru
● Telegram: ​bx24asterisk_bot
● Найдите ​
чат с нами в своем портале​(коробочном или облачном, для новых
клиентов должен открываться автоматически):
1. Зайдите в раздел “Чат и звонки” в меню вашего портала
2. В поисковой строке введите “Модуль интеграции…”, нажмите поиск в
Битрикс24.Network
3. В списке будет раздел Открытые линии. Наш чат с зеленой аватаркой и
названием “Модуль интеграции Битрикс24 и Asterisk. Команда поддержки.”
4. Напишите нам свой вопрос, и мы вам ответим.

20

Вам также может понравиться