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

![3 простых шага установки!](/files/-MA60Q3gVNCyiJwlWtDO)

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

{% 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="/files/Dn9jc5ydjwjghQyV6f7i" alt=""><figcaption><p>Установка виджета</p></figcaption></figure>

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

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

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

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

![](/files/PO9EBydPpp4AgxAkLmw8)

{% 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, и последние записи в них.

![](/files/-MSc2O3LwDvgphJKMO3f)

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

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

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

![](/files/-MSc2KF6aX-XnlE-BAko)

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

![](/files/-MSc2_ghmJCBH_QGy3_N)

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

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

![](/files/-MSc1nnGDdliW49AIiPh)

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

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

![](/files/-MSc3O3ogbyi0uRurUbR)

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

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

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

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

![](/files/Z8w3uKLfsWhlamSmu46p)

{% 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="/files/ZmJM0eg9FiYTbNrnpfPw" 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 %}

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

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

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

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


---

# 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-amo-setup.md?ask=<question>
```

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.
