/BroadcastBot

A simple Telegram bot that can broadcast messages and media to the bot subscribers. with mongo DB support

Primary LanguagePython

𝘽𝙧𝙤𝙖𝙙𝙘𝙖𝙨𝙩 𝘽𝙤𝙩

A simple Telegram bot that can broadcast messages and media to the bot subscribers using MongoDB.

Readme Card

Features

  • Support mongodb.com database 📁 for user's record 📹.

  • User's can choose whether to enable Broadcast messages or not using /settings commands.
  • Logs New User's in any channel.
  • Get total user's count in Database.
  • Ban and UnBan any user.

Required Configs

  • BOT_TOKEN - Get from @BotFather
  • API_ID - Get it from telegram.org
  • API_HASH - Get it from telegram.org
  • AUTH_USERS - Authorised user's ID to use Admin Commands {Split 💔 with a space}.
  • DB_URL - MongoDB Database URI get it from mongodb.com
    • This for Saving UserIDs. When you will Broadcast, bot will forward the Broadcast to DB Users.

Optional Configs

  • LOG_CHANNEL - Log Channel ID to get new user notifications.
    • This for some getting user info. If any new User added to DB, Bot will send Log to that Logs Channel. You can use same DB Channel ID.
  • BROADCAST_AS_COPY - Value should be True or False.
    • If True broadcast messages will be forwarder As Copy. If False broadcast messages will be forwarded with Forward Tag.
  • DB_NAME - mongodb.com Collection name to be used.

User's Commands 😉

start - Start the bot 🥲
settings - Customise settings

Admin Commands 🤫

stats - Total User Number in Database
broadcast - Reply to Message to Broadcast
ban_user - Ban A User with time & reason
unban_user - Unban a User
banned_users - Show Banned Users

Deploy 🚀

Easiest Heroku Deploy 🤭

herokudeploy-01

Host Locally 🤕

git clone https://github.com/nacbots/BroadcastBot
cd BroadcastBot
pip3 install -r requirements.txt
# EDIT config.py values appropriately
python3 main.py

Support Group:

Found a Bug 🐛

Feel free to create a pull or create a issue now and describe your issue freely.

Credits

pyrogram