---
title: telegram.message() function
description: telegram.message() sends a single message to a Telegram channel using the sendMessage method of the Telegram Bot API.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/sranka/telegram/message/
estimated_tokens: 1645
product: Flux
version: v0
---

# telegram.message() function

-   Flux 0.70.0+
-   View InfluxDB support

`telegram.message()` is a user-contributed function maintained by the [package author](#package-author-and-maintainer).

`telegram.message()` sends a single message to a Telegram channel using the [`sendMessage`](https://core.telegram.org/bots/api#sendmessage) method of the Telegram Bot API.

##### Function type signature

```js
(
    channel: A,
    text: B,
    token: string,
    ?disableWebPagePreview: C,
    ?parseMode: D,
    ?silent: E,
    ?url: string,
) => int
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## 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

(Required) Message text.

### parseMode

[Parse mode](https://core.telegram.org/bots/api#formatting-options) of the message text. Default is `MarkdownV2`.

### disableWebPagePreview

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

### silent

Send message [silently](https://telegram.org/blog/channels-2-0#silent-messages). Default is `true`.

## Examples

### Send the last reported status to Telegram

```js
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}**.")
```

[single notification](/flux/v0/tags/single-notification/)