> ## Documentation Index
> Fetch the complete documentation index at: https://docs.use.observer/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> Connect a Telegram chat to receive incident alerts.

Telegram delivers incident alerts to a chat or group through the Observer bot.

## Connect a chat

<Steps>
  <Step title="Start the connection">
    In the console, open **Alerts**, choose **Add alert**, pick
    **Telegram**, choose the scope, and select **Connect via Telegram**. This opens
    the Observer bot in Telegram.
  </Step>

  <Step title="Press Start">
    In the chat that opens, press **Start**. The bot links that chat to your
    organization and confirms with a welcome message.
  </Step>

  <Step title="Confirm">
    Return to the console; the form detects the connection automatically. The
    Telegram integration now appears in the list. Use **Send test** from the row's
    actions menu to send a sample alert.
  </Step>
</Steps>

The connect link links your private chat with the bot. To deliver to a group
or channel, add the bot to it, then enter the group's chat id or the channel's
`@channelname` in the **Chat ID** field as described below.

## Enter a chat id manually

If you already know the chat id, you can skip the deep link and type it into the
**Chat ID** field instead. Numeric ids and `@channelname` handles are both
accepted.

<Info>
  **The link is short-lived**

  The connect link is signed and expires after fifteen minutes. If it expires
  before you press Start, generate a new one from the form.
</Info>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.