> For the complete documentation index, see [llms.txt](https://uliquid-1.gitbook.io/uliquid-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uliquid-1.gitbook.io/uliquid-docs/user-guide/connect-telegram.md).

# Connect Telegram

Link a private Telegram chat to receive eligible uLiquid Desk notifications.

Connect your private Telegram chat to receive eligible uLiquid Desk notifications. Linking Telegram is separate from connecting an exchange account or wallet. It does not give the bot permission to trade, move funds, or access your Telegram account.

## Before You Start

* Sign in to uLiquid Desk with the account that should receive notifications.
* Install or open Telegram on the device you will use.
* The **Telegram alerts** card must show that the bot is configured. If it says that the bot is not configured, contact uLiquid Desk support; do not enter a bot token yourself.

## Link Your Private Chat

1. Open **Settings** → **Notifications**.
2. In **Telegram alerts**, select **Connect Telegram**.
3. Select **Open Bot**. This opens a one-time Telegram link for your account.
4. In Telegram, open the bot and press **Start** before the expiry time shown in uLiquid Desk.
5. Return to uLiquid Desk and select **Refresh status**.
6. Confirm that the status is **Connected** and that the displayed connected chat is yours.

The connection link is single-use. If it expires or you opened the wrong Telegram account, start a new connection from **Settings** → **Notifications**.

## Use Connected Notifications

After the status is **Connected**, Telegram becomes available for eligible notification settings, including the notification test and selected calendar or subscription notices. Availability can depend on your account, plan, and the current feature configuration.

Review each notification setting before saving it. Notifications provide information and status; they do not execute trades or change wallet, exchange, bot, or vault settings.

## Limits and Safety

* The guided connection supports a private chat with the bot, not a Telegram group.
* A Telegram chat can be linked to only one uLiquid Desk account at a time.
* Never share a Telegram link, bot token, recovery code, exchange API key, wallet seed phrase, or private key in a chat.
* Use **Disconnect** in **Settings** → **Notifications** to remove the linked chat. You can link it again later through a new connection flow.

## Troubleshooting

| Problem                                 | What to do                                                                                                         |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| The bot is not configured               | Contact uLiquid Desk support. A user account cannot configure the shared bot.                                      |
| Status stays **Connection in progress** | Open the bot from the current link, press **Start**, then use **Refresh status**.                                  |
| The link expired                        | Select **Connect Telegram** again to create a new one-time link.                                                   |
| The chat is already linked              | Disconnect it from the other uLiquid Desk account first, or contact support if you cannot access that account.     |
| No notification arrives                 | Confirm the status is **Connected**, then use the notification test and check the individual notification setting. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://uliquid-1.gitbook.io/uliquid-docs/user-guide/connect-telegram.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.