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

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

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

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

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

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

  1. Перейти на вкладку Программирование.
  2. Нажать на кнопку Создать... в списке Правила по событиям или Циклические правила (см. Конфигурирование макрокоманд).
  3. Выбрать условие запуска, которое вызовет срабатывание макрокоманды (см. Настройка условий запуска).
  4. Нажать на кнопку под условиями запуска.
  5. Из выпадающего списка выбрать действие Общие: Выполнить web-запрос.

  6. В параметре Способ аутентификации выбрать способ аутентификации:
    1. Basic (по умолчанию);
    2. Digest.
  7. В параметре Команда выбрать тип запроса:
    1. POST (по умолчанию);
    2. GET;
    3. PUT;
    4. DELETE.
  8. В параметре HTTP/HTTPS выбрать протокол сервера:
    1. HTTP;
    2. HTTPS.

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

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

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

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

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

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

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

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

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

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