OpsionDocs
ConsoleWebsiteSign in

Telegram Notifications

Opsion sends alert notifications via its Telegram bot directly to your personal chat or any Telegram group. You provide the Chat ID once; the bot handles delivery.

How it works

Telegram notifications use the Opsion bot and your Telegram Chat ID. The Chat ID uniquely identifies your personal conversation with the bot, or a group chat you have added the bot to. Opsion calls the Telegram Bot API to send messages whenever an alert fires.

There are two levels of configuration:

  • Org-level Chat ID (Settings → Notifications) — used as the default for all rules that have Telegram enabled.
  • Per-rule Chat ID (alert rule configuration) — overrides the org default for that specific rule. Useful for routing critical alerts to a different group.

Get your Telegram Chat ID

For a personal chat

  1. Open Telegram and search for the Opsion bot.
  2. Start the bot by pressing Start or sending /start.
  3. Send /chatid — the bot will reply with your Chat ID, for example: 123456789.

For a group chat

  1. Add the Opsion bot to your Telegram group.
  2. Send /chatid in the group — the bot replies with the group's Chat ID, which is always a negative number, for example: -1001234567890.
✦

Alternative: @userinfobot

If you cannot use /chatid, forward any message from your target chat to @userinfobot. It will reply with the chat ID of the original sender or group.

Add to Opsion (org-level)

  1. Open the Opsion console and go to Settings → Notifications.
  2. Paste your Chat ID into the Telegram Chat ID field.
  3. Click Save.

This Chat ID becomes the default for all alert rules in your organisation that have Telegram enabled.

Enable Telegram on alert rules

  1. Open Alerts → Rules and click the rule.
  2. In Notification channels, toggle Telegram on.
  3. If an org-level Chat ID is configured, the rule will show "Using org default Chat ID · Change in Settings".
  4. Save the rule.
💡

Plan requirement

Telegram notifications require the Team plan or above.

Per-rule Chat ID override

To send a specific rule's alerts to a different Telegram chat, enter a Chat ID directly in the rule's Telegram Chat ID field. This overrides the org-level default for that rule only. Leave the field empty to use the org default.

✦

Use case

A common pattern is to set the org-level Chat ID to a general alerts group, then override critical rules to post to a dedicated on-call channel or a personal chat for immediate attention.

Message format

Telegram messages use Markdown formatting:

text
*Large transfer detected on asset*
Tx 0x27b037ae | -1.5 ETH | ethereum
[View on explorer](https://etherscan.io/tx/0x27b037ae...)
[Open in Opsion](https://console.opsion.xyz/transactions?hash=0x27b037ae...)

The transaction link is rendered as a hyperlink directly inside the message.

LarkEmail