> 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="/files/pqgmba86E3vxNpwWPLvA" 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="/files/XPU23CijVdvGoKK9c09m" 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="/files/2vpewir5ALeyyoimXSKb" 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="/files/LcVu7TDJ4EGtiiaKxBOH" 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="/files/0Ia7NXBYuBAY0BHG7h1A" 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="/files/B3hQgAVE9knE37e9GCUZ" 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="/files/yAjoCrbQVczuSikJFAm4" 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.
