Telegram Shill Bot

Ever wanted a Shill Bot but wankers keep scamming for one OR wanted to charge you an arm and a leg?

This is a simple bot written in Python that you can use to shill (i.e. send messages) your token, or whatever, to Telegram channels.

There are a couple of runtime options available (one easy, one hard), so please read the entire doc. The easy runtime will most likely work (but not tested) on Windows, since it is ran via a Docker container.

Speaking Of Shilling

If you find this bot useful, please consider donating any token of value to our BSC wallet:
0xE75470B9a7c93038195ca116E342c42F6B3F758b. Just as an example, some paid shill bots cost ~$500.00, with few additional features.

Our goal is simple: to earn enough money to build a surf ranch business.

This project is free to everyone (except those wankers), and expect more kick ass projects soon!

You can ask us questions in:


This can cause your account to be rate limited and even banned if you shill too often. A safe wait_interval is typically around 900 seconds.


Obtain a Telegram API ID

Grab your api_id, api_hash, and app short name

telegram app config

Create a copy of settings.example.yml and name it settings.yml

Fill out the settings.yml with your app configuration details


api_id: 123456
api_hash: abc123xyz456
app_short_name: MyAwesomeShillBot

Fill out the settings.yml with the message(s) you want to shill

  one: |
    i can be whatever i want it to be
  two: |
    and so can i

Fill out the settings.yml with the channel(s) you want to shill, and how you want to shill them (i.e. what message you would like to send)

    message_type: one
    # ^^ this maps to a message "name" you created earlier
    wait_interval: 1800
    # ^^ this is in seconds
    message_type: two
    wait_interval: 900

Verify your YAML by copying all of settings.yml and paste it into

  • Fix any reported errors

Sign into the Telegram channels you plan to shill, using the account you plan to shill with

  • This should fix any CAPTCHA guards that may be in place



From Your Terminal

  • Run the Docker bot script

Not As Easy

From Your Terminal

  • Install Python packages
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  • Run the bot

Telegram Prompt

You will be prompted to enter your phone (or bot token) and the Telegram code you received - please fill it out.

telegram shill bot startup
telegram login code

Tested With

  • macOS Catalina v10.15.7
$ python --version
Python 3.7.5
$ pip --version
pip 19.2.3 from ... (python 3.7)
  • 3 unique Telegram channels
  • 3 unique messages


  • We welcome any contribution to the project (issues and PRs)
  • If you have any code to contribute, please follow the fork, branch, PR process


  • Solve join captchas:
  • Rose simple button click: Can use simple telethon
  • Alphabet captchas: Can use some optical character recognition
  • Sum of integers or logical operations: OCR, identify operator and perform the logic
  • Add some random message getter from list of messages vs hard mapping
  • Add some rate limiting aspect. Not sure what the limit ...
  • Maybe if possible have 1 app connect and keep session and channel logged in state. Then the other
    that does the shilling which interacts with first. The first stays connected at all times to avoid the JoinChannelRequest flood.
  • Account rotation to not get banned or rate limited ...
  • Add unit tests
  • UI maybe if we want to get fancy with this
  • Or use existing tg clients with something like pyautogui

shill, shillbot, shill bot
telegram, telegram shill, telegram shillbot, telegram shill bot


GitHub - surfranch/TelegramShillBot: A simple Telegram bot, written in Python, that you can use to shill (i.e. send messages) your token, or whatever, to channels.
A simple Telegram bot, written in Python, that you can use to shill (i.e. send messages) your token, or whatever, to channels. - GitHub - surfranch/TelegramShillBot: A simple Telegram bot, written ...