Telegram Integration Guide

Overview

Integrating Telegram with UptimeObserver allows you to receive real-time alerts and status updates directly within Telegram. This ensures you can quickly respond to downtime, latency issues, and other incidents affecting your website or services.

Note

Telegram integration is available on free and paid plans.

Support

If you need help with this integration please reach out to us using the "Need Help?" button on the bottom right corner or send us an email at support@uptimeobserver.com.

Step-by-Step Guide

Go to UptimeObserver and log in to your account.
Navigate to the Integrations section from your dashboard.
Choose Telegram from the list of available integrations.
Copy the connect command.
Open Telegram, Search for UptimeObserverBot and send the connect command. It should look like /connect XXXXXXXX:X.
The bot will immediately respond to confirm the integration.
You can now test Telegram by clicking on Test Telegram Alert button.

Enabling Alerts on Monitors

After you have successfully integrated Telegram with your UptimeObserver account, you must manually assign which monitors should send alerts. This allows you to customize notifications so you receive alerts only for the monitors you care about.

Navigate to Monitors: From your dashboard, click on the specific monitor you wish to configure to enter its Monitor Detail page.
Add Alert: Find the alerting section and click the Add Alert button.
Select Alert Type: In the Alert Type dropdown menu, select Telegram.
Choose the Event: Pick the relevant trigger from the Event dropdown (e.g., Monitor Down, Monitor Up).
Save Changes: Click the Save Changes button to activate the alert.
Repeat as Needed: You can repeat this process to configure alerts for multiple monitors or different events.

Recommendation

We recommend setting up alerts for both "Down" and "Up" events. This ensures you're notified immediately when an issue starts and, just as importantly, when it has been resolved.

Troubleshooting

If you are having trouble receiving alerts or setting up the integration, check the common solutions below.

1. Bot Responds with "Invalid Key"

If the bot responds with "Invalid Key" when you send the connect command:

Check the command format: Ensure you're sending the exact command copied from UptimeObserver, including the /connect prefix
Command expiration: Connect commands may expire after some time. Go back to UptimeObserver and copy a fresh connect command
No extra spaces: Make sure there are no extra spaces before or after the command
Try again: Simply navigate back to the Telegram integration page and copy the command again

2. Not Receiving Messages from the Bot

If the integration shows as connected but you're not receiving notifications:

Check Telegram notifications: Ensure Telegram notifications are enabled on your device (Settings → Notifications)
Bot not blocked: Verify you haven't accidentally blocked the UptimeObserverBot. Search for it in Telegram and ensure you can send messages
Monitor assignment: Verify that the alert is actually assigned to your monitor. Go to the Monitor Detail page and check the "Alerts" section
Event selection: Make sure you selected the correct event type (e.g., "Monitor Down" for downtime alerts)
Test the integration: Use the "Test Telegram Alert" button in UptimeObserver to verify the connection works

3. Test Button Works but No Alerts During Downtime

If test messages arrive but you don't receive real incident alerts:

Alert not added to monitor: The integration being active doesn't automatically send alerts. You must add Telegram as an alert on each monitor you want to receive notifications for
Wrong event selected: If you only configured "Monitor Up" alerts, you won't receive notifications when the site goes down
Check monitor status: Ensure the monitor is actively running and not paused

4. Group Chat Integration

Currently, UptimeObserver's Telegram integration works with direct messages to the bot. If you need alerts in a group chat:

Workaround: You can create a Telegram channel and forward messages from the bot to your group
Feature request: Contact support if you need group chat functionality—we're always looking to improve

5. Multiple Telegram Accounts

If you want to send alerts to multiple Telegram accounts:

Each team member needs to connect their own Telegram account using the connect command
Currently, one UptimeObserver account links to one Telegram account
For team alerts, consider using Slack or Webhooks which support multiple recipients

6. How to Reset the Integration

If all else fails, try a fresh start:

In Telegram, find the UptimeObserverBot and send /disconnect or block and unblock the bot
Go to UptimeObserver → Integrations → Telegram
Remove the existing Telegram configuration if present
Follow the Step-by-Step Guide above to reconnect