Наверх

Настроить плагин для уведомлений через бота в MAX

Вы можете отправлять оповещения абонентам, у которых есть действующий чат с ботом в MAX. Например, когда баланс на договоре опустится ниже заданного порога или истечёт срок обещанного платежа, LANBilling отправит уведомление — абонент получит его в чате с ботом.

  1. Убедитесь, что вам доступен модуль «Рассылка уведомлений через мессенджеры».

  2. Убедитесь, что у вас установлен и настроен модуль lbcore-max-bot.

  3. Настройте плагин max.py.

  4. В файле конфигурации скрипта-менеджера плагинов messenger_plugin.cfg задайте настройки, необходимые для взаимодействия с плагином max.py.

Настроить плагин max.py

Чтобы приступить к работе с плагином, создайте файл конфигурации max.cfg. Для этого скопируйте файл max.cfg.sample и назовите копию max.cfg:

cp /usr/local/billing/plugins/messengers/max.cfg.sample /usr/local/billing/plugins/messengers/max.cfg

  1. Откройте файл max.cfg:

    nano /usr/local/billing/plugins/messengers/max.cfg

    ``

  2. Задайте параметры в файле конфигурации. Пример:

    [Core]
Name = MAX
Module = max

[Settings]
# URL-адрес для отправки сообщения
URL = https://platform-api.max.ru/messages
# Токен бота оповещений
token =
# Режим разбора сущностей в тексте сообщений
format = html

    ``

    • Секция [Core] — основные настройки плагина.

      • Name — название плагина. По умолчанию — MAX.
      • Module — имя файла с плагином. Должно соответстовать названию настраиваемого плагина, но без расширения .py. По умолчанию — max.

    • Секция [Settings] — настройки взаимодействия с API MAX.

      • URL — шаблон для подстановки токена бота оповещений. Оставьте значение по умолчанию — https://platform-api.max.ru/messages.
      • token — скопируйте в эту строку токен, полученный при регистрации бота в поддержке MAX.
      • parse_mode — режим разбора сущностей в тексте сообщений. По умолчанию — HTML.

Задать настройки в в файле messenger_plugin.cfg

  1. Откройте файл messenger_plugin.cfg:

    nano /usr/local/billing/pymodules/messenger_plugin_management/messenger_plugin.cfg

    ``

  2. Укажите в messenger_plugin.cfg название плагина (то, которое ранее задали в файле max.cfg в параметре Name):

    Plugin = MAX

    ``

    Сохраните изменения.

  3. Перезапустите LBcore:

    systemctl restart lbcore

    ``

Плагин готов к работе.

Когда LANBilling отправит уведомление, система проверит очередь рассылки в мессенджеры и наличие у абонентов идентификатора max_uid — он присваивается тем абонентам, у которых есть действующий чат с ботом в MAX. Такие абоненты будут получать оповещения в чате с ботом.