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

# Telegram

**Time to complete** : 10-20 minutes (*est*)

### Gated Chat Basics:

tldr; we are assigning roles based on wallet holdings and channels are gated by these roles.

You will interface with a dashboard or bot where you will set the gate parameters. You will connect your Telegram to the bot or dashboard for authentication. Some allow you to set “and” permissions, meaning a person must hold X NFT **and** 3000 CREA tokens. Some allow for “or” permissions. Gated channels can be text or voice.

#### **What you will need**

* A Telegram group
* Token contract addresses and token IDs for NFTs
* A bot for gating

#### Why?

Create private chats that require a token balance to join. These chats can be for your biggest holders, most involved community members, or your whole token crew. Share private videos, content, and future plans.

## Gate Requirement Recommendations:

Having a general requirement to view all or most channels can help with eliminating bot accounts and bad actors while creating exclusivity for your whole community. Setting a second requirement and role can create more exclusivity for your biggest holders. We recommend determining exclusivity using your dashboard to filter various percentage groups of holders.

<table><thead><tr><th width="141">Ranking</th><th width="123">Percentile</th><th width="146">Reward Size</th><th>Reward Level</th></tr></thead><tbody><tr><td>Top 10%</td><td>90th</td><td>XL</td><td>Exclusive</td></tr><tr><td>Top 25%</td><td>75th</td><td>L</td><td>VIP</td></tr><tr><td>Top 50%</td><td>50th</td><td>M</td><td>Preferred</td></tr><tr><td>Top 75%</td><td>25th</td><td>S</td><td>Select</td></tr><tr><td>Top 90%</td><td>10th</td><td>XS</td><td>General Admission</td></tr></tbody></table>

\**Err on the side of having more people able to join and create exclusivity as needed.*

#### Creating Groups and Getting Started

1. Create chat

* ***iOS**:*
  * Start a new message (tap the icon in the top right corner in Chats) > 'New Group'.
* ***Android**:*
  * Tap the circular pencil icon in the chat list > 'New Group'.
* ***Telegram Desktop**:*
  * Click the menu button in the top left corner > 'New Group'.

2. Name it, add a picture, and click Create

![](/files/IuMCrK8WVX8DP8ESrSjw)

Set Chat History viewable by all

3. Tap or click the chats “…”
4. Select info
5. Select Edit
6. Tap Chat History for New Members
7. Make Visible
8. Add bots and set permissions

## How to Pick a Bot:

[Collabland](/token-integrations-guide/communication/gating-tools-and-bots/collabland/collabland-telegram.md) is an easy to implement bot, that can work with additional plugins for more features, perfect as you grow. [Guild](/token-integrations-guide/communication/gating-tools-and-bots/guild/guild-telegram.md) is an in depth community building tool that can can aid in POAP distribution. Personal preference, additional integrations, and how much detail and control you need will guide you in your decision.