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

# Telegram bot

## **Features**

* The [**Telegram bot**](https://t.me/TwitterScore_bot) provides quick access to TwitterScore metrics directly in your Telegram chat, with a link to view detailed account data.
* You can configure it to work either as an **auto-reply** or via the **/score** command.
* You can also add your **referral link** to earn **25% cashback** from users in your chat who purchase a subscription.

<figure><picture><source srcset="/files/lUY1RrAnIblOz8mRfYfy" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2FzEB8Rr10SNgNCNjeE6tH%2Ftwitterscorebotll.png?alt=media&amp;token=56e18098-6487-4188-93a7-2ce426dadcdd" alt=""></picture><figcaption></figcaption></figure>

## **How It Works**

By default, the bot will automatically respond to **any message containing a X (ex. Twitter) link**.\
If there are multiple links in the message, it will return scores for all of them.

<figure><picture><source srcset="/files/xbFFXPEdKHQmO0HPIbce" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2FoHccLnsva7JgOTQYRFtx%2Fmultybotdark.png?alt=media&amp;token=951dc659-a6ad-4e6f-8bf2-73df1b615bc0" alt=""></picture><figcaption></figcaption></figure>

You can **disable auto-replies** in the bot settings:\
Go to **My Chats**, then uncheck the group.

<figure><picture><source srcset="/files/svSLdzlpZpazC7vM45dY" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2F80ojKVu5ozQrueqwP1KJ%2Fchatlight.png?alt=media&amp;token=6ae1d2cf-3d39-4354-bd8b-3d4d5c3933fb" alt=""></picture><figcaption></figcaption></figure>

In this case, the bot will only respond to commands like:

/score @Lighter\_xyz\
/score Lighter\_xyz\
/score <https://x.com/Lighter\\_xyz\\>
/score <https://x.com/Lighter\\_xyz/status/1917483111782441297>

You can also reply to any message that contains a Twitter link with just **/score**&#x20;

## **How to Add the Bot to Your Chat**

* Open the bot <https://t.me/TwitterScore_bot> and click **Start**
* Click **Add to Group**

<figure><picture><source srcset="/files/jkMT8AM88jyyr1FBHwmi" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2Fdu7XjUUCnmcHSbQ9l6hD%2FScreenshot%202025-05-08%20at%2000.56.54.png?alt=media&amp;token=c9e1f592-e26a-4c78-9d13-d8ecc344f251" alt=""></picture><figcaption></figcaption></figure>

* Choose the group you want to add it to

<figure><picture><source srcset="/files/6RFQf02sg7uxTIExjzdg" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2FqaXt4hyeftb9iqdiCCwz%2FScreenshot%202025-05-08%20at%2001.03.14.png?alt=media&amp;token=f2f76ec8-a88f-4ee9-82a0-56a0b9afa59c" alt=""></picture><figcaption></figcaption></figure>

* Make the bot an **admin** — all other permissions could be disabled

<figure><picture><source srcset="/files/rUFsS1AHCvujQwIyBUdm" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2Fjk71KHKVByyXe15936CT%2FScreenshot%202025-05-08%20at%2001.07.15.png?alt=media&amp;token=5bbc08bd-9b81-4fa3-a98b-61317ef753e4" alt=""></picture><figcaption></figcaption></figure>

## **Add Your Referral Link**

* Create an account at <https://twitterscore.io>
* Go to the [**Subscription**](https://twitterscore.io/subscription/) tab in your profile

<figure><picture><source srcset="/files/UqeyK0Jb1I8Ecje35MAm" media="(prefers-color-scheme: dark)"><img src="https://1379962736-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMbgnsG03rlnGjfGWrRbE%2Fuploads%2FxvCjkHyCsqlYQRaB12G1%2FScreenshot%202025-05-08%20at%2000.53.56.png?alt=media&amp;token=b22ed652-d70f-43c5-9429-bb087155c719" alt=""></picture><figcaption></figcaption></figure>

* Copy your **referral link**
* Return to the [bot](https://t.me/TwitterScore_bot) and click **Add Referral Link**
* Send the link to the bot

🎉 That’s it! The bot is now active, and you’ll receive **25% cashback** from every user who joins and purchases a Pro subscription via your link.
