> 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.


---

# 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:

```
GET https://twitterscore.gitbook.io/twitterscore/twitterscore-features/telegram-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
