Sending Telegram notifications

Describes the how to configure sending notifications via Telegram

To send a notification via Telegram you need to supply a channel id, a bot token and a an api key.

To obtain the bot token (aka bot id), message the @BotFather bot. After creating the bot, send a message to the bot, so it can reply. For more details on Telegram bots, see the Telegram bot documentation.

After obtaining the bot token you can obtain the channel id with a cURL script:

BOT_TOKEN="YOURBOTTOKEN" curl -s "https://api.telegram.org/bot$BOT_TOKEN/getUpdates" \
  | grep -o '"id":[0-9]*' | head -1 | cut -d':' -f2

To obtain the API key, follow the Telegram guide to creating an application.

With all required values obtained, you can set up the Telegram notifications in the general settings:

Set up Telegram notifications with the default options editor

Set up Telegram option with a text field

You can toggle between the two views using the "Edit as list" and "Edit as text" links.

Besides the mandatory options, it is also possible to configure:

• The notification message and format

• Conditions on when to send emails

• Conditions on what log elements to include

For details on how to customize the notification message, see the section on customizing message content.