# Интеграция с Billmanager 6 Hosting & Cloud
## Установка и обновление

> Для настройки интеграции на стороне  Billmanager 6 Hosting & Cloud потребуется сотрудник с полными правами администратора в биллинге и с доступом до консоли сервера по SSH.

<br />

Для установки модуля Swarmica скачайте и распакуйте архив на сервер с установленным Billmanager 6 Hosting & Cloud:

```txt
wget https://support.swarmica.com/attachments/L/I/LI3IZ0MMJ84Mku4K_a/swarmica_billmanager.v1.3.10.zip
unzip swarmica_billmanager.v1.3.10.zip
```

Затем выполните команду `install.sh`:

```txt
chmod +x install.sh
./install.sh
```

Изменения применятся после перезагрузки биллинга (скрипт установки предложит это сделать автоматически).

Альтернативно, можно скачать и установить пакет для одной из [поддерживаемых OC](https://wiki.astralinux.ru/ispsystem/billmanager-hosting-cloud/trebovaniya-k-serveru-339503824.html):

DEB: [https://support.swarmica.com/attachments/e/Z/eZ0Rgk0pw7OiDxUS\_a/swarmica-billmanager-1.v1.3.10\_amd64.deb](https://support.swarmica.com/attachments/e/Z/eZ0Rgk0pw7OiDxUS_a/swarmica-billmanager-1.v1.3.10_amd64.deb)

RPM: [https://support.swarmica.com/attachments/R/r/RroG\_UyR7n6h9r9l\_a/swarmica-billmanager-v1.3.10-302.x86\_64.rpm](https://support.swarmica.com/attachments/R/r/RroG_UyR7n6h9r9l_a/swarmica-billmanager-v1.3.10-302.x86_64.rpm)

При первоначальной установке настройте интеграцию в веб-интерфейсе.

## Настройка на стороне Swarmica

### На сервере

1.  Добавьте в в `/root/swarmica/.env `в FEATURES  следующий флаг: `billmanager`
2.  Выполните команду&#x20;

```bash
docker compose down && docker compose up -d
```

### В интерфейсе

1\. В разделе **Настройки > Каналы > Billmanager** создайте новый канал:

![](https://support.swarmica.com/attachments/0/G/0G7gE01Eliw7VRSS_a/image.png)

**Название** - произвольное название канала для приёма заявок.

**URL биллинга** - ваш уникальный URL для использования Billmanager 6 Hosting & Cloud.

**Секретный ключ** – это произвольная последовательность символов, которая будет отвечать за авторизацию Swarmica на строне Billmanager 6 Hosting & Cloud.  Его можно сгенерировать автоматически. В случае изменения секретного ключа, впоследствии, не забудьте его обновить так же и на стороне Billmanager.

Чтобы сгенерировать ключ, перейдите в настройки созданного канала, нажав на него, а затем на значок в конце строки Секретный ключ:

![](https://support.swarmica.com/attachments/t/o/to1dDvr5kFBlLTgo_a/image.png)

Активируйте бегунок **Включен** для активации интеграции.

Скопируйте секретный ключ и UID канала из адресной строки браузера - эти данные понадобятся для настроек на стороне Billmanager:

![](https://support.swarmica.com/attachments/5/I/5IH76czCSTcEIEKu_a/image.png)

2\. В разделе **Настройки > API** и интеграции создайте новый API ключ и скопируйте его код - он так же понадобится для настроек на стороне Billmanager.

![](https://support.swarmica.com/attachments/h/n/hny4U6UxCjBEEfmP_a/image.png)

## Настройки на стороне Billmanager 6 Hosting & Cloud

В разделе **Интеграция > Swarmica** в боковом меню заполните форму:

![](https://support.swarmica.com/attachments/3/G/3GZgrRC3exQT_Czg_a/Screenshot_2025-02-01_at_12.16.15.png)

**URL** - ваш уникальный url для входа в Swarmica вместе с протоколом (http:// или https://).

**API токен** - код, полученный на стороне Swarmica в разделе API и интеграции.

**UID канала Billmanager в Swarmica** - UID из адресной строки на странице **Настройки > Каналы > Billmanager**:

![](https://support.swarmica.com/attachments/k/1/k1ivdjwtRsEEToUO_a/image.png)

**Секретный ключ** - ключ, который вы сгенерировали в настройках канала Billmanager на стороне Swarmica.

**ID пользователя биллинга** - ID привилегированного пользователя, от имени которого будут добавляться служебные комментарии. Требуется роль Администратор..

**MySQL TLS соединение** - если у вас отдельно стоящий MySQL сервер для Billmanager, который требует TLS для подключения - измените этот параметр на одно из значений false, true, preferred, skip-verify в зависимости от настроек сервера MySQL.

Для включения интеграции отметьте галочкой **Синхронизация со Swarmica** включена.

# Создание и синхронизация внутренних пользователей

Чтобы правильно создать агентские роли с соответствующими правами, нужно:

1.  Создать пользователя с ролью сотрудник на стороне Billmanager
2.  Выдать ему соответствующие права на обработку тикетов
3.  Пользователь будет синхронизирован со Swarmica - проверить и выдать уже нужную роль (Менеджер или Агент) в Swarmica