Драйвер Telegram

Обзор

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

Установка

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

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

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

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

1. Установите приложение и зарегистрируйтесь в Telegram.
2. Добавьте в список контактов бота BotFather.

   

3. В режиме диалога с BotFather выполните команду /newbot и следуйте инструкциям от BotFather.
4. Щёлкните по значку меню и создайте новую группу для получения рассылки.

   

5. Добавьте созданного Вами бота в новую группу.
6. Добавьте контакты в новую группу. Эти контакты будут получать рассылку.

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

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

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

   

4. Сохранить изменения конфигурации драйвера.
5. Передать проект на сервер с помощью кнопки .
6. Перейти на страницу Регистрация и зарегистрировать драйвер, используя гиперссылки, размещённые на форме.

   

7. Снова сохранить изменения и передать проект на сервер.

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

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

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

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

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

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

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