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

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

Примечание.

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

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

  1. Настроить условия запуска макрокоманды (см. Настройка условий запуска).
  2. Выбрать действие "Общие: Выполнить web-запрос".
  3. Выбрать способ аутентификации: Basic или Digest (1). По умолчанию выбран Basic способ аутентификации.

  4. Выбрать тип запроса (2). Поддерживается 4 типа: POST, GET, PUT, DELETE. По умолчанию выбран тип запроса POST.
  5. Выбрать протокол сервера: HTTP или HTTPS (3). Для корректной отправки оповещений необходимо выбрать протокол HTTPS. 
  6. Ввести IP-адрес сервера (4). Адрес сервера Telegram  api.telegram.org.
  7. Ввести порт сервера (5). Порт сервера Telegram − 443.
  8. Ввести путь запроса (6). Путь запроса должен выглядеть следующим образом: /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.

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

  • No labels