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

# Telegram setup

> Connect unCoded to Telegram to receive real-time trade notifications and manage your bot via Telegram commands.

Telegram integration is optional. Once connected, unCoded can send trade notifications directly to a Telegram group and respond to commands so you can monitor and manage your bot from your phone or desktop.

**Prerequisites:** An active Telegram account and the Telegram desktop or mobile client (Windows, iOS, or Android).

<Note>
  All steps below assume you are using the Telegram desktop or mobile client, not the web version.
</Note>

***

## Link your Binance UID

Before configuring Telegram, make sure your Binance UID is linked to your unCoded account.

Open [@unCoded\_bot](https://t.me/unCoded_bot) in Telegram and follow the prompts under **Account → Add / verify UID** to connect your Binance account.

***

## Create a bot via BotFather

<Steps>
  <Step title="Open BotFather">
    Open a chat with [@BotFather](https://t.me/BotFather) on Telegram.
  </Step>

  <Step title="Create a new bot">
    Send the following command:

    ```text theme={null}
    /newbot
    ```

    Follow the prompts to choose a **name** and **username** for your bot.
  </Step>

  <Step title="Save your Bot Token">
    Once complete, BotFather sends you a **Bot Token**. Copy and save this — you will add it to your server configuration later.
  </Step>
</Steps>

***

## Create a group and add your bot

<Steps>
  <Step title="Open the menu">
    In the Telegram desktop or mobile client, click the **menu icon** (three horizontal lines) in the top left corner.
  </Step>

  <Step title="Create a new group">
    Select **New Group** and give it a name (e.g., `unCoded Trading`).
  </Step>

  <Step title="Add participants">
    When prompted to add participants, add:

    * Your newly created bot (from BotFather)
    * The helper bot **@myidbot**

    You are added to the group automatically.
  </Step>

  <Step title="Save the group">
    Confirm and save the group settings.
  </Step>
</Steps>

***

## Give your bot administrator rights

Your bot must have administrator rights in the group to function correctly.

<Steps>
  <Step title="Open group settings">
    Open your new group, click the **three dots (⋮)** in the top right corner, and select **Manage Group**.
  </Step>

  <Step title="Navigate to administrators">
    Go to **Administrators** and click **Add Administrator**.
  </Step>

  <Step title="Select your bot">
    Find and select your unCoded bot from the member list (or right-click it).
  </Step>

  <Step title="Save">
    Confirm with **Save**.
  </Step>
</Steps>

<Tip>
  Normal administrator rights are sufficient. You do not need to enable or adjust any special permissions.
</Tip>

***

## Retrieve the Group Chat ID

<Steps>
  <Step title="Send the ID command">
    In the group chat, send:

    ```text theme={null}
    /id@my_id_bot
    ```
  </Step>

  <Step title="Copy the Group Chat ID">
    @my\_id\_bot replies with the **Group Chat ID** (a negative number, e.g., `-1001234567890`). Copy this value.
  </Step>
</Steps>

<Note>
  To find your own personal Telegram user ID, send a message to @my\_id\_bot in a private chat.
</Note>

***

## Add credentials to your server configuration

Enter the **Bot Token** and **Group Chat ID** in your unCoded server deployment configuration (via CapRover). Once applied and the bot restarts, Telegram notifications will be active.

***

## Once connected, Telegram is used only to receive notifications from unCoded.

Your Telegram group can receive real-time trade notifications for executed buy and sell actions. Telegram does not provide any external command interface, remote control functionality, or bot management features. You cannot use Telegram to trigger trades, change settings, manage licenses, or execute commands on the system.

***

For help or troubleshooting the Telegram setup, reach out to the unCoded Telegram community. See [Support & contact](/support/contact).