Драйвер 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. Импортировать созданную линию связи и КП в Коммуникатор. Разрешить отправку команд ТУ для линии связи.
  4. В Коммуникаторе открыть свойства КП, ввести токен бота, полученный при создании бота, и сгенерировать пароль бота, который используется для управления подписками.
    Конфигурация КП Telegram
  5. Перейти на страницу Регистрация и зарегистрировать драйвер, используя гиперссылки, размещённые на форме.
    Регистрация КП Telegram
  6. Сохранить изменения конфигурации драйвера.
  7. Перезапустить службу Коммуникатора с помощью кнопки .

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

Если настройка выполнена правильно, то Ваш бот будет отвечать на команды, например, команду /help

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

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

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

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

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

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