Telegram

type: telegram sends a message through the Telegram Bot API.

Options

Option	Type	Required	Default	Description
`type`	`telegram`	Yes	—
`botToken`	string	Yes	—	Token from @BotFather. Use `env:`.
`chatId`	string	Yes	—	Numeric chat ID (negative for groups).

Plus the common fields (name, onSuccess, onFailure).

Set up a bot

Create the bot

Open @BotFather in Telegram, send /newbot, and follow the prompts. BotFather replies with the bot token — store it in an environment variable and reference it with env:.

Add the bot to the chat

For a group or channel, add the bot as a member first. The bot cannot post to a chat it is not in.

Find the chat ID

Send any message in the target chat, then open https://api.telegram.org/bot<TOKEN>/getUpdates in a browser. The chat.id field in the response is your chat ID. Group IDs are negative numbers.

Example

snapr.yaml

notifiers:
  - type: telegram
    name: oncall
    botToken: env:TG_BOT_TOKEN
    chatId: '-1001234567890'
    onFailure: true

Quote the chatId value. Group IDs start with -, and YAML would otherwise parse the value as a number.

⌘I

Getting started

Configuration

Options

Set up a bot

Example

​Options

​Set up a bot

​Example

Options

Set up a bot

Example