💌 Whisper Bot 💬

Send Anonymous messages and Whisper messages in Telegram app
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Roadmap
4. Contributing
5. License
6. Contact
7. Acknowledgements

(back to top)

About The Project

An efficient Telegram-bot for send Anonymous messages and Whisper messages in regular type or special type that can be hide content or send to user' PV

(back to top)

Built With

This section should list any major frameworks that you built your project using. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

• Python 3.7v
• Telegram-Bot Api
• Aiogram Framework
• Telethon Framework
• Redis

(back to top)

Getting Started

This is a help for installation.

Prerequisites

• Ubuntu 16.04+ (I prefer 16.04)
• You have to installed Python3.6 because Telethon need Python3.6. so follow helps on google for "install Python3.6 on ubuntu"
• Get API_HASH & API_ID at my.telegram.org
• Get Bot_Token from @Botfather
• send /setprivacy to @Botfather and click on your bot username then click on Disable
• send /setinline to @Botfather and click on your bot username then send a short message that show on inline queries
• send /setinlinefeedback to @Botfather and click on your bot username then click on Enabled
• Get Channel ID from Telegram with forwarding a message to @userinfobot use this ID for bot logs message
• Get Group(Supergroup type) ID from Telegram with adding @myidbot and send /getgroupid in group and take group ID. bot use this ID for Support messages

(back to top)

Installation

1. Clone the repo

   git clone https://github.com/ferisystem/WhisperBot.git

2. in config_bot.py you have to change these values:
   • Enter your database name

     db = 'name_database'

     note: is optional. but you must change it for each bot you launch
   • Enter your Bot_Token

     "botToken": "Bot_Token"

   • Enter your numbericID and other admins numbericID

     sudo_users = (777000, telegram_datas['botToken'].split(':')[0], numbericID2, 3, 4, 5, ...) # PUT_YOUR_ADMINS_HERE

     note: don't delete 777000, telegram_datas['botToken'].split(':')[0]
   • Enter your ID again as SUDO(full admin)

     "sudo_id": SUDO_ID,

   • Enter your channel username and invite-link

     "chUsername": "YOUR_CHANNEL_USERNAME", # for force join
     "chLink": "YOUR_CHANNEL_LINK", # for force join

   • Enter your server IP

     "ip": "YOUR_SERVER_IP",

3. Now you have to run this command for first time to take Bot_Token

   python3.6 cron_jobs.py

   then enter bot_token here
4. And then you have to add this command in crontab -e on ubuntu terminal

   * * * * * python3.6 ./WhisperBot/cron_jobs.py

5. you should install modules in docs/modules_python37.py with this command on WhisperBot folder:

python3.7 -m pip install -r docs/modules_python37.py

11. Now you can run your bot with screen for keep bot power on or without it on WhisperBot folder:

python3.7 bot_main.py

or

screen -S whisperbot python3.7 bot_main.py

12. If you want to power off the bot, you should kill that process after use screen command:

kill whisperbot

(back to top)

Roadmap

• Anti-save for special Whispers
• Delete all Whisper sent before
• Block user from recent list user
• Security-code for userIDs on reply-markups of Anonymous-Messages-Inbox
• Multi-language Support
  • Persian
  • English
  • Detusch

also you can see the open issues for a list of proposed features (and known issues).

(back to top)

Contributing

Dear programmer, you can help me in this project. how? read this text. Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a pull request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Alireza Fereidouni (Feri) - @ferisystem - alirezafereidouni@proton.me

Project Link: github.com/ferisystem/WhisperBot

Example Bot: @WhisAnoBot

(back to top)

Acknowledgements

• Iman Seyed

(back to top)