Page History

Общие сведения

ПК Интеллект Х позволяет отправлять текстовые оповещения в чат Telegram при поступлении любого события от объектов, зарегистрированных в дереве объектов ПК Интеллект Х. После настройки отправка оповещения инициируется макрокомандой.

Перед началом настройки отправки оповещений из ПК Интеллект Х в Telegram необходимо создать бота и групповой чат с этим ботом в Telegram. Дистрибутив и инструкции по работе с мессенджером Telegram см. на официальном сайте разработчика telegram.org.

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

Для настройки оповещения через Telegram бот нужно:

1. Перейти на вкладку Программирование.
2. Нажать на кнопку Создать... в списке Правила по событиям или Циклические правила (см. Конфигурирование макрокоманд).
3. Выбрать условие запуска, которое вызовет срабатывание макрокоманды (см. Настройка условий запуска).
4. Нажать на кнопку Image Modified под условиями запуска.
5. Из выпадающего списка выбрать действие Общие: Выполнить web-запрос.
   Image Modified
   
6. В параметре Способ аутентификации выбрать способ аутентификации:
   1. Basic (по умолчанию);
   2. Digest.
      
7. В параметре Команда выбрать тип запроса:
   1. POST (по умолчанию);
   2. GET;
   3. PUT;
   4. DELETE.
8. В параметре HTTP/HTTPS выбрать протокол сервера:
   1. HTTP;
   2. HTTPS.
      

      Note
      title Внимание!
      Для корректной отправки оповещений необходимо выбрать протокол HTTPS.

9. В параметре IP-адрес ввести адрес Сервера Telegram − api.telegram.org.
10. В параметре Порт ввести порт Сервера Telegram − 443.

11. В параметре Путь ввести путь запроса. Путь запроса должен выглядеть следующим образом: /bot<BOTToken>/sendMessage?chat_id=<СhatID>&&text=<Text>, где:
    <BOTToken> − идентификационный номер бота в Telegram;
    

    Info
    title Примечание
    Идентификационный номер предоставляется при создании бота.

    <СhatID> − идентификатор чата;
    

    Info
    title Примечание
    Чтобы узнать идентификатор чата, можно добавить в чат бота @RawDataBot. После добавления бот отправит в чат сообщение, содержащее результат выполнения функции getUpdates. Среди полученной информации необходимо найти ChatId. Затем бота @RawDataBot можно удалить из чата.

    <Text> − текст оповещения. В текст оповещения допускается вводить набор символов US-ASCII (латинские буквы и цифры). Для того чтобы текст оповещения отображался корректно с другими символами (например, буквы кириллицы) и знаками пунктуации, их необходимо перекодировать. Перекодирующая кодировка описана в стандарте RFC 3986 и называется URL-encoding, URLencoded или percent‐encoding. Например, знак пробела кодируется как %20.
    

12. Нажать на кнопку Применить Image Modified.

Настройка действия Общие: Выполнить web-запрос завершена.

При использовании действия Общие: Выполнить web-запрос могут быть заполнены все поля для отправки web-запроса на заданный сервер (см.  Выполнение Выполнить web-запросазапрос).Параметры Имя пользователя, Пароль и Запрос не являются обязательными для отправки оповещения через Telegram бот.