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

# Telegram

> Deliver Clarion approvals, clarifications, and alerts to a Telegram chat through your own bot.

Telegram is a [notification channel](/learn/notifications/introduction): agents deliver approval requests, clarification questions, and escalations into a Telegram chat, and replies resume the run.

<Note>
  **Estimated time:** 5 minutes. You will need the ability to create a bot with Telegram's **@BotFather**.
</Note>

## Prerequisites

* A **Telegram** account
* A group or channel you want Clarion to post into

## Step 1 — Create a bot

1. In Telegram, open a chat with **@BotFather**.
2. Send `/newbot` and follow the prompts to name your bot.
3. BotFather replies with a **bot token** in the form `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`.

<Warning>
  The bot token is a credential. Anyone holding it can post as your bot. Store it securely and rotate it from BotFather if it leaks.
</Warning>

## Step 2 — Add the bot to your chat

1. Add the bot to the group or channel you want notifications in.
2. Grant it permission to post messages.
3. Note the **chat ID** for that conversation — group and channel IDs are negative numbers, e.g. `-1001234567890`.

## Step 3 — Connect in Clarion

1. In Clarion, open **Integrations** and find **Telegram**.
2. Paste the **bot token** and click **Connect**.
3. Under **Add Channel**, give the destination a **name** (e.g. `Alerts`) and paste its **chat ID**.

You can add several channels — each becomes selectable as a [notification destination](/learn/notifications/introduction).

## What agents can do

| Tool            | What it does                                            |
| --------------- | ------------------------------------------------------- |
| `send_message`  | Post a message to a configured Telegram channel         |
| `list_channels` | List the Telegram channels configured on this workspace |

## Rotate the token

Open **Integrations → Telegram** and enter a **New bot token**. Existing channels keep working.

## Disconnect

Click **Disconnect** on the integration page. Configured channels are removed, and any notification destination pointing at Telegram stops delivering.