<h2 class="heading-node">🧩 Overview</h2>We’re looking for a developer to build a Telegram onboarding bot for Superteam.The bot will help onboard new members by:<ul class="list-node"><li>Redirecting them to an Intro Channel</li><li>Enforcing a standard introduction format</li><li>Preventing participation in the main group until an intro is completed </li></ul>This bot will be used in a real, active Web3 community, not a demo.<hr><h2 class="heading-node">🎯 Objective</h2>Create a Telegram bot that ensures every new member introduces themselves properly before engaging in the main group — improving context, collaboration, and community quality.<hr><h2 class="heading-node">🤖 Core Requirements</h2><h3 class="heading-node">1️⃣ New Member Detection</h3><ul class="list-node"><li>Detect when a user joins the Telegram group</li><li>Automatically send a welcome message (DM or in-group)</li></ul><hr><h3 class="heading-node">2️⃣ Intro Guidance Message</h3>The bot should send (or closely mirror) the following message:👋 Welcome to Superteam MY! To get started, please introduce yourself in this format 👇This helps everyone get context and makes collaboration easier. Intro format:• Who are you &amp; what do you do?• Where are you based?• One fun fact about you• How are you looking to contribute to Superteam MY?No pressure to be perfect — just be you!<hr><h3 class="heading-node">3️⃣ Intro Completion Logic</h3><ul class="list-node"><li>Bot checks if the user has posted at least one message in the Intro Channel</li><li>Optional (bonus): Heuristic validation that the intro roughly follows the format</li><li>Once completed, mark the user as “introduced”</li></ul><hr><h3 class="heading-node">4️⃣ Access Control</h3>Before intro is completed:<ul class="list-node"><li>User cannot send messages in the main group OR</li><li>Bot auto-deletes their messages and reminds them to introduce themselves</li></ul>After intro:<ul class="list-node"><li>User can participate normally</li></ul><hr><h3 class="heading-node">5️⃣ Example Intro Reference</h3>Bot should include or reference this example (message, pinned post, or command):✨ Example introHey everyone! I’m Marianne 👋&nbsp;&nbsp;Together with Han, we are Co-Leads of Superteam Malaysia!📍 Based in Kuala Lumpur and Network School&nbsp;&nbsp;🧑‍🎓 Fun fact: My first Solana project was building an AI Telegram trading bot, and that's how I found myself in Superteam MY!&nbsp;&nbsp;🤝 Looking to contribute by:• Connecting builders with the right mentors, partners, and opportunities&nbsp;&nbsp;• Helping teams refine their story, demos, and go-to-market&nbsp;&nbsp;• Supporting members who want to go from “building quietly” → “shipping publicly”Excited to build alongside all of you — feel free to reach out anytime 🙌<hr><h2 class="heading-node">🧪 Technical Expectations</h2><ul class="list-node"><li>Language: Node.js (Telegraf) or Python (python-telegram-bot)</li><li>Clean, readable, maintainable code</li><li>Easy deployment (Docker or clear setup guide preferred)</li><li>Basic error handling</li></ul><hr><h2 class="heading-node">✨ Bonus Features (Optional)</h2><ul class="list-node"><li>Admin commands:<ul class="list-node"><li>Reset intro status</li><li>Manually approve users </li></ul></li><li>Persistent storage (DB or lightweight file)</li><li>Configurable intro format via config</li><li>Auto-pin intro message</li><li>Graceful handling of edge cases (leave &amp; rejoin, deleted intro)</li></ul><hr><h2 class="heading-node">📦 Deliverables</h2><ul class="list-node"><li>Working Telegram bot</li><li>GitHub repository</li><li>Setup / deployment instructions</li><li>Short demo (Loom video or test group)</li></ul><hr><h2 class="heading-node">💰 Reward</h2><ul class="list-node"><li>Potential follow-up work maintaining or extending the bot</li></ul><hr><h2 class="heading-node">📩 Submission Instructions</h2>Submit:<ul class="list-node"><li>GitHub repo link</li><li>Demo (video or live test group)</li><li>Short explanation of approach &amp; decisions</li></ul><hr><h1 class="heading-node">🧑‍⚖️ Judging Rubric (100 Points)</h1><h3 class="heading-node">1️⃣ Functional Correctness — 30 pts</h3><ul class="list-node"><li>New member detection works</li><li>Intro message sent correctly</li><li>Intro completion detected</li><li>Access restriction enforced properly </li></ul>30: Fully works 15–29: Minor issues 0–14: Core logic broken<hr><h3 class="heading-node">2️⃣ Intro Enforcement Logic — 20 pts</h3><ul class="list-node"><li>Clear enforcement before intro</li><li>Logical handling of edge cases</li><li>Sensible validation approach </li></ul>16–20: Robust 8–15: Basic 0–7: Weak<hr><h3 class="heading-node">3️⃣ Code Quality &amp; Maintainability — 20 pts</h3><ul class="list-node"><li>Clean structure &amp; naming</li><li>Modular design</li><li>Easy for others to extend </li></ul>16–20: Production-ready 8–15: Acceptable 0–7: Poor<hr><h3 class="heading-node">4️⃣ Deployment &amp; Documentation — 15 pts</h3><ul class="list-node"><li>Clear setup steps</li><li>Env variables documented</li><li>Easy to deploy </li></ul>12–15: Very easy 6–11: Some friction 0–5: Poor<hr><h3 class="heading-node">5️⃣ UX &amp; Community Experience — 10 pts</h3><ul class="list-node"><li>Friendly messaging</li><li>Non-intrusive reminders</li><li>Good community tone </li></ul>8–10: Excellent 4–7: Neutral 0–3: Disruptive<hr><h3 class="heading-node">6️⃣ Bonus Features — 5 pts</h3><ul class="list-node"><li>Admin tools</li><li>Configurability</li><li>Extra polish </li></ul>4–5: Multiple bonuses 1–3: Minor extras 0: None<hr><h2 class="heading-node">🏆 Winner Selection</h2><ul class="list-node"><li>Highest total score wins</li><li>Ties broken by: <ol class="list-node"><li>Better UX</li><li>Cleaner code</li><li>Faster iteration &amp; communication</li></ol></li></ul><hr><h2 class="heading-node">⚠️ Disqualification</h2><ul class="list-node"><li>Bot does not run</li><li>Core requirements missing</li><li>No documentation</li></ul>Plagiarized code

Build a Telegram Intro Gatekeeper Bot for Superteam

Build a Telegram Intro Gatekeeper Bot for Superteam