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

Модуль состоит из двух частей: приложения, устанавливаемого на портал Битрикс24, и серверного приложения.
3 простых шага установки!

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

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

Есть два способа установки приложения. Первый подойдет только для облачной версии Битрикс24, а второй как для облачной, так и коробочной версий.

1 способ:

На сайте Битрикс24 в разделе Приложения, введите в поиске "Астериск" и найдите Интеграция с Asterisk.

На сайте

Нажимаете кнопку Попробовать и введите название своего облачного портала.

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

2 способ:

Если у вас коробочная или облачный портал, то установить модуль можно так. Зайдите в раздел Приложения (слева в расширенном меню), введите в поиске "Астериск" и установите Интеграция с Asterisk.

Согласитесь с условиями пользовательского соглашения и завершите установку.

Приложение платное, действует триальный (бесплатный) период 14 дней.

После установки откроется интерфейс (смотрите ниже). Введите адрес сервера, где установлен модуль и порт 8078.

В Битрикс24 опубликована также бесплатная версия модуля (Asterisk-коннектор Itgrix). Бесплатное приложение работает с ограничениями (1 транк и 2 пользователя). Для снятия ограничений в бесплатной версии нужно оплатить подписку.

Вид бесплатной версии

Если у вас коробочная версия, обращаем ваше внимание, что для коробки есть 2 маркетплейса:

Первый, как и для облака, располагается в основном портале в разделе Приложения. Все также, как описано выше: при поиске Астериск, находите приложение "Интеграция с Asterisk (зеленая аватарка) и устанавливаете. Оно полностью работает в коробке. Второй маркетплейс располагается в разделе Администрирование, в нем размещаются приложения только для коробочной версии. При установки приложения "Интеграция с Asterisk" из этого раздела, произойдет установка приложения из первого маркетплейса. Хотя статус приложения будет указан "Не установлено", приложение все же будет у Вас в портале.

1.2. Передача прав на использование приложения всем авторизованным пользователям

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

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

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

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

Видео процесса установки

Видео установки модуля Itgrix (bx24asterisk) на сервер Asterisk

1.Откройте Консоль (Терминал), войдите на сервер Asterisk: ssh ipasterisk -l root где ipasterisk - это ip-адрес сервера Asterisk. Введите пароль.

2. Для автоматической установки скачайте скрипт командой: curl -O https://bx24asterisk.ru/download/autoinstaller.sh

3. Запустите установку командой: bash autoinstaller.sh

Скрипт автоматически определит разрядность системы (32х/64х), скачает нужную версию архива, установит приложение и задаст первичные настройки.

4. В конце установки задайте login/password для входа в интерфейс настройки модуля (админку).

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

4. Для перехода в мастер-установки скопируйте и вставьте в браузер ссылку, показанную в конце процесса установки:

10.0.0.53 - это ip-адрес нашего тестового сервера, у Вас будет свой.

Если в операционной системе установлена служба systemctl, то модуль запустится автоматически,

Если systemctl нет, то запускаем модуль вручную: service bx24asterisk start

Проверка статуса: service bx24asterisk status

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

Далее настройку мы рекомендуем производить через мастер настройки Itgrix. Мастер настройки размещен по адресу https://ipasterisk:8078/config/master ipasterisk - адрес сервера Asterisk, где установлен модуль. Перейдите по ссылке, согласитесь в браузере что доверяете источнику. Для входа используйте логин и пароль, установленные на прошлом шаге

Для полной настройки модуль нужно будет подключить (указать адрес/логин/пароль) к трем системам: - базе данных MySQL, - AMI интерфейс Asterisk, - портал Битрикс24

Логика работы модуля

Видео процесса настройки

3.1. Шаги мастера настройки

Шаг 1. Подключение к Базе данных.

Мастер найдет доступы к БД. Согласитесь с ними. Он проверит доступность таблиц CEL (call event log) и наличие в ней актуальных записей (за последний час). Проверит наличие таблицы CDR (call detail record) и названия файлов записей в ней.

Если данные не найдены. Проблема скорее всего в модуле или связи с базой.

Но данные можно найти следующим образом: Смотрим файлы: /etc/asterisk/res_odbc.conf или /etc/asterisk/res_odbc_additional.conf.

Находим: [asteriskcdrdb] username=>freepbxuser password=>mysqlsecret

Указываем эти данные на странице мастера настройки

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

Шаг 2. Подключение к Asterisk.

Выберите существующего пользователя или создайте нового, от имени которого модуль будет отправлять команды в AMI.

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

Если модуль установлен не на сервер с Астериск, то для создания пользователя сделайте: 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.

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

Для корпоративных порталов важно, чтобы пользователь был в составе компании (не экстранет).

К сожалению, API Битрикса разрешает отправку нужных запросов по телефонии только пользователю с полными правами администратора.

Шаг 4. Настройка бизнес-логики

Если все этапы пройдены успешно, завершите настройку. Вы будете перенаправлены в раздел настройки Бизнес-логики.

Для сохранения настроек нажмите кнопку Сохранить на каждой измененной странице.

Настройка бизнес-логики в веб-интерфейсе коннектора

Установка завершена.