# Установка модуля интеграции Битрикс24 и Asterisk ![3 простых шага установки!](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-1cd8b7f8f35a4f268dda7d5803f394e73a5576fa%2FUntitled%20Diagram\(1\)\(1\)\(1\).png?alt=media) Инструкция полной установки в видео {% 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/)). Нажмите кнопку **Попробовать,** введите **название своего облачного портала** и нажмите **Продолжить**. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2F6RZytPOZbhBEp7V6WiK8%2F1new.png?alt=media\&token=2a23332c-18a8-4dc6-bcb0-c8ec99b4993c) ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FkonGkri6MMfdXtGwIGe0%2F2new.png?alt=media\&token=07f0f762-c2ec-47a4-98c0-144fcba90f0a) Вы будете перенаправлены на приложение в вашем корпоративном портале.\ Согласитесь с условиями использования и пользовательским соглашением, и завершите установку. {% hint style="warning" %} Приложения доступны для установки, только если у вас есть **активная платная лицензия Битрикс24** либо **включен демо-режим**.\ \ С 09.12.2024 для установки **любых интеграционных приложений** должен быть включен триал, либо **оплачена подписка на Маркетплейс.**\ Подробнее о Маркет Плюс в [отдельной статье.](https://docs.itgrix.ru/faq/bx24-market-subscription) {% endhint %} #### 2 способ: Зайдите в раздел **Приложения - Маркет** в вашем корпоративном портале (раздел в левом боковом меню), введите в поисковой строке **"Itgrix"** и выберите **Asterisk интеграция - Itgrix,** нажмите Установить. ![коннектор Itgrix в вашем корпоративном портале](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FLKAci3F0yVWT95h3GybK%2FnewApp3.png?alt=media\&token=6233161f-5110-40a8-884b-b29741327c0d) Согласитесь с условиями пользовательского соглашения и завершите установку. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2F899hxF5hFphKgxRtaUeI%2FinstNewApp.png?alt=media\&token=a86e84a2-be82-4075-98f4-5745100b961e) После установки откроется форма для контактов. Введите свои данные для получения информации об окончания лицензии. После заполнения формы вы увидите число дней до завершения лицензии и кнопки для самостоятельно покупки лицензии. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-244a449dba15b431edb61770f397c5db5e947ffe%2Fimage%20\(193\).png?alt=media) {% 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 дней продлеваем при обращении в ТП** затем автоматически включается [ограниченный режим](https://docs.itgrix.ru/faq/itgrix-versions). {% endhint %} ### 1.2. Передача прав на использование приложения всем авторизованным пользователям Заново зайдите в раздел **Приложения - Маркетплейс**, откройте вкладку **Установленные** приложения, а затем Права доступа – и предоставьте всем пользователям портала права на использование приложения. ![Откройте раздел Приложения - Маркет](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fb6fbQeEcVOPU8vp3eA9h%2F6new.png?alt=media\&token=3da74d57-f132-49ad-8dc1-3282ee68bece) ![Зайдите в раздел Установленные](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FxFculiDeWvUBVfAJRApe%2F7new.png?alt=media\&token=bd163fcc-7c89-4399-a41f-5be2dc64fd8b) ![Приложения → Установленные → Права доступа](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fxe5ehMfwFmksn7DEb2Zq%2F8new.png?alt=media\&token=3fb840c1-f47d-4178-9ff4-d7f6b2b77236) В появившемся окне нужно выбрать раздел Другое и отметить **“Все авторизованные пользователи”**. Затем сохранить изменения, нажав Выбрать. ![Другое → Все авторизованные пользователи → Выбрать](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fygq7NsJAG4kWXxiDiEOt%2F9new.png?alt=media\&token=7763fd33-8210-4d45-8351-542068ca2f9a) ### 1.3 Установка внутренних номеров телефонов пользователям Битрикс24 Для успешной работы у пользователей должны быть указаны внутренние номера телефонов.\ Карточка звонка будет показываться и звонки будут фиксироваться только для тех пользователей, у которых указан внутренний номер. Указать внутренний номер можно каждому пользователю самостоятельно в своем профиле. Либо администратору через список сотрудников. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-9937f111611e1cb8e1962e41c37b1743b7f5926c%2Fimage%20\(80\).png?alt=media) ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FeEjtRUo75xevC8PwZVTC%2F11new.png?alt=media\&token=86ab8021-192c-406a-b5e0-4bb9f3e471db) ## 2. Установка модуля на сервер Asterisk Удобнее всего установить модуль на сервер с Asterisk. Если нет возможности установить модуль на сервер с Asterisk, то можно установить его на сервер с коробочным Битрикс24, либо на сторонний сервер, подходящий [по техническим параметрам](https://docs.itgrix.ru/ustanovka-modulya/trebovaniya-k-sisteme). ### Видео процесса установки {% 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** для входа в интерфейс настройки модуля (админку). ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-00f283ae45273d1686d2ee33d81985f79db7f5b3%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5.png?alt=media) В дальнейшем эти данные можно будет изменить в конфиг-файле, который можно найти здесь: `/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, на который был установлен модуль.\ Перейдите по ссылке, подтвердите в браузерном уведомлении, что доверяете источнику.\ Для входа используйте **логин и пароль**, установленные на прошлом шаге. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FmaM04n0bmLeDZQ4hkhNb%2F1adminNew.png?alt=media\&token=52a79f10-52b7-461e-b63a-a535b9b9d080) Для полной настройки модуль нужно будет подключить (указать адрес/логин/пароль) к трем системам:\ \- к базе данных MySQL,\ \- к AMI интерфейсу Asterisk,\ \- к корпоративному порталу Битрикс24. ![Схема подключения модуля](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-5adc981a4e04f4c2499b6cb02d5d35fe2c83920a%2F%D0%94%D0%B8%D0%B0%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B0%20%D0%B1%D0%B5%D0%B7%20%D0%BD%D0%B0%D0%B7%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-Page-1%20\(3\).png?alt=media) ### Видео процесса настройки {% embed url="" %} ### Пошаговая инструкция настройки #### **Шаг 1.** Подключение к Базе данных. Мастер найдет доступы к БД. **Согласитесь** с ними.\ Он проверит доступность таблиц CEL (call event log) и наличие в них актуальных записей (за последний час).\ Проверит наличие таблицы CDR (call detail record) и названия файлов записей в ней. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fapo07LCJvkpMTTj5VSda%2F2adminNew.png?alt=media\&token=d4b045ef-db68-4379-8054-22e1c6e2ed27) {% 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. ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2F8nPJRSuRlbNkqXvSXnR8%2F3adminNew.png?alt=media\&token=a1bbe5be-cc63-4e68-a988-20403cbf8450) {% hint style="danger" %} Если **мастер не находит пользователей**, то он либо установлен не на сервер с Asterisk, либо имеются проблемы с подключением к серверу. В этом случае, пожалуйста, [обратитесь в техподдержку](https://docs.itgrix.ru/contacts). {% 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 (если у вас на портале не выбрано другое). *** ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fj5JH09iQVDoucYposxDE%2F4adminNew.png?alt=media\&token=5d7b1136-54f1-44f9-87c0-1269e83fecf5) **2. Выберите, какое из приложений в портале вы используете:** * Интеграция с Asterisk: **бесплатный** коннектор Itgrix (для маркета в регионах KZ и .com) ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2F6SsYeVeFdL41GFYoXaJB%2F13new.png?alt=media\&token=cf76f009-92d9-4f80-9c58-70ca0047496d) * Интеграция с Asterisk: Itgrix **по подписке** [Подробнее о подписном приложении](https://docs.itgrix.ru/faq/bx24-market-subscription) ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FwBY8w0N6OC3dmxEsQ0qx%2F12new.png?alt=media\&token=d5a2565d-cfea-4b0a-9fbe-f1e24f60085d) **3. Нажмите на кнопку Получить код.** {% hint style="info" %} Учетная запись Битрикс24 должна обладать правами Администратора (можно сделать отдельную запись). Не рекомендуется использовать учетную запись интегратора т.к. в дальнейшем она может быть удалена, что приведет к ошибке авторизации модуля. \*\*\*\* {% endhint %} Если вы уже были авторизованы в портале, то вам откроется страница с длинным 20-ти значным кодом.\ Если вы не авторизованы, то сначала нужно авторизоваться, а затем выполнить этот шаг.\ Далее введите код в поле \*\*\*\* Код авторизации и **нажмите кнопку Проверить.** ![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FYsA6tyCfRwleIAc47OQ2%2F5adminNew.png?alt=media\&token=b852ea10-5010-49bd-bb2d-aec528a16f99) **Возможные ошибки:** * Пользователь, под которым вы авторизовались, **не является админом** на портале\ (вы должны быть администратором, чтобы передать приложению нужные права для работы); * Выбрано **не то приложение**, которое установлено на портале (измените приложение, получите код заново и нажмите кнопку Повторить шаг); * Для подписного приложения должна быть активна лицензия на Маркет.Плюс. {% hint style="warning" %} В [тарифах Битрикс24](https://www.bitrix24.ru/prices/) есть ограничение на количество администраторов портала. Не превышайте это количество.\ На корпоративных порталах для авторизации приложения важно, чтобы пользователь был в составе компании (не экстранет, не уволенный). {% endhint %} #### **Шаг 4.** Настройка бизнес-логики Если все этапы пройдены успешно, завершите настройку. Вы будете перенаправлены в раздел настройки **Бизнес-логики**. Для сохранения настроек нажмите кнопку **Сохранить** на каждой измененной странице. ![Настройка бизнес-логики в веб-интерфейсе коннектора](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2F8TjSvNuLRHYnlAlHoZTI%2F6adminNew.png?alt=media\&token=973e7f84-edd8-40c3-b4f0-befbb5052bb1) {% hint style="success" %} Установка завершена.\ Для тестирования работы используйте [описанный порядок тестов](https://docs.itgrix.ru/settings/test/test-bitrix24). {% endhint %} {% hint style="info" %} Дополнительно \ \- проверьте работу [функцию click-to-call](https://docs.itgrix.ru/settings/click-to-call), \ \- настройте [автораспределение](https://docs.itgrix.ru/settings/autodistribution) входящих звонков, \ \- определитесь со [сквозной аналитикой](https://docs.itgrix.ru/settings/additional/end-to-end-analytics).\ При необходимости проведите дополнительные [кастомизации](https://docs.itgrix.ru/custom_bx). {% 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 %} В любом случае не стесняйтесь писать в нашу [техническую поддержку](https://docs.itgrix.ru/contacts) через чат в вашем Битриксе или через телеграмм. {% hint style="info" %} Скачать отчет для техподдержки можно со страницы Состояние системы. {% endhint %}