Telegram Integration
Send formatted incident alerts via Telegram bot messages for instant mobile notifications
Telegram Integration
Connect StatusPageOne with Telegram to receive instant, well-formatted incident alerts through bot messages. Perfect for personal notifications, international teams, and communities using Telegram for communication.
Why Telegram Integration?
✅ Benefits
- •Instant delivery with push notifications on mobile and desktop
- •Rich markdown formatting for clear, readable incident reports
- •Cross-platform support - works on all devices
- •Unlimited notifications across all plan tiers
- •Free to use - no SMS charges or carrier fees
🎯 Perfect For
- •International teams using Telegram for communication
- •Personal monitoring for side projects and small services
- •Mobile-first alerts with excellent app notifications
- •Cost-conscious teams wanting to avoid SMS charges
- •Communities and startups already using Telegram
Telegram Message Format
StatusPageOne sends rich markdown-formatted messages with complete incident information:
Incident Alert Example
Recovery Alert Example
Setup Guide
Step 1: Create a Telegram Bot
-
Open Telegram and find @BotFather
- Search for "@BotFather" in Telegram
- Start a chat with the official BotFather bot
-
Create a new bot
- Send
/newbotcommand to BotFather - Choose a name for your bot (e.g., "StatusPage Alerts")
- Choose a unique username ending in "bot" (e.g., "mystatus_alerts_bot")
- Send
-
Get your bot token
- BotFather will provide a bot token
- Format:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz - Save this token securely
Bot Token Security
Your bot token is like a password - keep it secure and never share it publicly.
123456789:ABCdefGHIjklMNOpqrsTUVwxyz-1234567890
Step 2: Get Your Chat ID
You need to find the chat ID where messages should be sent:
For Personal Messages (Direct Messages)
-
Start your bot
- Find your bot in Telegram (search for the username you created)
- Send
/startto your bot - Send any message to establish the chat
-
Get your Chat ID
- Visit:
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - Replace
<YOUR_BOT_TOKEN>with your actual bot token - Look for the
"chat":{"id":123456789}in the response - Your chat ID is that number (e.g.,
123456789)
- Visit:
For Group Messages
-
Add bot to group
- Create or open an existing Telegram group
- Add your bot to the group as an administrator
- Send a message mentioning the bot (e.g.,
@mystatus_alerts_bot hello)
-
Get Group Chat ID
- Use the same
getUpdatesURL as above - Group chat IDs are negative numbers (e.g.,
-987654321)
- Use the same
Finding Your Chat ID
Chat IDs are unique identifiers for Telegram chats. Personal chats have positive IDs, groups have negative IDs.
123456789-987654321-100123456789Step 3: Configure in StatusPageOne
-
Access Integration Settings
- Navigate to your monitor in the console
- Click the Integrations tab
- Select Add Integration
- Choose Telegram from the integration types
-
Enter Bot Configuration
Bot Token * [Configuration field]
The bot token provided by @BotFather
Chat ID * [Configuration field]
Chat ID where messages will be sent (positive for personal, negative for groups)
Integration Name [Configuration field]
Descriptive name to identify this integration
[Toggle to enable] Enable notifications
Step 4: Test the Integration
- Click Test Integration to send a sample alert to your Telegram chat
- Check your Telegram app for the test message
- Verify the message formatting and content appear correctly
Step 5: Save and Activate
- Click Save Integration
- Confirm the integration shows as Active
- Your Telegram chat will now receive incident notifications
Advanced Configuration
Multiple Telegram Chats
Set up different Telegram integrations for various purposes:
Personal Notifications
Team Group
On-Call Channel
Development Team
Bot Customization
Enhance your Telegram bot with additional commands:
Optional Bot Commands
You can add these commands to your bot via @BotFather for better user experience:
/start - Start receiving status alerts/help - Show available commands/status - Get current system status/stop - Stop receiving alertsSetting Bot Commands
- 1. Message @BotFather with
/setcommands - 2. Select your bot
- 3. Send the command list above
- 4. Commands will appear in Telegram's bot menu
Message Features
Telegram Markdown Support
StatusPageOne uses Telegram's markdown formatting for rich text:
Formatting Elements
Message Structure
Mobile Optimization
Telegram messages are optimized for mobile viewing:
- Readable Format: Important information appears first
- Scannable Layout: Key-value pairs for quick understanding
- Appropriate Length: Detailed but concise for mobile screens
- Clear Hierarchy: Bold headers and organized sections
Integration Management
Bot Health Monitoring
Track your Telegram integration status:
- • Delivery Status: Success/failure of recent messages
- • Bot Status: Active/inactive bot verification
- • Chat Availability: Validation that chat ID is accessible
- • Last Activity: Timestamp of last successful message
- • Error Tracking: Failed deliveries with specific error details
Multiple Bot Management
For complex setups with multiple bots:
- Dedicated Bots: Create separate bots for different environments
- Shared Bots: Use one bot with multiple chat IDs
- Permission Management: Configure bot admin rights in groups
- Token Security: Store bot tokens securely and rotate regularly
Troubleshooting
Common Issues
❌ Messages Not Received
- • Verify bot token is correct and complete
- • Check that bot is still active (not deleted by @BotFather)
- • Ensure bot has permission to send messages
- • Confirm bot was not blocked by the user
- • Verify chat ID is correct (check positive/negative)
- • Ensure you've sent at least one message to the bot first
- • For groups: confirm bot is added as member/admin
- • Check if group was deleted or bot was removed
⚠️ Formatting Problems
- • Markdown formatting requires Telegram parse mode
- • Long messages may be truncated or split
- • Some special characters might not display correctly
- • Line breaks and spacing preserve message structure
🔧 API Errors
- • 400 Bad Request: Invalid bot token or chat ID
- • 403 Forbidden: Bot blocked by user or removed from group
- • 404 Not Found: Bot or chat doesn't exist
- • 429 Too Many Requests: Rate limited by Telegram
Testing and Validation
🧪 Telegram Integration Testing
Debug Tools
Telegram API Testing
Best Practices
✈️ Telegram Integration Best Practices
Bot Management
- • Use descriptive bot names for easy identification
- • Keep bot tokens secure and never share publicly
- • Set up bot commands for better user experience
- • Test bot functionality after any changes
Chat Organization
- • Use personal chats for critical individual alerts
- • Set up group chats for team coordination
- • Create channels for broadcast-only notifications
- • Document chat IDs for team reference
Message Strategy
- • Use clear, descriptive monitor names
- • Combine with email for detailed documentation
- • Set up escalation with different notification methods
- • Monitor message delivery success rates
Security
- • Regularly audit bot permissions and access
- • Use group admins to control bot membership
- • Monitor for unauthorized bot usage
- • Delete unused bots to reduce security surface
Telegram vs. Other Messaging Platforms
When to Choose Telegram
Telegram is Ideal For:
- • Individual developers
- • Personal projects
- • Side businesses
- • International users
- • Teams already using Telegram
- • Global/remote teams
- • Cost-conscious organizations
- • Mobile-first workflows
Usage and Limits
Plan Limits
| Plan | Telegram Notifications | Features |
|---|---|---|
| Free | Unlimited | Basic markdown formatting |
| Pro | Unlimited | Rich formatting + bot customization |
| Business | Unlimited | Priority delivery + advanced analytics |
Rate Limiting
StatusPageOne respects Telegram's API limits:
- Bot message rate limit: 30 messages per second
- Group message rate limit: 20 messages per minute per group
- Automatic retry logic for rate limit errors
- Delivery confirmation and error tracking
International Use Cases
Global Teams
Eastern Europe Team
Telegram is extremely popular in Eastern European countries
High adoption rate, excellent mobile app performance
Remote Development Teams
Cross-platform consistency for distributed teams
Works on all devices, reliable in low-bandwidth areas
Crypto/Blockchain Projects
Popular platform in cryptocurrency communities
Built-in community features, bot ecosystem
Startup Communities
Free alternative to paid business messaging platforms
No subscription fees, rich feature set
Security Considerations
Bot Security
🔒 Security Best Practices
- • Keep bot tokens secret - treat them like passwords
- • Use private groups for sensitive monitoring data
- • Regular token rotation if tokens are ever exposed
- • Monitor bot usage in Telegram admin logs
- • Delete unused bots to reduce attack surface
Next Steps
After setting up Telegram integration:
- Configure Email Alerts - Add detailed incident documentation
- Set Up Team Chat - Enable enterprise team coordination
- Add SMS Notifications - Ensure critical alerts reach everyone
- Implement Webhooks - Enable automated incident response
Telegram provides excellent personal and international team notification capabilities. Combine with other channels for comprehensive incident management coverage.
Support
Need help with Telegram integration?
- Verify bot token and chat ID are correct
- Test bot functionality with Telegram API directly
- Check bot permissions in groups and channels
- Contact support for persistent integration issues
Improve this page
Found an error or want to contribute? Edit this page on GitHub.