SupportHubSupportHub/ docsНазад
Интеграция BillManager 6
Для админов

Интеграция с BillManager 6

BillManager 6 (ISPsystem) -- это биллинговая панель для хостинг-провайдеров. SupportHub подключается к BillManager как полноценный канал: тикеты из BM появляются в общем Inbox оператора, ответы оператора зеркалируются обратно в BM, а в сайдбаре тикета показывается карточка клиента и информация об услугах.

Как это работает

  • Бэкенд опрашивает BillManager каждые 30 секунд, забирает новые тикеты и сообщения, создаёт зеркальные тикеты в SupportHub.
  • Ответ оператора в SupportHub автоматически отправляется обратно в BM как сообщение в исходном BM-тикете -- клиент видит ответ в привычной панели.
  • В сайдбаре тикета отображаются данные клиента из BM (имя, email, баланс) и список услуг -- VPS, домены, лицензии, к которым может быть привязан тикет.
  • Закрытие тикета в SupportHub зеркалится в BM: BM-тикет помечается решённым.

Мастер подключения (4 шага)

Перейдите в «Каналы → Добавить → BillManager». Мастер ведёт через четыре шага:

  1. URL панели -- адрес вашего BillManager (например, https://bill.example.com). Без слеша на конце.
  2. Логин -- сервисная учётная запись BM с полными правами: чтение/отправка тикетов и сообщений, управление пользователями и услугами, доступ к биллингу. Проще всего завести аккаунт с full-access — SupportHub хранит креды зашифрованно (Fernet/AES-GCM), пароль маскируется в API-ответах и логах, поэтому даже широкий набор прав остаётся изолированным.
  3. Пароль -- пароль той же учётной записи. Хранится зашифрованно (Fernet), маскируется в API-ответах и в админ-UI.
  4. VMmanager (опционально) -- если у вас есть VMmanager 6, укажите его URL, логин и пароль. Это включит управление VPS прямо из карточки тикета.
Заведите в BM отдельную сервисную учётку для SupportHub. Это упрощает аудит (видно, кто отвечал клиенту -- человек или зеркало из SH) и позволяет отозвать доступ одной кнопкой.

Матрица прав

Для каждой операции с BM/VMmanager заведена отдельная BM-привилегия. В настройках канала владелец workspace отмечает галочками, какие операции разрешены операторам через SupportHub:

  • Выдать SSH-ключ / пароль VPS клиенту
  • Управлять VPS (старт, стоп, перезагрузка)
  • SSO-вход в VMmanager под клиентом (gotoserver)
  • Просматривать баланс и счета
  • Закрывать тикет в BM
Разрешения хранятся на уровне канала -- одни и те же операторы получают одинаковый набор прав в рамках workspace. Если нужно ограничить часть команды, делите тикеты по отделам и держите чувствительные BM-привилегии у отдельного отдела.

Маппинг отделов

BillManager делит входящие обращения по отделам («Биллинг», «Техподдержка», «Продажи» и т.д.). В настройках канала каждый BM-отдел сопоставляется отделу SupportHub. Тикет из BM сразу попадает в нужную очередь и подсвечивается у операторов соответствующего отдела.

Не оставляйте BM-отделы без маппинга -- такие тикеты упадут в общий fallback. Если в BM появился новый отдел, в карточке канала появится строка с просьбой выбрать соответствие.

VMmanager 6 как родственный канал

При указании VMmanager-кредов на 4-м шаге мастера в карточке тикета появляются дополнительные действия по VPS клиента:

  • Старт / стоп / рестарт VPS одним кликом
  • SSO-вход в VMmanager под клиентом через gotoserver -- открывается VMmanager в новой вкладке с активной сессией клиента, без передачи пароля.
  • Информация о хосте (нагрузка, статус, версия ОС) в сайдбаре

Whitelist исходящих IP

BillManager обычно стоит за firewall, который ограничивает административный API по IP. Чтобы SupportHub смог дотянуться до BM, в файрволле панели нужно разрешить исходящий IP нашего бэкенда.

# Разрешите доступ с IP бэкенда SupportHub
# (актуальный IP смотрите в карточке канала, секция «Сетевой доступ»)
iptables -A INPUT -s <SUPPORTHUB_EGRESS_IP> -p tcp --dport 443 -j ACCEPT
Если в BM настроен IP-whitelist для админских API и наш IP не добавлен -- мастер подключения упадёт на шаге «Логин» с ошибкой 403/timeout. Сначала откройте доступ, потом повторяйте подключение.
Если ваш BM закрыт сетью полностью или нужно ходить через определённый IP -- настройте прокси для канала. В карточке BM-канала есть два независимых слота: верхнеуровневый proxy_id для API BillManager и вложенный vmmanager.proxy_id для API VMmanager.

Авто-взятие тикетов и зеркалирование статуса

  • Auto-take на первом импорте -- если тикет в BM уже был взят в работу до подключения SupportHub, при первом ингесте он сразу попадает в статус «В работе» -- очередь не засоряется уже обрабатываемыми тикетами.
  • Auto-assign по ответу из BM -- если сотрудник ответил клиенту прямо в BM (минуя SupportHub), его email сопоставляется с оператором SH и тикет автоматически назначается на него.
  • Закрытие в SH → закрытие в BM -- когда оператор закрывает тикет в SupportHub, мы вызываем BM API и помечаем исходный тикет решённым. Клиент не видит разницы между ответом из SH и ответом из BM.

Кто может редактировать настройки

Редактировать параметры BM-канала (URL, логин, пароль, VMmanager-крэды, маппинг отделов, матрицу прав) может только владелец workspace. Обычные операторы и админы отделов видят канал, но кнопка «Редактировать» для них недоступна. Это сделано намеренно: BM-крэды открывают доступ ко всем биллингу провайдера, и право их менять должно быть у одного человека.

Была ли страница полезной?