Skip to content

Latest commit

 

History

History
92 lines (63 loc) · 3.98 KB

README.md

File metadata and controls

92 lines (63 loc) · 3.98 KB
Raw

Whisper Bot

GitHub Repo stars GitHub issues GitHub pull requests GitHub contributors GitHub forks

Whisper Bot: Send secret, encrypted messages in Telegram groups via inline mode. Easy-to-use, supports private messaging without being part of the group.

Features

  • 🌐 Inline Mode Support: Send whisper messages without adding the bot to a group.
  • 💬 Secret Messaging: Messages are only visible to the sender and the intended recipient.
  • 🔄 Help and Back Button: Easily access the help menu and navigate back with built-in buttons.
  • 📎 User-Friendly: Simply use the bot in the inline mode to send private messages easily.

Requirements

Before you begin, ensure you have met the following requirements:

  • Python 3.8 or higher.
  • pyrofork library.
  • A Telegram bot token (you can get one from @BotFather on Telegram).
  • API ID and Hash: You can get these by creating an application on my.telegram.org.

Installation

To install pyrofork run the following command:

pip install pyrofork

Note: If you previously installed pyrogram, uninstall it before installing pyrofork.

Configuration

  1. Open the config.py file in your favorite text editor.
  2. Replace the placeholders for API_ID, API_HASH, and BOT_USERNAME with your actual values:

How to Set Up Inline Mode

To enable inline mode for your bot, follow these steps:

  • Open a chat with BotFather in Telegram.
  • Send the command /setinline to BotFather.
  • Choose the bot for which you want to enable inline mode.
  • After that, send a sample text like: Hi or Hello.

For more information on inline bots, refer to the Telegram Bot Documentation.

Deploy the Bot

git clone https://github.com/bisnuray/WhisperBot
cd WhisperBot
python whisper.py

Bot Commands

  • /start: Sends a welcome message with instructions on how to use the bot.
  • Inline Query: Use @LockTextBot your message @username in an inline query to send a whisper message. @LockTextBot Example Bot use your own bot.

How to Use

  1. Inline Mode:
    • Use the bot in inline mode by typing @LockTextBot <your whisper> @<recipient_username> or userid.
    • For example: @LockTextBot hello this is a test messages @BisnuRay.
    • Only the sender and the recipient will be able to view the secret message.

Note

  • User ID Restriction: If a user has not started the bot, you will not be able to send secret messages to them using their user ID. Ensure that the recipient has interacted with the bot at least once by clicking Start.

Author

✨ Note: If you found this repo helpful, please fork and star it. Also, feel free to share with proper credit!