Skip to main content
The Telegram integration sends security alerts to Telegram through a bot you control. Because one bot can talk to many people, each user pairs their own Telegram account to the integration before they receive alerts.

​
Prerequisites

  • A Telegram account.
  • A bot created with BotFather, and its bot token.

​
Create a bot

1

Open BotFather

In Telegram, search for BotFather and open the chat.
2

Create the bot

Send /newbot and follow the prompts. Choose a display name and a username that ends in bot, for example oasm_alerts_bot.
3

Copy the token

BotFather replies with a token that looks like 1234567890:ABCdef.... Copy it.
The bot token grants full control of the bot. Keep it secret. If it leaks, revoke it with BotFather (/revoke) and reconnect the integration.

​
Connect Telegram

1

Open the Applications tab

In the console sidebar, open Integrations and select the Applications tab.
2

Open Telegram

Select the Telegram card.
3

Enter a name and bot token

Enter an Integration name, then paste the Bot Token from BotFather.
4

Choose events

Use the Event and Severity switches to control what OASM sends. See What notification integrations send.
5

Connect

Select Connect. OASM verifies the bot token with Telegram before saving the integration.
Connecting the bot does not deliver alerts yet. Each recipient must pair their Telegram account first.

​
Pair a Telegram account

Pairing is per user. Anyone in the workspace can pair their own Telegram account to the same integration.
1

Open the integration

In the Connected tab, select the Telegram integration.
2

Open the pairing dialog

In the Telegram Pairing section, select Pair.
3

Generate a pairing token

Select Generate Pairing Token. OASM creates a one-time token valid for 10 minutes.
4

Open the bot

Scan the QR code with your phone, or select Open Telegram to open the bot with the token already attached.
5

Send the token

If you opened the bot manually, send /start <token>. The dialog switches to Connected when Telegram confirms the chat.
Pairing tokens are valid for 10 minutes. Select Generate New Token and try again.
A Telegram chat can pair once per integration. To move it, disconnect the existing device first.

​
Manage paired accounts

The Telegram Pairing section lists every connected chat. To remove one, select the unplug icon next to it and confirm. OASM sends a final message to that chat and stops delivering to it.
In a production deployment, OASM registers a Telegram webhook for the bot automatically. In local development, it uses long polling instead. You do not choose between these — the deployment decides.

​
Test

Open the integration and select Test Integration. OASM sends a test message to every paired chat. If no chat receives it, confirm at least one account is paired and the bot token is still valid.

Notifications

See every event the platform produces

Slack

Send alerts to a Slack channel instead

Integrations overview

Learn how events, secrets, and connections work