Драйвер Telegram

Обзор

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

Установка

Драйвер Telegram устанавливается в соответствии с общей последовательностью установки драйверов Коммуникатора. Файл библиотеки драйвера - KpTelegram.dll.

Конфигурирование

Создание бота Telegram

Предварительно необходимо создать бота с системе Telegram. Для этого:

  1. Установите приложение и зарегистрируйтесь в Telegram.
  2. Добавьте в список контактов бота BotFather.
    Telegram BotFather
  3. В режиме диалога с BotFather выполните команду /newbot и следуйте инструкциям от BotFather.
  4. Щёлкните по значку меню и создайте новую группу для получения рассылки.
    Новая группа Telegram
  5. Добавьте созданного Вами бота в новую группу.
  6. Добавьте контакты в новую группу. Эти контакты будут получать рассылку.

Настройка драйвера

Настройка рассылки уведомлений выполняется с помощью программы Администратор как часть проекта. Последовательность настройки:

  1. Открыть таблицу Типы КП и проверить, что тип "КП 224 Telegram" существует. Если указанная запись в таблице отсутствует, то ввести её вручную.
  2. Создать отдельную линию связи и единственный КП типа Telegram на данной линии связи, используя мастеры, которые вызываются с помощью кнопок и .
  3. В настройках Коммуникатора открыть свойства КП, ввести токен бота, полученный при создании бота, и сгенерировать пароль бота, который используется для управления подписками.
    Конфигурация КП Telegram
  4. Сохранить изменения конфигурации драйвера.
  5. Передать проект на сервер с помощью кнопки .
  6. Перейти на страницу Регистрация и зарегистрировать драйвер, используя гиперссылки, размещённые на форме.
    Регистрация КП Telegram
  7. Снова сохранить изменения и передать проект на сервер.

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

Если настройка выполнена правильно, то Ваш бот будет отвечать на команды, отправленные из мессенджера, например, команду /help. Необходимо в настройках драйвера указать подписки (чаты), с которыми взаимодействует Коммуникатор.

Группа уведомлений Telegram

Чтобы получить идентификатор и наименование подписки, следует отправить команду /info с помощью мессенджера. Затем добавить полученные данные на форме конфигурации КП.

Устаревший способ: добавление или удаление подписки выполняется с помощью команд /start и /stop с указанием ранее сгенерированного пароля. Однако, по умолчанию изменение подписки заблокировано. Чтобы его разблокировать, в Коммуникаторе нужно отправить для КП стандартную команду номер 2 со значением 1. После этого можно добавлять или удалять подписки.

Отправка сообщений

Чтобы из Rapid SCADA отправить сообщение в группу Telegram, необходимо отправить бинарную команду номер 1, содержащую имя (или идентификатор) группы и текст сообщения. Например:
RapidScadaDemo; Тестовое сообщение.

Отправка сообщения Telegram

Автоматическая рассылка уведомлений при выполнении определённых условий и возникновении событий осуществляется с помощью Модуля автоматического управления.