xenon-exe-bot
A 24/7 Telegram automation bot that broadcasts your messages to contacts, non-contacts, and groups — deployed on Render, kept alive by UptimeRobot.
Features
Everything you need to broadcast at scale, with safety nets built in.
24/7 Uptime
Flask /health endpoint designed for UptimeRobot cron pings. Never sleeps.
Session String Auth
No interactive login — runs headless from an environment variable.
Bulk Broadcasting
Send one message to unlimited targets, sequentially, with built-in delays.
Non-Contact Support
Resolves phone numbers via ImportContactsRequest, sends, then cleans up.
FloodWait Handling
Automatically waits and retries when Telegram rate-limits your account.
PeerFlood Guard
Stops the broadcast if your account is temporarily limited, then reports back.
Usage
Send one command to your own Saved Messages and the bot fans it out.
# Broadcast to a username and a group
/send @friend_username, -1001234567890 | Hello everyone! 👋
# Broadcast to a non-contact by phone number
/send +1234567890 | Hey, long time no see!
# Mixed list — usernames, phone numbers, and group IDs
/send @alice, +15551234567, -1009876543210 | Big announcement coming...Tech Stack
Built on battle-tested tools and deployed on free-tier infrastructure.
Roadmap
What's coming next. PRs welcome.
- Core broadcasting engine
- FloodWait + PeerFlood handling
- Non-contact resolution via phone
- CSV upload of targets
- Scheduled broadcasts (cron-based)
- Media support (images, videos, files)
- Per-target delivery log in SQLite
- Web UI for target management
- Retry queue for failed sends
Recent Commits
Every change to this repo, pulled live from GitHub.
Loading commits…