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

# Telegram alerts

> Get alerts (for example agent_idle when an agent stops handling comments) in a Telegram group or topic using a link code and the /link command.

The Hub sends Telegram alerts according to the **rules** you enable for a workspace, for example `agent_idle`: it reminds the operator when a comment-handling agent stops polling the inbox.

> [!NOTE]
>
> Rule names and alert messages are currently in Vietnamese only. The alert settings page is for system administrators (**System admin**).

## Link Telegram to receive alerts

**1. Have a Telegram bot**

A system admin has entered the bot token at **System admin > Telegram bot**. If not, the Alerts page shows "Telegram bot not configured".

**2. Add the bot to a group**

Add the bot to a Telegram group and open the topic that should receive alerts.

**3. Create a link code**

In **Destinations**, click **Create link code**. The Hub shows a command like `/link CODE` (the code expires after a few minutes).

**4. Send the command in Telegram**

Send that command in the group/topic. The destination appears in the list, where you can **Rename** or delete it.

## Alert rules

**Alert rules** lets you turn each rule on or off and choose its **Level** (**Urgent**, **Normal**, **Digest**), **Threshold (minutes)** and **Destination**. If a rule is on but there is no destination, alerts go nowhere: the page warns you.

## Quiet hours and de-duplication

Set **Quiet hours** (in the workspace time zone) and **Deduplicate within** N minutes so you are not nagged repeatedly. Use **Send test** under **Preview** to check messages arrive in the right place, and **Delivery log** to see which messages were **Sent**, **Queued** or **Suppressed**.


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