---

✦ What Is Quick ID Bot?

Quick ID Bot (@useridroxybot) is a blazing-fast, feature-packed Telegram bot built by RoxyBasicNeedBot using Python, Pyrogram, and MongoDB Atlas. It lets anyone instantly look up User IDs, Group IDs, and Channel IDs — whether public or private — with a single tap or command.

Why do you need it?

• 🧑‍💻 Developers — need user/chat IDs to configure bots and APIs
• 🛡️ Admins — whitelist or blacklist users by their numeric ID
• ⚡ Power users — reveal who's behind any @username
• 📡 Group managers — get channel IDs to connect bots instantly

No sign-up. No waiting. Just results. ⚡

---

🌟 Full Feature Overview

	Feature	Description
🆔	User ID Lookup	Find any user's Telegram numeric ID instantly via @username or by forwarding their message — works even for hidden profiles
💬	Group & Channel ID	Retrieve IDs for public and private groups, supergroups, and broadcast channels with full metadata
📨	Smart Forward Detection	Forward any message from a user, group, or channel — the bot auto-extracts full info with one tap
⚡	Inline Query Mode	Type @useridroxybot @username in any Telegram chat without opening a DM — instant results anywhere
📢	Admin Broadcast System	Push announcements to every registered user at once with delivery statistics
📊	Live MongoDB Statistics	Real-time dashboard of total users, active sessions, growth metrics, and database health
🚫	Full Moderation Suite	Ban / unban users from accessing the bot with a persistent banned-users registry
🔒	Force Subscribe Gate	Lock all bot features behind a Telegram channel subscription — configurable via .env
🏓	Ping & Auto-Reactions	Check latency in ms, get auto emoji reactions on messages, and restart the bot remotely
🛡️	Tiered Access Control	Separate command sets for regular users vs admins — secure by design
🐳	Multi-Platform Deploy	Docker, Heroku Procfile, Leapcell.io config, and manual scripts out of the box
🔄	Remote Restart	Admins can restart the bot via Telegram without touching the server

---

🤖 Commands Reference

👤 User Commands

Command	Description
🚀 /start	Launch the bot, register your account, and open the interactive main menu
ℹ️ /help	Display all available commands and the full usage guide with examples
🆔 /id @username	Get full details for any user — numeric ID, display name, premium status, bot flag
📡 /ping	Check bot latency and server response time in milliseconds

🛡️ Admin-Only Commands

Command	Description
📈 /stats · /statistics	View total registered users, active sessions, and real-time database stats
📢 /broadcast · /bcast	Send a message to every registered user simultaneously with delivery reports
🚫 /ban	Ban a user — blocks all access to the bot immediately
✅ /unban	Unban a user — restores their full access
📋 /banned	Show the complete list of currently banned users
🔄 /restart	Remotely restart the bot process without touching the server

⚡ Inline Mode: Type @useridroxybot in any chat — no DM needed!

---

🏗️ Architecture Overview

👤 Telegram User
       │
       ▼  (MTProto Protocol)
   ✈️  Telegram API  (my.telegram.org)
       │
       ▼
   ⚡ Pyrogram Async Engine  (Python 3.10+)
       ├──→  🗂️  Command Router        (/start /help /id /ping …)
       ├──→  📨  Forward Handler        (auto-detect user/group/channel)
       ├──→  🔍  Inline Query Handler   (@useridroxybot anywhere)
       ├──→  🔘  Callback Handler       (button interactions)
       ├──→  🛡️  Admin Gate            (broadcast / ban / stats / restart)
       └──→  🔒  Force Subscribe Check  (channel gate)
              │
              ▼
       🍃  MongoDB Atlas
              ├── users collection      (IDs, names, join date, activity)
              └── activity tracking    (sessions, stats, growth)
              │
       🚀  Cloud Deployment
              ├── Leapcell.io (recommended)
              ├── Docker (Dockerfile included)
              └── Heroku (Procfile included)

---

📁 Project Structure

📦 -Telegram-ID-User-Info-Quick-ID-Bot/
│
├── 🤖 bot.py                          ← Main entry point & bot runner
├── ⚙️  config.py                       ← Environment config loader
├── 🔧 new.py                           ← Standalone quick-ID utility script
├── 🐳 Dockerfile                       ← Docker container definition
├── 📋 Procfile                         ← Heroku deployment config
├── 🚀 start.sh                         ← Production start script
├── 🔨 build.sh                         ← Build & dependency script
├── 📜 LICENSE                          ← MIT License
│
└── 📂 ROXYBASICNEEDBOT/
    ├── 📂 commands/
    │   ├── start.py                    ← /start + welcome UI + force-sub
    │   ├── help.py                     ← /help command + usage guide
    │   ├── user_info.py                ← /id @username — core feature
    │   ├── admin.py                    ← /broadcast system + delivery stats
    │   ├── stats_command.py            ← /stats real-time dashboard
    │   ├── moderation.py               ← /ban /unban /banned
    │   └── utility.py                  ← /ping /restart
    │
    ├── 📂 handlers/
    │   └── callbacks.py                ← Inline queries + button callbacks
    │
    ├── 📂 database/
    │   └── mongodb.py                  ← MongoDB Atlas — all DB operations
    │
    └── 📂 utils/
        ├── message_handlers.py         ← Forwarded message auto-parser
        ├── force_sub.py                ← Channel subscription gate
        ├── reactions.py                ← Auto emoji reaction engine
        └── ui_helpers.py              ← Message formatting & UI helpers

---

🚀 Setup & Deployment

1️⃣ Clone the Repository

git clone https://github.com/RoxyBasicNeedBot/-Telegram-ID-User-Info-Quick-ID-Bot.git
cd -Telegram-ID-User-Info-Quick-ID-Bot

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Configure Environment Variables

# ──────────────────────────────────────────────────
#  🤖 RoxyBasicNeedBot — Quick ID Bot — .env Config
# ──────────────────────────────────────────────────

API_ID=your_api_id_here          # → https://my.telegram.org
API_HASH=your_api_hash_here      # → https://my.telegram.org
BOT_TOKEN=your_bot_token_here    # → @BotFather on Telegram

MONGODB_URL=your_mongodb_url     # → MongoDB Atlas connection string
DB_NAME=roxybot_db               # → Your database name
USERS_COLLECTION=users           # → Collection name

ADMIN_IDS=123456789,987654321    # → Comma-separated Telegram user IDs
FORCE_SUB_CHANNEL=@yourchannel  # → Optional: lock behind channel sub

4️⃣ Run Locally

python bot.py

---

☁️ Deploy to Leapcell.io

#	Step	Details
🍴	Fork this repo	Click Fork on GitHub → your account
🏗️	Create project	Go to Leapcell.io → New Project
🔗	Connect GitHub	Link your forked repository
⚙️	Set commands	Build: bash build.sh · Start: bash start.sh
🔑	Add env vars	Paste all variables from your .env file
🚀	Deploy!	Hit Deploy — your bot goes live in seconds 🎉

✅ Also supports Docker (Dockerfile) and Heroku (Procfile) out of the box.

---

📊 GitHub Stats

---

🌐 Creator & Links

𝕽𝕺𝕏𝖄 • 𝔹𝕒𝕤𝕚𝕔ℕ𝕖𝕖𝕕𝔹𝕠𝕥 ⚡

Bot & Website Developer • Python • Pyrogram • APIs • Automation

---

🎯 Try It Right Now!

100% Free — No sign-up — Works instantly in seconds
Try /id @username right now and get results in under 1 second ⚡

---

📄 License

This project is licensed under the MIT License — see LICENSE for full details.

---

© 2026 RoxyBasicNeedBot. All Rights Reserved.