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

Примечание

Для работы требуется активная подписка на обновления и техническую поддержку.

ЛЭРС УЧЁТ поддерживает отправку уведомлений с помощью бота для мессенджера Telegram. Чтобы сервер запустил поддержку Telegram, нужно создать нового бота и ввести его ключ в системных параметрах. Обратите внимание, что серверу потребуется доступ к интернету, чтобы принимать и отправлять сообщения.

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

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

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

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

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

Бот позволяет выполнить несколько базовых команд. Например, формирование отчёта о состоянии системы, получение списка точек, опрос текущих, и т.д. Полный список приведён в разделе "Настройка".

Настройка

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

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

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

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

5. Для упрощения работы с ботом настройте список команд, которые будут предлагаться для быстрого ввода. Для этого введите /setcommands, выберите вашего бота и отправьте следующее сообщение (с переносами строк).

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

6. Вставьте полученный API ключ в системных параметрах в разделе Уведомления → Отправка сообщений
   

Авторизация

Для авторизации в telegram-боте выполните следующие шаги:

1. Войдите в систему в рабочем месте оператора или веб-интерфейсе.
2. В рабочем месте оператора нажмите на имени пользователя и выберите пункт меню Авторизация в Telegram боте. В веб-интерфейсе откройте профиль пользователя на закладке Уведомления.
3. Отсканируйте полученный QR-код смартфоном и перейдите по полученной ссылке.
   
4. Для смены пользователя выполните команду /stop, а затем повторите шаги начиная с п.1.

Получение списка объектов и точке

Команды /mpts и /nodes выводят в ответном сообщении список все точек (объектов), доступных пользователю. После этой команды требуется указать часть названия, адреса объекта, или названия точки учёта. Выдается список точек (объектов), у которых совпала часть этих параметров.

Например, если вы введёте команду /mpts ГВС, будет выдан список всех точек, у которых в названии есть строка ГВС. Кроме того, в выдачу попадут точки, которые находятся в объекте, в адресе или названии которого есть строка ГВС.

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

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

Внимание

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

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

Подписка на изменение последних данных точки учёта

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

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

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