> For the complete documentation index, see [llms.txt](https://docs.uncoded.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uncoded.ch/optional-settings/set-up-telegram-for-uncoded.md).

# Set Up Telegram for unCoded

{% hint style="info" %}
All steps in this documentation assume you are using the **Telegram desktop or mobile client** (Windows, iOS, Android).
{% endhint %}

***

{% stepper %}
{% step %}

### **Create a new Bot via BotFather**

* Open a chat with [<mark style="color:$warning;">@BotFather</mark>](https://t.me/BotFather) on Telegram.
* Send the command:

  ```
  /newbot  
  ```
* Follow the prompts to choose a <mark style="color:purple;">**name**</mark> and <mark style="color:purple;">**username**</mark> for your bot.
* Once complete, you will receive the <mark style="color:purple;">**Bot Token**</mark>, which you will later add to your server configuration.

<figure><img src="/files/E0i14e5WmxZ7wWhAA1yN" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

### Create a Group and Add the Bot

To link unCoded with Telegram, you need a dedicated group.

**How to create the group:**

* Open the Telegram **desktop or mobile client**.
* Click on the <mark style="color:purple;">**menu icon**</mark>**&#x20;(three horizontal lines)** in the top left corner.

<figure><img src="/files/Dh0jqSVmHuCu8m3ozZVl" alt="" width="344"><figcaption></figcaption></figure>

* Select <mark style="color:purple;">**New Group**</mark>.

<figure><img src="/files/jTuR0xRgLRr7rWhBxtfK" alt="" width="323"><figcaption></figcaption></figure>

* Give the group a <mark style="color:purple;">**name**</mark> (e.g., `unCoded Trading`).

<figure><img src="/files/E3hbePqAuSrJJQ4ishGi" alt="" width="375"><figcaption></figcaption></figure>

* When asked to <mark style="color:purple;">**add participants**</mark>, immediately add:

  * Your newly created <mark style="color:purple;">**Telegram bot**</mark> (from BotFather).

  <figure><img src="/files/r2cJSrocBRoMyt96zsIA" alt="" width="375"><figcaption></figcaption></figure>

  * The helper bot <mark style="color:purple;">**@myidbot**</mark>.

{% hint style="info" %}
You will also be a member of the group automatically.
{% endhint %}

<figure><img src="/files/rA6EarQbFLMHWGDK0Xsl" alt=""><figcaption></figcaption></figure>

* Save the setting.

***

{% endstep %}

{% step %}

### 👷 Give Your Bot Administrator Rights

{% hint style="info" %}
Depending on the Telegram version you are using (Windows, web, mobile, etc.), this process may vary. If you need help, feel free to contact our [<mark style="color:$warning;">support on Telegram</mark>](https://bit.ly/AuV-Telegram).
{% endhint %}

For the bot to function properly in the group, it must be set as an **Administrator**.

**Steps:**

* Open your new group.
* Click on the <mark style="color:purple;">**three dots**</mark>**&#x20;(⋮)** in the top right corner and select <mark style="color:purple;">**Manage Group**</mark>.

<figure><img src="/files/2TCBgvNb4NBXRjX3qZTw" alt=""><figcaption></figcaption></figure>

* Go to <mark style="color:purple;">**Administrators**</mark>.

<figure><img src="/files/S7C0QR8dhJa49V5i4t8Z" alt="" width="375"><figcaption></figcaption></figure>

* Click <mark style="color:purple;">**Add Administrator**</mark>**.**

<figure><img src="/files/C7Cbtm5U5z9gmfrJ3MdW" alt="" width="375"><figcaption></figcaption></figure>

* Select your <mark style="color:purple;">**unCoded Bot**</mark> (Or Right-Click it).

<figure><img src="/files/NLixFN2du9hPH5Pow9gM" alt="" width="375"><figcaption></figcaption></figure>

* Confirm with <mark style="color:purple;">**Save**</mark>.

<figure><img src="/files/vCgBM2GN7JSzkEnsSrVV" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
💡 Normal administrator rights are sufficient. You don’t need to enable or adjust any special permissions.
{% endhint %}

***

{% endstep %}

{% step %}

### 🧑🏻‍🤝‍🧑🏻 **Retrieve the Group Chat ID**

* In the group chat, send:

  ```
  /getgroupid@myidbot 
  ```

<figure><img src="/files/muNs2AprsCBQlUjIDZA2" alt=""><figcaption></figcaption></figure>

* @myidbot will reply:
  1. <mark style="color:purple;">**Group ID**</mark> (e.g., `-1001234567890`)
     {% endstep %}
     {% endstepper %}

{% hint style="info" %}
To get your own user ID, send `/getid` in a private chat with the bot. **Lets move on with the next step!**
{% endhint %}
