Sentry integration: Telegram Alerts Bot FAQ

Alex Soqoor

Set Up Sentry Alerts in Telegram with Ease

What is this bot for?

Sentry Alerts Telegram bot helps you receive alert notifications from Sentry.io directly in your personal or group Telegram chats.

How to Get Started

Step 1: Start the Bot

Begin by sending the command /start to the bot in Telegram or add the bot to a group chat
The bot will reply with an instruction message and provide you with a unique personal key for the chat

Step 2: Install the Sentry Integration

Log in to your Sentry account
Go to the Integrations section and install the Telegram Alerts Bot
Follow the setup instructions provided by Sentry to enable the integration.

Step 3: Configure Alerts in Sentry

Create a new alert or edit an existing one in Sentry
In the alert configuration, add the action Notify integration > Telegram Alerts Bot
Enter the unique personal key you received from the bot into the corresponding field in this action’s Settings
Save the alert configuration

Self-Hosted Sentry Integration Setup

To receive alerts from your self-hosted Sentry instance via Telegram bot:

Step 1: Create Internal Integration

In Sentry go to Settings → Custom Integrations. And create new Internal Integration.

Fill in the following fields:

Name: Any name you prefer
Webhook URL: https://soqoor.space/sentry/webhook/
Alert Rule Action: Set to True (enables use in alert rules)
Schema (paste as-is, without any changes — do not replace anything, even your actual key):

{
  "elements": [
    {
      "type": "alert-rule-action",
      "title": "Send telegram notification",
      "settings": {
        "type": "alert-rule-settings",
        "uri": "/sentry/alert-rule",
        "required_fields": [
          {
            "type": "text",
            "label": "Chat Key",
            "name": "telegram_bot_chat_key"
          }
        ],
        "description": "You can get your Chat Key by starting a conversation with the @sentry_io_bot or by adding the bot to group chat."
      }
    }
  ]
}

⚠️ Important ⚠️

When setting up self-hosted Sentry, do not enable additional webhooks for error, issue, comment, or other event types beyond what is specified in the integration steps. These unnecessary webhooks may trigger notifications for every new event/error, which can lead to webhook rate limiting and, as a result, loss of important alerts.

Step 2: Use the Integration in Alerts

Create a new alert or edit an existing one in Sentry
In the alert configuration, add the action Notify integration > Telegram Alerts Bot
Enter the unique personal key you received from the bot into the corresponding field in this action’s Settings
Save the alert configuration

How does it work?

Once the setup is complete, any Sentry alert that matches the specified conditions will trigger a notification sent to the configured Telegram chat or group via the bot

Additional Tips

The bot can be added to multiple chats or groups, and each chat will have a unique personal key
You can customize alert rules in Sentry to control which notifications are sent to Telegram.

Troubleshooting

Q: I lost my personal key

A: Send /start command to the bot again to recover the key for the chat

Q: Notifications are not being sent

A: Ensure the following:

The integration is correctly installed in Sentry
The correct personal key is entered in the alert configuration
The bot is not removed or muted in the Telegram chat
The bot has the necessary rights to send messages to a group chat (e.g., the bot doesn’t have admin rights, and sending messages is allowed only for admin members)

Q: I want to receive alerts in another chat

A: Add the bot to the new chat and send /start to get a key specific to that chat