> For the complete documentation index, see [llms.txt](https://docs.guild.xyz/guild/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guild.xyz/guild/how-to-setup-rewards/telegram-group.md).

# Telegram group

Grant access to private Telegram groups automatically when members meet requirements. Perfect for gated communities, VIP channels, and holder-only discussions.

#### **Setting up Telegram group/channel rewards:**

* In the role editor, click **"Add reward"** and select **Telegram**
* Click **"Add bot to group or channel"** and select your group/channel 
* Add the Guild bot as an admin (don't change permissions)
* Once added, the Guild bot will send a message within the group with the **Group ID**
* Copy the **Group ID** of your Telegram group and paste it on Guild
* Click **"Add reward"**

\*You can add @guildxyz\_bot to your group directly on Telegram as well.

{% hint style="info" %}
The Guild bot must have admin permissions in your Telegram group to automatically add and remove members.
{% endhint %}

#### How Telegram group rewards work for members

* Members see the Telegram group reward but cannot join until they meet role requirements
* Once qualified, members click **"Join group"** to get automatic access to the group
* Access is granted immediately through the Guild bot
* If members lose role access, they are automatically removed from the Telegram group

#### Requirements for setup

* You must be an admin of the Telegram group or channel you want to gate
* The Guild bot must be added as an admin with proper permissions
* Your Telegram group must be set to **"Private"** (you can change this in your group settings under Group Type)

#### Bot commands for group management

You can use these commands in groups (channels have limited command visibility):

* **/start** - Welcome message with Group ID and instructions 
* **/help** - View documentation and support links
* **/status** - Check group status and configuration

#### Channel limitations

When using Telegram channels as rewards:

* **No command menu** - When you type "/", the command list won't appear automatically; you have to type /start /help or /status and hit enter
* **Bot must be admin** - The bot needs admin permissions with "Post messages" enabled
* **Setup required** - Make sure to add the bot through the "Add bot to channel" link, not the group link

#### Important notes

* The Guild bot (@guildxyz\_bot) handles both Telegram requirements and rewards
* If you previously used separate bots, they have been unified into @guildxyz\_bot
* The bot automatically manages member access based on role requirements - no manual intervention needed
* Group ID is automatically provided in the welcome message when you add the bot
* The bot status check verifies that your group is set to private and has proper permissions configured


---

# 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://docs.guild.xyz/guild/how-to-setup-rewards/telegram-group.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.