Axxon Next allows you to send text notifications to Telegram chat when any event occurs from the objects registered in the Axxon Next objects tree. Once configured, the notification sending is initiated by the Axxon Next macro.

Before configuring notifications sending from Axxon Next to Telegram, create a bot and a group chat with this bot in Telegram. For the distribution package and manuals on working with Telegram, see the developer's official website telegram.org.

To configure notification sending in Telegram bot, do the following:

  1. Select the "General: Execute web-query" action.

  2. Select the authentication method: Basic or Digest (1). By default, the Basic authentication method is selected.


  3. Select the query type (2). Four types are supported: POST, GET, PUT, DELETE. By default, the POST query type is selected.
  4. Select the server protocol: HTTP or HTTPS (3). For the correct notifications sending, select the HTTPS protocol.
  5. Enter the IP address of the server (4). The address of the Telegram server is api.telegram.org.
  6. Enter the port of the server (5). The port of the Telegram server is 443.
  7. Enter the path of the query (6). The path of the query should look like this: /bot<BOTToken>/sendMessage?chat_id=<СhatID>&&text=<Text>, where <BOTToken> is an ID of the bot in Telegram;

    The ID is provided when you create the bot

    <СhatID> is an ID of the chat;

    To find out the ID of the chat, add the @RawDataBot bot to the chat. After adding, the bot will send a message to the chat that will contain the result of the execution of the getUpdates function. Find ChatId in the message. Then remove the @RawDataBot bot from the chat.

    <Text> is a notification text. You can enter the set of US-ASCII characters (Latin characters and digits) in the notification text. For the notification text to display correctly with other characters and punctuation marks, you need to encode them. The encoding is described in the RFC 3986 standard and called URL-encoding, URLencoded, or percent-encoding. For example, a space character is encoded as %20.

When using the "General: Execute web-query" action, all fields for sending a web-query to the specified server can be filled in (see Executing a Web-query). However, the Username, Password and Query fields are not required for sending a notification via Telegram bot.