# Установка модуля интеграции Битрикс24 и Asterisk ![3 простых шага установки!](/files/-M0NcDgfWBnUQ6XTPtMV) Инструкция полной установки в видео {% embed url="" %} ## 1. Установка и настройка модуля в Битрикс24 ### 1.1. Установка приложения Есть **два способа** установки приложения. {% hint style="info" %} Первый подойдет **только для облачной** версии Битрикс24,\ а второй как для облачной так **и для коробочной.** {% endhint %} #### 1 способ: На сайте Битрикс24 в разделе **Маркет (Приложения)** введите в поиске "Itgrix" и выберите [**Asterisk интеграция: Itgrix**](https://www.bitrix24.ru/apps/app/itgro.asterisk/?utm_source=bz/)[ ](https://www.bitrix24.ru/apps/app/itgro.asteriskbx24free/?utm_source=bz/)(или просто перейдите по [ссылке](https://www.bitrix24.ru/apps/app/itgro.asterisk/?utm_source=bz/)). Нажмите кнопку **Попробовать,** введите **название своего облачного портала** и нажмите **Продолжить**. ![](/files/2ZKGUtJyTWjUqmU9canY) ![](/files/iDH8Ush3RWlxWcCVLTSt) Вы будете перенаправлены на приложение в вашем корпоративном портале.\ Согласитесь с условиями использования и пользовательским соглашением, и завершите установку. {% hint style="warning" %} Приложения доступны для установки, только если у вас есть **активная платная лицензия Битрикс24** либо **включен демо-режим**.\ \ С 09.12.2024 для установки **любых интеграционных приложений** должен быть включен триал, либо **оплачена подписка на Маркетплейс.**\ Подробнее о Маркет Плюс в [отдельной статье.](/faq/bx24-market-subscription.md) {% endhint %} #### 2 способ: Зайдите в раздел **Приложения - Маркет** в вашем корпоративном портале (раздел в левом боковом меню), введите в поисковой строке **"Itgrix"** и выберите **Asterisk интеграция - Itgrix,** нажмите Установить. ![коннектор Itgrix в вашем корпоративном портале](/files/sFTujMnpcy1T9Zzxlebq) Согласитесь с условиями пользовательского соглашения и завершите установку. ![](/files/uwKq3Jsvkv5zOwgmil9o) После установки откроется форма для контактов. Введите свои данные для получения информации об окончания лицензии. После заполнения формы вы увидите число дней до завершения лицензии и кнопки для самостоятельно покупки лицензии. ![](/files/V3LYDBfzZMkiYs6h0Vuh) {% hint style="danger" %} С 09.12.24 Изменилась структура приложений для **Маркета**\ **В доменной Ru зоне** работает приложение по подписке [**Интеграция Asterisk и Битрикс24** ](https://www.bitrix24.ru/apps/app/itgro.asterisk/?utm_source=bz/).\ Ранее работающее приложение с оранжевым лого скрыто из РФ Маркетплейса.\ \ **В доменах KZ** и других работает приложение [**Asterisk интеграция: Itgrix** ](https://www.bitrix24.kz/apps/app/itgro.asteriskbx24free/?utm_source=bz/).\ \ Все ранее установленные приложения на порталах сохраняются, их удалять не советуем. {% endhint %} {% hint style="success" %} При первой установке действует **бесплатный тестовый период – 7 дней и еще на 7 дней продлеваем при обращении в ТП** затем автоматически включается [ограниченный режим](/faq/itgrix-versions.md). {% endhint %} ### 1.2. Передача прав на использование приложения всем авторизованным пользователям Заново зайдите в раздел **Приложения - Маркетплейс**, откройте вкладку **Установленные** приложения, а затем Права доступа – и предоставьте всем пользователям портала права на использование приложения. ![Откройте раздел Приложения - Маркет](/files/LF6oQiAGYXKu6Qoh1WbZ) ![Зайдите в раздел Установленные](/files/LyC2ZQsoslSF6YQzidAk) ![Приложения → Установленные → Права доступа](/files/MlDNW3wVnZ7dI8he3vyH) В появившемся окне нужно выбрать раздел Другое и отметить **“Все авторизованные пользователи”**. Затем сохранить изменения, нажав Выбрать. ![Другое → Все авторизованные пользователи → Выбрать](/files/Kd0213n2Ad3RYyX5sMtG) ### 1.3 Установка внутренних номеров телефонов пользователям Битрикс24 Для успешной работы у пользователей должны быть указаны внутренние номера телефонов.\ Карточка звонка будет показываться и звонки будут фиксироваться только для тех пользователей, у которых указан внутренний номер. Указать внутренний номер можно каждому пользователю самостоятельно в своем профиле. Либо администратору через список сотрудников. ![](/files/1YGICkWwCFapYAEYeWCp) ![](/files/jYcgETu6xf1aXSrd6o13) ## 2. Установка модуля на сервер Asterisk Удобнее всего установить модуль на сервер с Asterisk. Если нет возможности установить модуль на сервер с Asterisk, то можно установить его на сервер с коробочным Битрикс24, либо на сторонний сервер, подходящий [по техническим параметрам](/ustanovka-modulya/trebovaniya-k-sisteme.md). ### Видео процесса установки {% embed url="" %} Процесс установки модуля Itgrix на сервер Asterisk {% endembed %} ### Пошаговая инструкция 1\. **Откройте Консоль** (Терминал), войдите на сервер Asterisk:\ `ssh -l root`\ где `` - это адрес сервера Asterisk, куда будет установлен модуль.\ Введите пароль. 2\. Для автоматической установки **скачайте скрипт** командой:\ `wget https://itgrix.ru/download/autoinstaller_bx.sh` 3\. **Запустите установку** командой:\ `bash autoinstaller_bx.sh` Скрипт автоматически определит разрядность системы (32х/64х), скачает нужную версию архива, установит приложение и задаст первичные настройки. 4\. В конце установки **задайте login/password** для входа в интерфейс настройки модуля (админку). ![](/files/-M0v76V5H15XKy3e6J3i) В дальнейшем эти данные можно будет изменить в конфиг-файле, который можно найти здесь: `/etc/itgrix_bx/config.json` 5\. Для **перехода в мастер установки** скопируйте и вставьте в браузер ссылку, показанную в конце процесса установки вида:\ `http://:8077/config/master`\ Где `` - это адрес сервера, на который был установлен модуль. {% hint style="warning" %} Если в операционной системе установлена служба systemctl, то модуль запустится автоматически. Если systemctl нет, то запускаем модуль вручную:\ `service itgrix_bx start` Проверка статуса:\ `service itgrix_bx status` {% endhint %} ## 3. Настройка модуля интеграции Далее настройку мы рекомендуем производить через мастер настройки Itgrix в Админке (веб-интерфейс модуля интеграции).\ Мастер настройки размещен по адресу:\ `http://:8077/config/master`\ Где`` - адрес сервера Asterisk, на который был установлен модуль.\ Перейдите по ссылке, подтвердите в браузерном уведомлении, что доверяете источнику.\ Для входа используйте **логин и пароль**, установленные на прошлом шаге. ![](/files/TujumUtLjfVVjGwI2DmI) Для полной настройки модуль нужно будет подключить (указать адрес/логин/пароль) к трем системам:\ \- к базе данных MySQL,\ \- к AMI интерфейсу Asterisk,\ \- к корпоративному порталу Битрикс24. ![Схема подключения модуля](/files/-M1jCgh9tPRh-qwMvmV1) ### Видео процесса настройки {% embed url="" %} ### Пошаговая инструкция настройки #### **Шаг 1.** Подключение к Базе данных. Мастер найдет доступы к БД. **Согласитесь** с ними.\ Он проверит доступность таблиц CEL (call event log) и наличие в них актуальных записей (за последний час).\ Проверит наличие таблицы CDR (call detail record) и названия файлов записей в ней. ![](/files/83etOVdRUlybwJRfGARR) {% hint style="info" %} **Если данные не найдены.**\ Проблема, скорее всего, в модуле или в связи с базой. Тогда данные можно найти следующим образом:\ Смотрим файлы:\ `/etc/asterisk/res_odbc.conf` или `/etc/asterisk/res_odbc_additional.conf`. Находим:\ `[asteriskcdrdb]`\ `username=>freepbxuser`\ `password=>mysqlsecret` Указываем эти данные на странице мастера настройки. Вы можете создать своего пользователя в MySQL. Потребуются права на чтение таблиц с данными CDR и CEL. {% endhint %} #### **Шаг 2.** Подключение к Asterisk. Выберите существующего пользователя или создайте нового, от имени которого модуль будет отправлять команды в AMI. ![](/files/YugDFxNlUS6PZhirfuev) {% hint style="danger" %} Если **мастер не находит пользователей**, то он либо установлен не на сервер с Asterisk, либо имеются проблемы с подключением к серверу. В этом случае, пожалуйста, [обратитесь в техподдержку](/contacts.md). {% endhint %} {% hint style="info" %} **Если модуль установлен не на сервер с Астериск**,\ то для создания пользователя:\ 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’` {% endhint %} #### **Шаг 3**. Подключение к Битрикс24. **1. Укажите доменное имя портала**, просто скопировав его из адресной строки (например, `https://portal.bitrix24.ru`).\ Должен быть указан протокол https (если у вас на портале не выбрано другое). *** ![](/files/i9ZeUeyPsFXxYwFvcqFc) **2. Выберите, какое из приложений в портале вы используете:** * Интеграция с Asterisk: **бесплатный** коннектор Itgrix (для маркета в регионах KZ и .com) ![](/files/9XacvYG2aTfVSJA84fGE) * Интеграция с Asterisk: Itgrix **по подписке** [Подробнее о подписном приложении](/faq/bx24-market-subscription.md) ![](/files/2RvDvaMpYAA0OTAE7CPg) **3. Нажмите на кнопку Получить код.** {% hint style="info" %} Учетная запись Битрикс24 должна обладать правами Администратора (можно сделать отдельную запись). Не рекомендуется использовать учетную запись интегратора т.к. в дальнейшем она может быть удалена, что приведет к ошибке авторизации модуля. \*\*\*\* {% endhint %} Если вы уже были авторизованы в портале, то вам откроется страница с длинным 20-ти значным кодом.\ Если вы не авторизованы, то сначала нужно авторизоваться, а затем выполнить этот шаг.\ Далее введите код в поле \*\*\*\* Код авторизации и **нажмите кнопку Проверить.** ![](/files/LE17K8Je6Xytp4kLOMLs) **Возможные ошибки:** * Пользователь, под которым вы авторизовались, **не является админом** на портале\ (вы должны быть администратором, чтобы передать приложению нужные права для работы); * Выбрано **не то приложение**, которое установлено на портале (измените приложение, получите код заново и нажмите кнопку Повторить шаг); * Для подписного приложения должна быть активна лицензия на Маркет.Плюс. {% hint style="warning" %} В [тарифах Битрикс24](https://www.bitrix24.ru/prices/) есть ограничение на количество администраторов портала. Не превышайте это количество.\ На корпоративных порталах для авторизации приложения важно, чтобы пользователь был в составе компании (не экстранет, не уволенный). {% endhint %} #### **Шаг 4.** Настройка бизнес-логики Если все этапы пройдены успешно, завершите настройку. Вы будете перенаправлены в раздел настройки **Бизнес-логики**. Для сохранения настроек нажмите кнопку **Сохранить** на каждой измененной странице. ![Настройка бизнес-логики в веб-интерфейсе коннектора](/files/MOL5k7mRkUHgLyfhhVrv) {% hint style="success" %} Установка завершена.\ Для тестирования работы используйте [описанный порядок тестов](/settings/test/test-bitrix24.md). {% endhint %} {% hint style="info" %} Дополнительно\ \- проверьте работу [функцию click-to-call](/settings/click-to-call.md),\ \- настройте [автораспределение](/settings/autodistribution.md) входящих звонков,\ \- определитесь со [сквозной аналитикой](/settings/additional/end-to-end-analytics.md).\ При необходимости проведите дополнительные [кастомизации](/custom_bx.md). {% endhint %} {% hint style="info" %} Для прослушивания разговоров по ссылкам в CRM - должен быть доступ на сервер с модулем с использованием протокола HTTPS: [проброшен порт 8078](https://docs.itgrix.ru/how-to-fix/ssl-certificate) и установлены корректные ssl сертификаты. Если используется загрузка файлов записей напрямую на портал - настройка порта 8078 не требуется. Это связано с [запретом браузерами смешанного содержимого](https://docs.itgrix.ru/how-to-fix/mixed-content-v-google-chrome). {% endhint %} В любом случае не стесняйтесь писать в нашу [техническую поддержку](/contacts.md) через чат в вашем Битриксе или через телеграмм. {% hint style="info" %} Скачать отчет для техподдержки можно со страницы Состояние системы. {% endhint %}
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.itgrix.ru/ustanovka-modulya/itgrix-bx-setup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.