Telegram Integration
Receive instant Abrova Trace error alerts via a Telegram bot. Set up the bot with BotFather, get your Chat ID, and start receiving notifications.
Receive instant error alerts via Telegram bot. Set up a bot, get your chat ID, and start receiving notifications in minutes.
Telegram is a service outside Iran and may be unreachable from some networks in Iran. To set it up and to read the alerts you need a connection that can reach Telegram, and deliveries only arrive while api.telegram.org answers — failed deliveries show in the integration's delivery log. If that is a problem for your team, use the Email or Webhook integration instead, or alongside it.
Which channels your project can use is shown on the Trace → Integrations page in Abrova Console.
Create a Telegram Bot#
- Open Telegram and search for @BotFather
- Send the command:
/newbot - Enter a name for your bot (e.g., "AbrovaTrace Alerts")
- Enter a username (must end with "bot", e.g., "MyAbrovaTrace_bot")
- Copy the Bot Token provided by BotFather
Token format: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz123456789
Get Your Chat ID#
Option A: Personal Chat
- Start a conversation with your bot (search by username)
- Send any message to the bot
- Open this URL in your browser:
https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdatesFind your Chat ID in the JSON response under message.chat.id.
Option B: Group Chat
- Create a new group or use an existing one
- Add your bot to the group
- Send a message in the group
- Use the same
getUpdatesURL above
Group Chat IDs are negative numbers (e.g., -1001234567890).
Configure in AbrovaTrace#
- In Abrova Console, open Trace → Integrations (integrations belong to the selected project)
- Click "Add integration" and choose Telegram (or "Connect" on the Telegram card)
- Enter a Name, your Bot token and Chat ID
- Click "Save and send test" to save and verify it (or "Save channel")
| Option | Type | Required | Description |
|---|---|---|---|
| Name | string | Yes | Friendly name (e.g., Ops chat) |
| Bot token | string | Yes | Token from BotFather (1234567890:ABC...) |
| Chat ID | string | Yes | Personal or group Chat ID (a number, e.g. -1001234567890), or @channelname |
After saving
Managing integrations (add, edit, switch on/off, delete, test) needs the admin or owner role; every role can see them and their delivery log. See Roles & Permissions.
The bot token is never shown again once saved: the form shows it as set. Leave it as it is to keep the saved token, or press Replace to enter a new one.
If you change the Chat ID, enter the bot token again as well — a saved token is never used for a different chat on its own.
Notification Format#
Telegram messages from AbrovaTrace include:
- 🚨 New Error Detected header
- Error message in a monospace block
- Project, environment, occurrence count, first-seen timestamp
- The first 500 characters of the stack trace
- A View in Dashboard link
Troubleshooting#
Bot not sending messages?
- You must start a conversation with the bot first
- Verify Bot Token is correct
- Check Chat ID is accurate
- For groups, ensure bot is added as a member
- Check the delivery log of the integration: a timeout or connection error means Telegram could not be reached
Chat ID not appearing in getUpdates?
- Send a message to the bot after creating it
- Wait a few seconds and refresh the URL
- For groups, send a message after adding the bot
"Unauthorized" error?
- Bot Token may be invalid or revoked
- Create a new token with BotFather using
/revoke - Edit the integration in Trace → Integrations and press Replace on the bot token