Documentation

telegram.message() function

Flux 0.70.0+

The telegram.message() function is a user-contributed function maintained by the package author and can be updated or removed at any time.

The telegram.message() function sends a single message to a Telegram channel using the sendMessage method of the Telegram Bot API.

import "contrib/sranka/telegram"

telegram.message(
  url: "https://api.telegram.org/bot",
  token: "S3crEtTel3gRamT0k3n",
  channel: "-12345",
  text: "Example message text",
  parseMode: "MarkdownV2",
  disableWebPagePreview: false,
  silent: true
)

For information about retrieving your Telegram bot token and channel ID, see Set up a Telegram bot.

Parameters

url

URL of the Telegram bot endpoint. Default is https://api.telegram.org/bot.

token

(Required) Telegram bot token.

channel

(Required) Telegram channel ID.

text

Message text.

parseMode

Parse mode of the message text. Default is "MarkdownV2".

disableWebPagePreview

Disable preview of web links in the sent message. Default is false.

silent

Send message silently. Default is true.

Examples

Send the last reported status to Telegram
import "influxdata/influxdb/secrets"
import "contrib/sranka/telegram"

token = secrets.get(key: "TELEGRAM_TOKEN")

lastReported =
  from(bucket: "example-bucket")
    |> range(start: -1m)
    |> filter(fn: (r) => r._measurement == "statuses")
    |> last()
    |> findRecord(fn: (key) => true, idx: 0)

    telegram.message(
      token: token,
      channel: "-12345"
      text: "Disk usage is **${lastReported.status}**.",
    )

Package author and maintainer

Github: @sranka
InfluxDB Slack: @sranka


Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.