Telegram Moderation & Anti‑Spam Bot for Groups
I need an experienced Telegram bot developer to build a reliable moderation and anti‑spam bot for Telegram groups. The bot should automatically detect spam, make basic admin actions easier, and help keep communities clean with minimal manual work.
Core moderation features
Spam & flood protection
Detect and auto-delete obvious spam messages (mass mentions, repeated messages, suspicious links, etc.).
Optional flood control: limit number of messages per user in a short time; warn or mute on abuse.
Link / keyword filtering
Ability to block messages with specific keywords or domains (configurable list).
Option to allow admins to manage this list via commands (add/remove keywords).
Basic admin tools
Commands for admins, for example:
/warn @user [reason] – increase warning count and notify user.
/mute @user [time] – temporarily mute a user.
/ban @user [reason] – ban a user from the group.
/unmute, /unban where applicable.
Automatic actions when a user hits a warning limit (e.g. auto-mute or auto-ban after X warnings).
New member protection (optional but preferred)
Option to apply simple verification for new members (e.g. have to press a button within X seconds, or answer a simple challenge) to block bots.
Auto-remove new accounts that instantly post links/spam.
Admin‑only settings
/settings command that only group admins can use to see and adjust core options (sensitivity, max warnings, flood limits, etc.).
Respect Telegram permissions: only treat real Telegram admins as admins.
Behavior & quality
The bot must work correctly in large groups.
Respect Telegram API limits and avoid spamming the group.
Clear, short messages when it takes actions (for example: “User muted for 10 minutes – reason: spam links”).
Fail safely: if something goes wrong, it should not crash the whole bot process.
Technical requirements
Language: Python (preferred, e.g. python‑telegram‑bot or Aiogram) or Node.js (e.g. Telegraf).
Use environment variables or config file for bot token and secrets (no hardcoding).
Clean project structure (separate modules for handlers, config, utils).
If you use a database (for warnings, mutes, etc.), please choose something simple (SQLite/PostgreSQL) and document setup.
Configuration & usage
Simple way to configure:
Config file (YAML/JSON) for default settings (limits, actions, messages, blocked words/domains).
Provide a short usage guide with the list of all commands for admins and normal users.
Deliverables
Full source code of the bot.
Configuration file(s) with example values.
README with setup and deployment steps.
Short command/feature list so I can easily understand how to use the bot.
What to include in your application
Brief description of your experience with Telegram moderation or anti‑spam bots.
1–3 examples (links to GitHub repos or existing bots you’ve built).
Tech stack you will use (Python/Node.js, main libraries, database if any).
Your fixed price and estimated delivery time.