Skip to content

README.md

Latest commit

 

History

History
123 lines (86 loc) · 3.21 KB

README.md

File metadata and controls

123 lines (86 loc) · 3.21 KB

🤖 Telgram recurring message Bot

A Pyrogram-based Telegram bot that automatically sends recurring reminder messages (with an image and buttons) to your Telegram group — perfect for project updates, marketing reminders, or community engagement!

🌟 Features

  • 🕐 Automatic hourly reminders (you can modify the interval)
  • 🖼️ Sends reminders with images and custom captions
  • 🔗 Inline buttons for quick access to your links (Website, Twitter, Discord, etc.)
  • 🔁 Automatically deletes the previous message before sending a new one
  • 🧑‍💻 Includes admin-only control commands
  • ⚙️ Easy setup — just plug in your tokens and group ID

🧩 Requirements

Install dependencies:

pip install pyrogram tgcrypto

⚙️ Setup

  1. Clone this repository

    git clone https://github.com/yourusername/vtrading-reminder-bot.git
cd vtrading-reminder-bot

  2. Edit main.py Fill in the following values:

    API_ID = 123456                # Your Telegram API ID
API_HASH = "your_api_hash"     # Your Telegram API Hash
BOT_TOKEN = "your_bot_token"   # Telegram Bot Token from @BotFather
VTRADING_CHAT_ID = -100123456789  # Your group chat ID
REMINDER_IMAGE_URL = "https://your-image-link.com/image.jpg"

  3. Customize your message & buttons

    REMINDER_MESSAGE = "🔥 Don’t miss out on the latest VTrading updates! 🚀"
REMINDER_BUTTONS = InlineKeyboardMarkup([
    [InlineKeyboardButton("🌐 Website", url="https://example.com")],
    [InlineKeyboardButton("𝕏 Twitter", url="https://twitter.com/yourpage"),
     InlineKeyboardButton("💬 Discord", url="https://discord.gg/yourserver")],
    [InlineKeyboardButton("🔗 Linktree", url="https://linktr.ee/yourpage")]
])

  4. Run the bot

    python main.py

🧠 Commands

Command Access Description
/start_reminder Admin Only Starts the hourly reminder loop
!id Group Displays the current chat ID
/start Private Confirms bot is active

💡 Example Output

Sample Reminder Message:

🔥 Don’t miss out on the latest VTrading updates!
Stay connected and earn rewards with every trade 🚀

🌐 Website • 💬 Discord • 𝕏 Twitter

🧰 Advanced Usage

  • 🕑 Change reminder interval
    Modify the line:

    await asyncio.sleep(3600)  # 3600 = 1 hour

    to your preferred time in seconds (e.g., 1800 for 30 minutes).

  • 🔒 Limit /start_reminder access
    Change the user ID in:

    @app.on_message(filters.command("start_reminder") & filters.user(5906045989))

    to your own Telegram user ID.

🧑‍💻 Author

Chiran
💬 Telegram: @MCX79

🪪 License

This project is licensed under the MIT License — feel free to use and modify it for your own projects.

⭐ Star this repo if you found it helpful!