Подключение по API (v1)
SupportHub сам опрашивает API BILLmanager раз в 30 секунд с учётной записью сотрудника. На сервер ничего ставить не нужно, но доступы к панели хранятся у нас. Если можете поставить модуль — лучше модуль (v2).
Создание канала
НастройкиКаналыДобавить каналBillManager 6, «Способ интеграции» — «Опрос API (передать доступы)».
| Поле | Тип | По умолчанию | Описание |
|---|---|---|---|
| URL панели | адрес | — | Адрес BILLmanager без /billmgr на конце — его добавим сами. |
| Логин (staff-аккаунт) | строка | — | Сотрудник BILLmanager, от имени которого SupportHub читает обращения и отвечает. Удобно завести отдельную учётку. SupportHub видит только обращения, доступные этому сотруднику, поэтому включите его в нужные отделы BILLmanager. Каждое новое обращение SupportHub сразу берёт в работу в BILLmanager этой учёткой. |
| Пароль | строка | — | Хранится зашифрованным, в интерфейсе не показывается. |
| Проверять SSL-сертификат | переключатель | вкл | Выключайте только для самоподписанного сертификата. |
| Подтянуть историю за | период | 30 дней | За какой срок забрать открытые обращения при первом опросе: не подтягивать, 1 день, 7 дней, 30 дней, 1 год. Закрытые и архивные обращения не загружаются; менять значение после первого опроса бесполезно. |
| VMmanager 6 (опционально) | блок | — | URL VMmanager, email и пароль сервисной учётки. Нужен для блока «ВМ в VMmanager» и кнопок старта и стопа (см. ниже). Если проверка VMmanager в мастере не прошла, канал создастся без него — включите интеграцию позже на вкладке «VMmanager». |
«Проверить подключение» обязательна перед созданием: SupportHub покажет версию BILLmanager и число отделов. Отделы и права операторов настраиваются уже в карточке канала.
IP для вайтлиста и прокси
На вкладке «Общие» карточки канала есть блок «IP сервера SupportHub для вайтлиста в BillManager» — добавьте этот адрес в список разрешённых, если панель ограничивает доступ по IP. Там же выбирается «Прокси для исходящих запросов»; при выбранном прокси блок показывает IP его выхода. Через прокси идут опрос, ответы, карточка клиента, вход в VM, старт и стоп, список отделов и передача закрытия тикета в BILLmanager. В мастере подключения прокси выбирается рядом с данными панели, и «Проверить подключение» идёт тем же маршрутом (принудительный прокси платформы действует и там). Подробнее — в разделе «Прокси».
VMmanager 6
Вкладка «VMmanager» есть только у канала по API. С включённой интеграцией:
- в тикете появляется блок «ВМ в VMmanager» с кнопкой «Войти в VMmanager 6 за клиента». Нужны права «Вход в VM от лица клиента», «Просмотр ВМ клиента» и «Просмотр карточки клиента», а у клиента — действующая VPS; вход идёт в первую такую услугу;
- у VPS и выделенных серверов в списке услуг появляется кнопка «Остановить» (у активной услуги) или «Запустить» (у приостановленной), у активной VPS — ещё «Перезагрузить». Нужны права «Управление VM (старт / стоп / перезагрузка)» и «Просмотр ВМ клиента». «Остановить» приостанавливает услугу в BILLmanager (
vds.suspend.confirm), «Перезагрузить» вызываетvds.reboot.confirm; оба спрашивают подтверждение. Действие выполняется только с услугой клиента этого тикета — SupportHub сверяет её со списками услуг его аккаунта в BILLmanager.
Вход за клиента, старт и стоп выполняет сам BILLmanager учёткой канала, а API VMmanager SupportHub вызывает только при проверке в мастере. Поэтому IP сервера SupportHub в разрешённых адресах VMmanager нужен лишь для того, чтобы проверка прошла. Каждое такое действие оставляет в тикете внутреннюю заметку и запись в журнале аудита. По умолчанию вход в VM и старт/стоп доступны только владельцу проекта — права меняются на вкладке «Права», подробнее — в разделе «Карточка клиента, поля и права». Пароль сервисной учётки при сохранении вкладки с пустым полем не меняется.
Отделы
Вкладка «Отделы» сопоставляет отделы BILLmanager с отделами SupportHub: обращение из отдела BILLmanager попадает в выбранный отдел у нас. Строка «fallback» ловит все отделы, которых нет в списке. Список отделов BILLmanager подгружается сам при открытии вкладки, кнопка «Обновить список BM» перечитывает его. Отдел применяется заново при каждом обновлении обращения из BILLmanager, поэтому ручной перенос тикета в другой отдел может сброситься.