SeentySeenty Docs

Telegram

Send Seenty alerts to Telegram chats using a Telegram bot.

Telegram Integration

Connect Seenty to Telegram to receive alert notifications via a Telegram bot in your personal chat or group. Telegram integration is available on Pro plans and above.

Telegram integration requires a Pro plan or higher. Upgrade from Workspace > Billing to enable this channel.

What you get

Telegram notifications are sent as formatted text messages with:

  • Alert type and severity -- Clearly labeled at the top of each message.
  • Resource details -- Monitor name, status, response time, and affected URL.
  • Incident context -- Severity, current status, and timeline for incident-related alerts.
  • Direct links -- Click through to the affected resource in your Seenty dashboard.

Setup

Create a Telegram bot

  1. Open Telegram and search for @BotFather.
  2. Send the command /newbot.
  3. Follow the prompts to choose a name and username for your bot.
  4. BotFather will respond with a Bot Token (e.g., 123456789:ABCdefGHIjklMNOpqrsTUVwxyz). Copy this token.

Get your Chat ID

You need the Chat ID of the conversation where you want alerts sent. This can be a private chat with the bot, a group chat, or a channel.

For a private chat:

  1. Search for your new bot by its username and start a conversation.
  2. Send any message to the bot (e.g., "hello").
  3. Open this URL in your browser, replacing YOUR_BOT_TOKEN with the token from step 1:
    https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
  4. Find the "chat":{"id":123456789} value in the response. This is your Chat ID.

For a group chat:

  1. Add the bot to the group.
  2. Send a message in the group.
  3. Use the same getUpdates URL above.
  4. Find the chat ID for the group (group IDs are negative numbers, e.g., -987654321).

Add the channel in Seenty

  1. Go to Integrations > Notification Channels.
  2. Click Add Channel and select Telegram.
  3. Enter a name for the channel (e.g., "Telegram - Alerts Group").
  4. Paste the Bot Token and Chat ID.
  5. Click Save.

Test the integration

Click the Test button next to your new Telegram channel. A test message should appear in the configured Telegram chat within a few seconds.

Assign to monitors or policies

Add the Telegram channel to the monitors or escalation policies that should send alerts via Telegram.

Troubleshooting

Messages not appearing?

  • Ensure the bot has been started (you need to send /start to the bot in a private chat, or the bot needs to be added as a member of the group).
  • Verify the Bot Token and Chat ID are correct.
  • For group chats, make sure the bot has permission to send messages in the group.
  • If the bot was recently created, try sending another message and refreshing the getUpdates URL.

Bot was blocked or removed?

  • If you blocked the bot in Telegram, unblock it and send /start again.
  • If the bot was removed from a group, add it back and update the Chat ID if necessary.

The Bot Token is a sensitive credential. Anyone with access to the token can control your bot. Keep it confidential and regenerate it via @BotFather (/revoke) if you suspect it has been compromised.