Документация для версии Axxon Next 4.5.0 - 4.5.10. Документация на другие версии также доступна.

Предыдущая страница Push-уведомление  Запуск внешней программы на Клиентах Следующая страница

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

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

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

  1. Выбрать действие "Общие: Выполнить web-запрос".
  2. Выбрать способ аутентификации: Basic или Digest (1). По умолчанию выбран Basic способ аутентификации.
  3. Выбрать тип запроса (2). Поддерживается 4 типа: POST, GET, PUT, DELETE. По умолчанию выбран тип запроса POST.
  4. Выбрать протокол сервера: HTTP или HTTPS (3). Для корректной отправки оповещений необходимо выбрать протокол HTTPS. 
  5. Ввести IP-адрес сервера (4). Адрес сервера Telegram − api.telegram.org.
  6. Ввести порт сервера (5). Порт сервера Telegram − 443.

  7. Ввести путь запроса (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