Наверх

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

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

  1. Если у вас ещё не приобретён модуль «Рассылка уведомлений через мессенджеры» — приобретите его.

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

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

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

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

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

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

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

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

    ``

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

    [Core]
Name = Telegram
Module = telegram

[Settings]
# URL-адрес для отправки сообщения ({token} - шаблон подстановки токена бота оповещений)
URL = https://api.telegram.org/bot{token}/sendMessage
# Токен бота оповещений
token =
# Режим разбора сущностей в тексте сообщений
parse_mode = HTML

    ``

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

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

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

      • URL — шаблон для подстановки токена бота оповещений. Оставьте значение по умолчанию — https://api.telegram.org/bot{token}/sendMessage.
      • token — скопируйте в эту строку токен, полученный при регистрации бота в @BotFather.
      • parse_mode — режим разбора сущностей в тексте сообщений. По умолчанию — HTML. Подробнее о допустимых стилях форматирования — в документации Telegram.

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

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

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

    ``

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

    Plugin = Telegram

    ``

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

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

    systemctl restart lbcore

    ``

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

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