π˜½π™§π™€π™–π™™π™˜π™–π™¨π™© π˜½π™€π™©

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
  • 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.
  • 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

  • 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 appropriatelypython3 main.py

Support Group:

Found a Bug
πŸ›

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

381823

GitHub

https://github.com/nacbots/BroadcastBot