NACBots / BroadcastBot

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

Home Page:http://t.me/NACBots

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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

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

About

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

http://t.me/NACBots


Languages

Language:Python 99.8%Language:Procfile 0.2%