Модуль на сервере BILLmanager (v2)

Установка и настройка

1. 1
   Создайте канал в SupportHub

   НастройкиКаналыДобавить каналBillManager 6. В поле «Способ интеграции» выберите «Модуль на сервере BM (без передачи доступов)», укажите «URL сервера BillManager» (достаточно адреса панели, например my.example.com) и создайте канал.

   Всё, что понадобится дальше, мастер показывает сразу после выбора способа: команду установки, «URL SupportHub» и «Секрет подписи». После создания канала они есть в его карточке на вкладке «Общие».

2. 2
   Установите модуль на сервер BILLmanager

   Выполните команду из мастера на сервере BILLmanager под root. Она скачает модуль, распакует его и запустит установщик:

   bash

   curl -fsSL https://api.support.forestsnet.com/api/integrations/billmgr/module.tar.gz -o supporthub-billmgr-module.tar.gz \
     && tar xzf supporthub-billmgr-module.tar.gz && sudo ./install.sh

   Копировать

   Установщик ставит нужные BILLmanager библиотеки Python (billmanager-plugin-python-libs, через dnf, если их ещё нет), кладёт файлы модуля, создаёт служебные таблицы, расписание синхронизации (раз в минуту) и просит панель перечитать настройки.

3. 3
   Заведите системного оператора

   Ответы из SupportHub пишутся в обращения не от живого сотрудника, а от служебной учётки. В BILLmanager добавьте сотрудника с логином supporthub (или своим — тогда укажите его в шлюзе) с правами сотрудника. Пароль не важен: модуль работает через локальный сокет панели, а не по паролю. Пока такого сотрудника нет, карточка канала в SupportHub показывает красное предупреждение «Не найден оператор …» с подсказкой, что сделать.

4. 4
   Создайте API-ключ в SupportHub

   НастройкиAPI ключиСоздать ключ. Ключ показывается один раз — скопируйте его сразу. Это «Токен воркспейса» для шлюза.

5. 5
   Добавьте шлюз SupportHub в BILLmanager

   В панели BILLmanager добавьте шлюз SupportHub в разделе шлюзов сообщений (модуль сам подсказывает путь «Integration → Message gateways → SupportHub»), включите его и заполните поля. Выключенный шлюз модуль не видит: синхронизация стоит, а SupportHub получает отказ.

1. 6
   Проверьте

   На сервере BILLmanager:

   bash

   /usr/local/mgr5/sbin/supporthub_sync --command check

   Копировать

   Команда покажет версию модуля, настройки шлюза, найден ли системный оператор, какие действия разрешены, позицию синхронизации, отделы BILLmanager и ответ SupportHub на /health. Если шлюз настроен и системный оператор найден, последняя строка — OK — the module answers as 'supporthub'. Токен и секрет команда проверяет только на наличие (set / MISSING), а недоступный /health на итог не влияет — поэтому OK ещё не значит, что события доходят.

   Окончательная проверка — сообщение от клиента в BILLmanager: оно должно появиться во «Входящих». Сообщение сотрудника для проверки не подходит — обращения, начатые сотрудником, SupportHub не заводит, пока не ответит клиент. Старые обращения при установке не загружаются: синхронизация начинается с текущего последнего сообщения, а старое обращение появится, когда клиент напишет в него снова (вместе с последними сообщениями переписки). Ещё можно открыть в SupportHub карточку канала: на вкладке «Общие» блок «Модуль на BILLmanager» показывает версию модуля, оператора для ответов и галочки шлюза. Если что-то не так, под блоком будет предупреждение с подсказкой; исправив, нажмите «Проверить».

Отделы

Обновление

Как понять, что модуль работает

Если что-то не работает