Skip to content

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 all plans.

Prerequisites

Before setting up this integration, you'll need:

  1. A Telegram account
  2. The Telegram app installed on your device

Step-by-Step Guide

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

Enabling Alerts on Monitors

Follow Add an alert to a monitor. Select Alert Type → Telegram; this uses the account's connected chat, with no recipient selector. Add separate Monitor Down and Monitor Up rules.

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: Open Monitor Details → Alerts and verify the Telegram rule is active on the correct monitor
  • 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:

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

How to Uninstall

In UptimeObserver:

  1. Go to UptimeObserver and log in to your account.
  2. Navigate to the Integrations section from your dashboard.
  3. Select Telegram from the list.
  4. Click the delete/remove button to disconnect the integration.

In Telegram:

  1. Open Telegram and search for UptimeObserverBot.
  2. Open the chat and tap the bot's name at the top.
  3. Select "Stop Bot" or "Block Bot" to prevent further messages.

Need Help?

If you need help with this integration, please contact us via the support button or email us at support@uptimeobserver.com.