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

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

3 простых шага установки!

Инструкция полной установки в видео

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

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

Есть два способа установки приложения.

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

1 способ:

На сайте Битрикс24 в разделе Маркет (Приложения) введите в поиске "Itgrix" и выберите Asterisk интеграция: Itgrix (или просто перейдите по ссылке).

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

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

Приложения доступны для установки, только если у вас есть активная платная лицензия Битрикс24 либо включен демо-режим. С 9.12.2924 г для установки любых интеграционных приложений должен быть включен триал либо оплачена подписка на Маркетплейс. Подробнее о Маркет Плюс в отдельной статье.

2 способ:

Зайдите в раздел Приложения - Маркет в вашем корпоративном портале (раздел в левом боковом меню), введите в поисковой строке "Itgrix" и выберите Asterisk интеграция - Itgrix, нажмите Установить.

коннектор Itgrix в вашем корпоративном портале

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

После установки откроется форма для контактов. Введите свои данные для получения информации об окончания лицензии. После заполнения формы вы увидите число дней до завершения лицензии и кнопки для самостоятельно покупки лицензии.

С 09.12.24 Изменилась структура приложений для Маркета В доменной Ru зоне работает приложение по подписке Интеграция Asterisk и Битрикс24 . Ранее работающее приложение с оранжевым лого скрыто из РФ Маркетплейса. В доменах KZ и других работает приложение Asterisk интеграция: Itgrix . Все ранее установленные приложения на порталах сохраняются, их удалять не советуем.

При первой установке действует бесплатный тестовый период – 7 дней и еще на 7 дней продлеваем при обращении в ТП затем автоматически включается ограниченный режим.

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

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

Откройте раздел Приложения - Маркет

Зайдите в раздел Установленные

Приложения → Установленные → Права доступа

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

Другое → Все авторизованные пользователи → Выбрать

1.3 Установка внутренних номеров телефонов пользователям Битрикс24

Для успешной работы у пользователей должны быть указаны внутренние номера телефонов. Карточка звонка будет показываться и звонки будут фиксироваться только для тех пользователей, у которых указан внутренний номер.

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

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

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

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

Процесс установки модуля Itgrix на сервер Asterisk

Пошаговая инструкция

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

2. Для автоматической установки скачайте скрипт командой: wget https://itgrix.ru/download/autoinstaller_bx.sh

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

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

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

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

5. Для перехода в мастер установки скопируйте и вставьте в браузер ссылку, показанную в конце процесса установки вида: http://<Asterisk IP>:8077/config/master Где <Asterisk IP> - это адрес сервера, на который был установлен модуль.

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

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

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

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

Далее настройку мы рекомендуем производить через мастер настройки Itgrix в Админке (веб-интерфейс модуля интеграции). Мастер настройки размещен по адресу: http://<Asterisk IP>:8077/config/master Где<Asterisk IP> - адрес сервера Asterisk, на который был установлен модуль. Перейдите по ссылке, подтвердите в браузерном уведомлении, что доверяете источнику. Для входа используйте логин и пароль, установленные на прошлом шаге.

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

Схема подключения модуля

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

Пошаговая инструкция настройки

Шаг 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.

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

---

2. Выберите, какое из приложений в портале вы используете:

• Интеграция с Asterisk: бесплатный коннектор Itgrix

• Интеграция с Asterisk: Itgrix по подписке Подробнее о подписном приложении

3. Нажмите на кнопку Получить код.

Учетная запись Битрикс24 должна обладать правами Администратора (можно сделать отдельную запись). Не рекомендуется использовать учетную запись интегратора т.к. в дальнейшем она может быть удалена, что приведет к ошибке авторизации модуля. ****

Если вы уже были авторизованы в портале, то вам откроется страница с длинным 20-ти значным кодом. Если вы не авторизованы, то сначала нужно авторизоваться, а затем выполнить этот шаг. Далее введите код в поле **** Код авторизации и нажмите кнопку Проверить.

Возможные ошибки:

• Пользователь, под которым вы авторизовались, не является админом на портале (вы должны быть администратором, чтобы передать приложению нужные права для работы);

• Выбрано не то приложение, которое установлено на портале (измените приложение, получите код заново и нажмите кнопку Повторить шаг);

• Для подписного приложения должна быть активна лицензия на Маркет.Плюс.

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

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

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

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

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

Установка завершена. Для тестирования работы используйте описанный порядок тестов.

Дополнительно - проверьте работу функцию click-to-call, - настройте автораспределение входящих звонков, - определитесь со сквозной аналитикой. При необходимости проведите дополнительные кастомизации.

Для прослушивания разговоров по ссылкам в CRM - должен быть доступ на сервер с модулем с использованием протокола HTTPS: проброшен порт 8078 и установлены корректные ssl сертификаты.

Если используется загрузка файлов записей напрямую на портал - настройка порта 8078 не требуется.

Это связано с запретом браузерами смешанного содержимого.

В любом случае не стесняйтесь писать в нашу техническую поддержку через чат в вашем Битриксе или через телеграмм.