SupportHubSupportHub/ docs
Назад
BillManager: карточка клиента и права
Для админов / BillManager

Карточка клиента, поля и права

Что оператор видит справа в тикете из BILLmanager, как настроить поля карточки и кому что разрешено.

Что видит оператор

  • Карточки «Информация об услуге», «Информация о клиенте» и «Информация о запросе». У канала-модуля их поля настраиваются (см. ниже). При подключении по API те же карточки заполняются из сводной информации BILLmanager по обращению, и их состав не меняется; если обращение не привязано к клиенту, карточек нет.
  • Профиль клиента и баланс.
  • «Услуги» — услуги клиента, кроме истёкших (приостановленные тоже), с IP (все адреса, дополнительные под «+N»), хостом, ОС, датацентром, сроком и автопродлением. Сразу видны три, остальные открываются по «Все».
  • У VPS и выделенных серверов — одна кнопка питания: «Остановить» у активной услуги, «Запустить» у приостановленной (по правам). Перезагрузки нет. У канала-модуля у услуги есть ещё «Войти в ВМ6»; при подключении по API вместо неё блок «🖥 ВМ в VMmanager» с кнопкой «Войти в VMmanager 6 за клиента». У канала-модуля эти кнопки зависят ещё и от галочек шлюза (см. ниже).
  • «Последние платежи» — до пяти последних.
  • Ссылка «Открыть в BM» — обращение в панели BILLmanager.

Пароль услуги скрыт точками и открывается глазком. В режиме стримера он остаётся размытым, даже если его открыть.

Если обращение не привязано к клиенту BILLmanager, вместо карточки будет «Обращение не привязано к клиенту BillManager…». При подключении по API карточка ещё предупреждает, когда в тикете пишет не тот человек, к чьему аккаунту BILLmanager привязан клиент.

Поля карточек (модуль)

У канала-модуля в карточке канала есть вкладка «Поля сайдбара»: какие значения BILLmanager показывать в карточках «Услуга», «Клиент» и «Обращение», в каком порядке и под какими подписями. SupportHub передаёт модулю только названия полей, а значения собираются на сервере BILLmanager; из этих трёх карточек наружу уходят только поля, которые вы показываете. Профиль клиента, список услуг и платежи модуль отдаёт независимо от этой настройки. По умолчанию в карточке «Услуга» есть и пароль — уберите его, если он операторам не нужен.

  • «Выберите значение…» → «Добавить поле»; кнопки-стрелки «Выше» / «Ниже» меняют порядок, «Убрать» убирает. Изменения вступают в силу после «Сохранить».
  • Подпись в сайдбаре можно заменить своей (до 80 символов), в карточке — до 40 полей.
  • Карточка без полей скрыта в тикете. «По умолчанию» возвращает стандартный набор.
  • Метка у поля показывает источник: встроенное, своё, Omnidesk.

Если модуль устарел, отклонил запрос или не ответил, вкладка покажет это вверху, и редактирование будет недоступно, пока модуль не ответит.

Свои поля SQL-запросом

Свои значения задаются JSON-файлом на сервере BILLmanager: /usr/local/mgr5/etc/supporthub/custom_fields.json (создайте его сами; модуль читает его от root). В раскладке такие поля получают ключи custom.<имя>. Формат совпадает с модулем Omnidesk: если на сервере уже есть его файл /usr/local/mgr5/etc/omnidesk/custom_fields_values.json, его поля подхватываются сами (с ключами omnidesk.<имя>). Пример лежит в /usr/local/mgr5/share/supporthub/custom_fields.example.json.

custom_fields.jsonjson
{
  "vip": {
    "entity": "user",
    "name": "VIP",
    "type": "bool",
    "sql": "SELECT IF(COUNT(*) > 0, 'true', 'false') FROM ... WHERE u.id = __id__"
  }
}
entity
Тип: user | case | itemПо умолчанию: —
Что подставляется в __id__: user — пользователь-владелец аккаунта клиента, case — номер обращения, item — услуга обращения.
name
Тип: строкаПо умолчанию: —
Подпись поля по умолчанию.
sql
Тип: SELECTПо умолчанию: —
Один SELECT. Значение — первая колонка первой строки; пустое значение скрывает поле. Запрос выполняется только на чтение, не дольше 2 секунд; на все свои поля тикета — не больше 5 секунд.
type
Тип: строкаПо умолчанию: text
text, multiline, date, datetime, bool (true/false → «Да»/«Нет»), list (номер варианта с 1 из options).
sensitive
Тип: true | falseПо умолчанию: true
Скрывать значение в режиме стримера SupportHub.

Права операторов

Вкладка «Права» карточки канала; менять её могут владелец и администраторы. Для каждого права: «Все операторы», «Все, кроме выбранных» или «Только выбранные». Владелец проекта (и администратор платформы) может всё, независимо от настроек; администраторы проекта подчиняются правам наравне с операторами. Без права на действие оператор не видит соответствующей кнопки. Без «Просмотра карточки клиента» вместо всей карточки BILLmanager в тикете будет ошибка «BillManager недоступен», а SupportHub покажет окно «Доступ ограничен».

Просмотр карточки клиента
Тип: чтениеПо умолчанию: все
Вся карточка BILLmanager в тикете, включая пароль услуги и ссылку «Открыть в BM».
Открыть в BillManager
Тип: чтениеПо умолчанию: все
Ссылка на обращение в панели BILLmanager.
Просмотр ВМ клиента
Тип: чтениеПо умолчанию: все
Нужен при подключении по API для блока «ВМ в VMmanager» и кнопок старта и стопа. У канала-модуля ни на что не влияет.
Вход в VM от лица клиента
Тип: действиеПо умолчанию: никто
«Войти в ВМ6» у услуги (модуль) или вход в VMmanager за клиента (API). Выдайте явно.
Управление VM (старт / стоп / перезагрузка)
Тип: действиеПо умолчанию: никто
Кнопки «Запустить» / «Остановить» у VPS и выделенных серверов и «Перезагрузить» у VPS, а также те же шаги в макросах. Выдайте явно.
Деньги: бесплатное продление и бонусы
Тип: действиеПо умолчанию: никто
Запуск макросов, которые бесплатно продлевают услугу или начисляют бонус на баланс. Выдать может только владелец проекта.

У канала-модуля вход в ВМ6, запуск и остановка из тикета записываются в «Журнал аудита» админ-панели платформы: кто и с какой услугой. У запуска и остановки там же виден результат, в том числе когда модуль отказал или не ответил.

Любое действие с услугой — вход, запуск, остановка, перезагрузка — выполняется только для услуги клиента этого тикета: SupportHub сверяет её с услугами клиента в BILLmanager перед действием, модуль проверяет ещё раз на своей стороне. Чужая услуга отклоняется, попытка попадает в журнал аудита. Остановка и перезагрузка спрашивают подтверждение, а после действия в тикете появляется внутренняя заметка: кто и что сделал. Перезагрузка есть только у VPS.

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