Настройка бота Telegram в «ЛЭРС УЧЁТ»

Настройка бота Telegram для программы ЛЭРС УЧЕТ Функции системы
⎋ В данной статье рассмотрена подробная инструкция по настройке бота Telegram. Отправка уведомления через Telegram. Управление сервером и работами

Начиная с версии 3.36 сервер система «ЛЭРС УЧЁТ» поддерживает отправку уведомлений с помощью бота для мессенджера Telegram. В данной статье рассмотрена подробная инструкция по настройке бота Telegram.

Чтобы сервер запустил поддержку Telegram, нужно создать нового бота и ввести его ключ в системных параметрах. Обратите внимание, что серверу потребуется доступ к интернету, чтобы принимать и отправлять сообщения.

Бот реализует три основные функции:

  • отправка уведомлений
  • управление сервером
  • управление работами

Отправка уведомлений

Чтобы сервер отправлял уведомления из центра через Telegram, в настройках уведомлений для пользователя нужно выбрать его в качестве способа получения уведомлений.

После этого все новые уведомления выбранного типа будут отправлены вам в мессенджер.

Настройка бота Telegram в «ЛЭРС УЧЁТ» для отправки уведомлений
Изображение 1. Настройка бота Telegram в «ЛЭРС УЧЁТ» для отправки уведомлений

Управление сервером

Бот Telegram для ЛЭРС УЧЕТ позволяет выполнить несколько базовых команд. Например, формирование отчёта о состоянии системы, получение списка точек, опрос текущих, и т.д. Полный список приведён в разделе «Настройка».

Настройка бота Telegram

Настройка бота Telegram ЛЭРС УЧЕТ состоит из нескольких этапов:

  1. Запуск Telegram

    Запустите Telegram и в поиске пользователей наберите botfather

  2. Создание нового бота

    Введите команду, создающую нового бота /newbot

  3. Ключ API Telegram

    Сохраните полученный от botfather ключ API

  4. Создаем имя бота

    Введите имя вашего бота (оно должно оканчиваться на bot). Например, my_company_lers_bot

  5. Настройка списка команд

    Для упрощения работы с ботом настройте список команд, которые будут предлагаться для быстрого ввода. Для этого введите /setcommands, выберите вашего бота и отправьте следующее сообщение (с переносами строк).
    nodes — Запрос списка объектов учёта.
    mpts — Запрос списка точек учёта.
    getcurrents — Запрос текущих данных по точке учёта.
    sysstate — Отчёт о состоянии системы.
    portstatus — Состояние портов опроса.
    getmyjobs — Запрос списка назначенных работ.
    job — Выбор работы для комментирования.
    close — Закрыть выбранную работу.
    sublastdata — Подписка на изменение последних данных точки учёта.
    unsublastdata — Отписка от изменения последних данных точки учёта.
    lastdatalist — Список точек учёта на которые есть подписка изменения последних данных.

  6. Настройка в программе ЛЭРС УЧЕТ

    Вставьте полученный API ключ в системных параметрах в разделе Уведомления — Отправка сообщенийНастройка бота Telegram в объекте учета ЛЭРС УЧЕТ

  7. Поиск созданного бота

    В Telegram найдите бота, по имени, которое вы указали в п.3

  8. Авторизация и регистрация бота

    После ввода команды /start по запросу введите ваши логин и пароль от сервера ЛЭРС УЧЕТ. Бот свяжет их с пользователем telegram и в дальнейшем будет использовать для выполнения запросов к серверу ЛЭРС УЧЕТ

  9. Смена пользователя

    Для смены пользователя необходимо сначала выполнить команду /stop, после чего повторно ввести команду /start, как в пункте 8.

Для большей безопасности удалите сообщения, содержащие пароль входа в ЛЭРС УЧЕТ после регистрации.

Управление работами (доступно с версии 3.41)

Команда /getmyjobs отображает общий список работ с кратким описанием. Команда /job отображает кнопки, с помощью которых можно выбрать работу. После нажатия на кнопку, в чат можно отправить сообщения, которые будут добавлены в виде комментариев к работе. Кроме того, отправленные в чат файлы будут приложены к работе как документы.

Фотографии нужно отправлять как документы (файлы). Иначе бот проигнорирует загруженный файл.

Команда /close закрывает текущую выполненную работу (переводит в состояние «Выполнена»).

Подписка на изменение последних данных точки учёта (доступно с версии 3.42)

Команды /sublastdata, /unsublastdata отображают кнопки, с помощью которых можно выбрать точку учёта для который осуществить подписку/отписку на уведомление об изменении последних данных.

Также после команды можно передать часть наименования объекта или точки учёта, чтобы отфильтровать выдаваемый список.

С помощью команды /unsublastdata all можно отписаться от всех уведомлений об изменении последних данных.

СПРАВОЧНИК ИНЖЕНЕРНОГО ОБОРУДОВАНИЯ

Руководства по монтажу и эксплуатации, бесплатные программы считывания данных, актуальные цены и статьи о приборах учета, автоматике, устройствах передачи данных и другом инженерном оборудовании для энергетики

КИП КАТАЛОГ - Приборы учета тепла и воды, датчики давления
Поделиться публикацией
Добавить комментарий