telegram.message() function
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.
Function type: Output
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.
Data type: String
token
Required Telegram bot token.
Data type: String
channel
Required Telegram channel ID.
Data type: String
text
Message text.
Data type: String
parseMode
Parse mode of the message text.
Default is "MarkdownV2".
Data type: String
disableWebPagePreview
Disable preview of web links in the sent message.
Default is false.
Data type: Boolean
silent
Send message silently.
Default is true.
Data type: Boolean
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}**.",
)
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, the following resources are available:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.