3 простых шага установки!
Есть два способа установки приложения. Первый подойдет только для облачной версии Битрикс24, а второй как для облачной, так и коробочной версий.
На сайте Битрикс24 в разделе Приложения, введите в поиске "Астериск" и найдите Интеграция с Asterisk.
На сайте
Нажимаете кнопку Попробовать и введите название своего облачного портала.
Вы будете перенаправлены в свой портал. Согласитесь с условиями использования и пользовательским соглашением, и завершите установку.
Если у вас коробочная или облачный портал, то установить модуль можно так. Зайдите в раздел Приложения (слева в расширенном меню), введите в поиске "Астериск" и установите Интеграция с Asterisk.
Согласитесь с условиями пользовательского соглашения и завершите установку.
Приложение платное, действует триальный (бесплатный) период 14 дней.
После установки откроется интерфейс (смотрите ниже). Введите адрес сервера, где установлен модуль и порт 8077. После нажатия на кнопку Сохранить откроется админка (веб-интерфес настройки модуля интеграции).
В Битрикс24 опубликована также бесплатная версия модуля (Asterisk-коннектор Itgrix). Бесплатное приложение работает с ограничениями (1 транк и 2 пользователя). Для снятия ограничений в бесплатной версии нужно оплатить подписку.
Вид бесплатной версии
Если у вас коробочная версия, обращаем ваше внимание, что для коробки есть 2 маркетплейса:
Первый, как и для облака, располагается в основном портале в разделе Приложения. Все также, как описано выше: при поиске Астериск, находите приложение "Интеграция с Asterisk (зеленая аватарка) и устанавливаете. Оно полностью работает в коробке. Второй маркетплейс располагается в разделе Администрирование, в нем размещаются приложения только для коробочной версии. При установки приложения "Интеграция с 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
Далее настройку мы рекомендуем производить через мастер настройки Itgrix. Мастер настройки размещен по адресу https://ipasterisk:8078/config/master
ipasterisk
- адрес сервера Asterisk, где установлен модуль. Перейдите по ссылке, согласитесь в браузере что доверяете источнику. Для входа используйте логин и пароль, установленные на прошлом шаге
Для полной настройки модуль нужно будет подключить (указать адрес/логин/пароль) к трем системам: - базе данных MySQL, - AMI интерфейс Asterisk, - портал Битрикс24
Логика работы модуля
Мастер найдет доступы к БД. Согласитесь с ними. Он проверит доступность таблиц 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.
Выберите существующего пользователя или создайте нового, от имени которого модуль будет отправлять команды в 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’
Укажите здесь доменное имя портала, просто скопировав его из адресной строки (например, https://portal.bitrix24.ru). Должен быть указан протокол https (если у вас не выбрано на портале другое). Укажите логин и пароль администратора портала, от имени которого модуль будет посылать команды в Битрикс24.
В тарифах Битрикс24 есть ограничение на количество администраторов портала. Не превышайте это количество, иначе новый администратор не будет функционировать и модуль не сможет осуществлять запросы к порталу.
Для корпоративных порталов важно, чтобы пользователь был в составе компании (не экстранет).
К сожалению, API Битрикса разрешает отправку нужных запросов по телефонии только пользователю с полными правами администратора.
Если все этапы пройдены успешно, завершите настройку. Вы будете перенаправлены в раздел настройки Бизнес-логики.
Для сохранения настроек нажмите кнопку Сохранить на каждой измененной странице.
Настройка бизнес-логики в веб-интерфейсе коннектора