> For the complete documentation index, see [llms.txt](https://itgro-aly.gitbook.io/test-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://itgro-aly.gitbook.io/test-docs/ustanovka-modulya/itgrix-amo-setup/readme.md). # README Инструкция полной установки в видео {% embed url="" %} ## {% embed url="" %} ## 1. Установка приложения в amoCRM. Установку нужно осуществлять под учетной записью с правами Администратора. Для корректной работы приложения, необходимо установить приложение в amoCRM. Раздел amoМаркет\ В поисковой строке наберите **Itgrix**, либо Asterisk. Выберите приложение **"Asterisk connector Itgrix"**. либо по ссылке **https\://***company***.*****amocrm.ru*****/settings/widgets#amo\_itgrix**\ где *company*.*amocrm.ru* - название вашей amoCRM. Согласитесь с передачей данных и установите приложение. \\ ## 2. Настройка функции click-to-call и отображения карточек звонков Выберите: Использовать наш click-to-call сервер, либо укажите IP-адрес сервера с модулем, для того, что принимать запросы на звонок по клику из CRM. Выберите нужно ли показывать карточку звонка. [см. описание](broken://pages/eb2fc32350f3e5328e2ac78ab5430b45d70a6418)\ **Обязательно сохраните данные.** {% hint style="warning" %} **Важно: Если вы не используете внешний c2c сервер, то нужно указать внешний адрес вашей сети и пробросить порт 8077 до сервера, где установлена серверная часть коннектора.** **При использовании нашего сервера с2с, на сервере с модулем должен быть доступен наш адрес .** {% endhint %} ## 3. Установка модуля на сервер. {% hint style="info" %} Видео процесса установки {% endhint %} {% embed url="" %} **2.1 Установка** Для установки воспользуйтесь автоматическим скриптом.\ Скачайте скрипт по ссылке\ `wget https://itgrix.ru/download/autoinstaller_amo.sh` Запустите скрипт\ `bash autoinstaller_amo.sh` В конце установки **задайте login/password** для входа в админку модуля. В дальнейшем эти данные можно будет изменить в конце конфиг файла `/etc/itgrix_amo/config.json` в разделе Webserver. **2.2 Запуск модуля** Если в операционной системе установлена **служба systemctl** , то **модуль запуститься автоматически**, либо запускаем его **вручную**: `service itgrix_amo start`\ `service itgrix_amo status` **2.3 Настройка модуля интеграции**\ Далее настройку мы рекомендуем производить через мастер настройки в Админке модуля (веб-интерфейс доступен по ссылке `http://:8077/config/master`). ## 4. Шаги мастера: 1. **Подключение к Базе данных.**\ Мастер найдет доступы к БД. Также будет проверена доступность таблиц CEL, CDR, и последние записи в них. Если данные не найдены, их можно найти следующим образом\ Смотрим файлы: `/etc/asterisk/res_odbc.conf` или `/etc/asterisk/res_odbc_additional.conf`Находим:\ `[asteriskcdrdb]`\ `username=>freepbxuser`\ `password=>mysqlsecret`\ Вы можете создать своего пользователя в MySQL. Потребуются права на чтение таблиц с данными CDR и CEL. 2\. **Подключение к Астериск.** Выберите существующего пользователя или создайте нового, от имени которого модуль будет отправлять команды в AMI. Если модуль установлен не на сервер Астериск, то для создания пользователя нужно:\ 1\) внести изменения в файл `/etc/asterisk/manager_custom.conf`\ (если его нет, правим файл `/etc/asterisk/manager.conf`): `[amo]`\ `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\. **Способ хранения файлов записей** Укажите путь до файлов записей. Обычно они лежат по адресу `/var/spool/asterisk/monitor`\ Выберите, как организована структура каталогов. Для FreePBX по умолчанию они разложены по подпапкам Год/Месяц/День. 4\. **Подключение к amoCRM.** Укажите здесь адрес портала, просто скопировав его из адресной строки.\ Нажмите "Получить код".\ В открывшемся окне авторизуйтесь в своей CRM и получите код.\ Полученный код укажите в поле. Пройдите проверку. 5\. **Завершение** Завершите настройку, нажав кнопку "Завершить" в конце страницы и автоматически перейдете на страницу Бизнес-логики ## 5. **Бизнес-логика** Если все этапы пройдены успешно, завершите настройку.\ Вы будете перенаправлены в раздел настройки Бизнес-логики. `http://:8077/config#business_logic,`\ где `` - адрес сервера с Asterisk, на который установлен модуль интеграции. Настройте логику работы коннектора. {% hint style="warning" %} Обязательно укажите **соответствие номеров** в телефонии и пользователей в CRM. Если у одного пользователя есть несколько внутренних номеров или настроено перенаправление на сотовый, то для корректной регистрации звонков на дополнительные номера их **нужно прописать в админке** либо в конфиге: `"amo": {`\ `"users": {`\ `"101": "user_id_1",`\ `"102": "user_id_1",`\ `"89121234567": "user_id_1"`\ `}`\ `}` {% endhint %} {% hint style="warning" %} **Для сохранения настроек нажмите кнопку “Сохранить” на каждой измененной странице.** {% endhint %} ## 6. Настройка https ссылок для прослушивания записей разговоров В админке Настройки - Модуль 1. Нужно **включить функцию** "Использовать https порт". 2. Порт по умолчанию 8078 (можно изменить). Для того, чтобы записи были доступны снаружи сети, порт **8078 должен быть открыт** до Астериска. 3. **Добавить путь** к сертификату и ключу. Обычно их можно найти по адресу `/etc/asterisk/keys/` Нужны адреса на файлы `<ваш домен>.pem` и `<ваш домен>.key` Проще всего получить сертификат через сервис [letsencrypt](https://letsencrypt.org/ru/). 4. Сохранить настройки. {% hint style="success" %} **Установка завершена!** {% endhint %} {% hint style="info" %} Для прослушивания разговоров CRM - должен быть доступ на сервер с модулем с использованием протокола HTTPS: [проброшен порт 8078](https://docs.itgrix.ru/how-to-fix/ssl-certificate) и установлены корректные ssl сертификаты. Это связано с [запретом браузерами смешанного содержимого](https://docs.itgrix.ru/how-to-fix/mixed-content-v-google-chrome). {% endhint %} Дополнительно можно * настроить [автораспределение](file:///settings/autodistribution/), * проверить [функцию click-to-call](file:///1659967/Archive.zip/#2.-nastroika-funkcii-click-to-call-i-otobrazheniya-kartochek-zvonkov), При необходимости проведите дополнительные [кастомизации](file:///custom_common/). Для тестирования рекомендую придерживаться [описанного порядка тестов](file:///settings/test/test-amocrm.md).