Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

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

Info
titleПримечание.

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

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

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

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

  10. Ввести В параметре IP-адрес сервера (4). Адрес сервера Telegram  адрес ввести адрес Сервера Telegram − api.telegram.org.Ввести порт сервера (5). Порт сервера Telegram 
  11. В параметре Порт ввести порт Сервера Telegram − 443.
  12. Ввести В параметре Путь ввести путь запроса (6). Путь запроса должен выглядеть следующим образом: /bot<BOTToken>/sendMessage?chat_id=<СhatID>&&text=<Text>, где:
    <BOTToken> <BOTToken> − идентификационный номер бота в Telegram;

    Info
    titleПримечание.

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

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

    Info
    titleПримечание.

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

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

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

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

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