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

![3 простых шага установки!](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-49b3b58433cf12491ee45d8a40c6ac0f903c16ce%2FAmoCRM.png?alt=media)

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

{% embed url="<https://youtu.be/dKtz_sh2FQ8>" %}

##

{% embed url="<https://youtu.be/R-qK54gKdUA>" %}

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

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

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

Раздел amoМаркет\
В поисковой строке наберите **Itgrix**, либо Asterisk. Выберите приложение **"Asterisk connector Itgrix"**.

либо по ссылке **https\://***company***.*****amocrm.ru*****/settings/widgets#amo\_itgrix**\
где *company*.*amocrm.ru* - название вашей amoCRM.

<figure><img src="https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-af21feacdb3204abd69c52e1541cbbed623adebb%2FamoMarket.jpg?alt=media" alt=""><figcaption><p>Установка виджета</p></figcaption></figure>

Согласитесь с передачей данных и установите приложение. \\

## 2. Настройка функции click-to-call и отображения карточек звонков

Выберите: Использовать наш click-to-call сервер, либо укажите IP-адрес сервера с модулем, для того, что принимать запросы на звонок по клику из CRM.

Выберите нужно ли показывать карточку звонка. [см. описание](https://docs.itgrix.ru/ustanovka-modulya/itgrix-amo-setup/kartochka-zvonka-v-amocrm)\
**Обязательно сохраните данные.**

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2F6GypWvAP95q991bAAyrT%2FwidgetSettings.png?alt=media\&token=1c66cb45-0b5b-4ed1-815b-d4bc973141f9)

{% hint style="warning" %}
**Важно: Если вы не используете внешний c2c сервер, то нужно указать внешний адрес вашей сети и пробросить порт 8077 до сервера, где установлена серверная часть коннектора.**

**При использовании нашего сервера с2с, на сервере с модулем должен быть доступен наш адрес <https://apix.itgrix.ru>.**
{% endhint %}

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

{% hint style="info" %}
Видео процесса установки
{% endhint %}

{% embed url="<https://youtu.be/iIrYiHBDzqQ>" %}

**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://<Asterisk IP>:8077/config/master`).

## 4. Шаги мастера:

1. **Подключение к Базе данных.**\
   Мастер найдет доступы к БД. Также будет проверена доступность таблиц CEL, CDR, и последние записи в них.

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-326a6e79e7a07d20bdd24ecbf044558580580b83%2Fimage.png?alt=media)

Если данные не найдены, их можно найти следующим образом\
Смотрим файлы: `/etc/asterisk/res_odbc.conf` или `/etc/asterisk/res_odbc_additional.conf`Находим:\
`[asteriskcdrdb]`\
`username=>freepbxuser`\
`password=>mysqlsecret`\
Вы можете создать своего пользователя в MySQL. Потребуются права на чтение таблиц с данными CDR и CEL.

2\. **Подключение к Астериск.**

Выберите существующего пользователя или создайте нового, от имени которого модуль будет отправлять команды в AMI.

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-06befc3a72b7f4ed72cd744b6be9b051b9c3a3dc%2Fimage.png?alt=media)

Если модуль установлен не на сервер Астериск, то для создания пользователя нужно:\
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 по умолчанию они разложены по подпапкам Год/Месяц/День.

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-3b225976432df67942f41c86694abc41c7d9b749%2Fimage.png?alt=media)

4\. **Подключение к amoCRM.**

Укажите здесь адрес портала, просто скопировав его из адресной строки.\
Нажмите "Получить код".\
В открывшемся окне авторизуйтесь в своей CRM и получите код.\
Полученный код укажите в поле. Пройдите проверку.

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-698c264e5382cb4ceccf7a054063d58c3902dccf%2Fimage.png?alt=media)

5\. **Завершение**

Завершите настройку, нажав кнопку "Завершить" в конце страницы и автоматически перейдете на страницу Бизнес-логики

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-e13b2044d0b193c931e4a3206bafc45dff403581%2Fimage.png?alt=media)

## 5. **Бизнес-логика**

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

`http://<Asterisk IP>:8077/config#business_logic,`\
где `<Asterisk IP>` - адрес сервера с Asterisk, на который установлен модуль интеграции.

Настройте логику работы коннектора.

![](https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2Fgit-blob-7ef72b993d4dc668ccc8aa4d43ff4f7e22e31b26%2FamoBlogic.jpg?alt=media)

{% 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 ссылок для прослушивания записей разговоров

В админке Настройки - Модуль

<figure><img src="https://349598197-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M-rywOcELBwBcmtSBHS%2Fuploads%2FY7puOWeObGOba4VRJWOM%2FhttpsCert.png?alt=media&#x26;token=da5e0858-1869-4bce-b1bc-51ac33d76b9c" alt=""><figcaption></figcaption></figure>

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 %}

Дополнительно можно

* настроить [автораспределение](https://docs.itgrix.ru/settings/autodistribution),
* проверить [функцию click-to-call](#2.-nastroika-funkcii-click-to-call-i-otobrazheniya-kartochek-zvonkov),

При необходимости проведите дополнительные [кастомизации](https://docs.itgrix.ru/custom_common).

Для тестирования рекомендую придерживаться [описанного порядка тестов](https://docs.itgrix.ru/settings/test/test-amocrm).
