🧩 Overview

We’re looking for a developer to build a Telegram onboarding bot for Superteam.

The bot will help onboard new members by:

• Redirecting them to an Intro Channel

• Enforcing a standard introduction format

• Preventing participation in the main group until an intro is completed
  

This bot will be used in a real, active Web3 community, not a demo.

🎯 Objective

Create a Telegram bot that ensures every new member introduces themselves properly before engaging in the main group — improving context, collaboration, and community quality.

🤖 Core Requirements

1️⃣ New Member Detection

• Detect when a user joins the Telegram group

• Automatically send a welcome message (DM or in-group)

2️⃣ Intro Guidance Message

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 & 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!

3️⃣ Intro Completion Logic

• Bot checks if the user has posted at least one message in the Intro Channel

• Optional (bonus): Heuristic validation that the intro roughly follows the format

• Once completed, mark the user as “introduced”

4️⃣ Access Control

Before intro is completed:

• User cannot send messages in the main group
  OR

• Bot auto-deletes their messages and reminds them to introduce themselves

After intro:

• User can participate normally

5️⃣ Example Intro Reference

Bot should include or reference this example (message, pinned post, or command):

✨ Example intro

Hey everyone! I’m Marianne 👋  

Together with Han, we are Co-Leads of Superteam Malaysia!

📍 Based in Kuala Lumpur and Network School  

🧑‍🎓 Fun fact: My first Solana project was building an AI Telegram trading bot, and that's how I found myself in Superteam MY!  

🤝 Looking to contribute by:

• Connecting builders with the right mentors, partners, and opportunities  

• Helping teams refine their story, demos, and go-to-market  

• Supporting members who want to go from “building quietly” → “shipping publicly”

Excited to build alongside all of you — feel free to reach out anytime 🙌

🧪 Technical Expectations

• Language: Node.js (Telegraf) or Python (python-telegram-bot)

• Clean, readable, maintainable code

• Easy deployment (Docker or clear setup guide preferred)

• Basic error handling

✨ Bonus Features (Optional)

• Admin commands:

  • Reset intro status

  • Manually approve users
    

• Persistent storage (DB or lightweight file)

• Configurable intro format via config

• Auto-pin intro message

• Graceful handling of edge cases (leave & rejoin, deleted intro)

📦 Deliverables

• Working Telegram bot

• GitHub repository

• Setup / deployment instructions

• Short demo (Loom video or test group)

💰 Reward

• Potential follow-up work maintaining or extending the bot

📩 Submission Instructions

Submit:

• GitHub repo link

• Demo (video or live test group)

• Short explanation of approach & decisions

🧑‍⚖️ Judging Rubric (100 Points)

1️⃣ Functional Correctness — 30 pts

• New member detection works

• Intro message sent correctly

• Intro completion detected

• Access restriction enforced properly
  

30: Fully works
15–29: Minor issues
0–14: Core logic broken

2️⃣ Intro Enforcement Logic — 20 pts

• Clear enforcement before intro

• Logical handling of edge cases

• Sensible validation approach
  

16–20: Robust
8–15: Basic
0–7: Weak

3️⃣ Code Quality & Maintainability — 20 pts

• Clean structure & naming

• Modular design

• Easy for others to extend
  

16–20: Production-ready
8–15: Acceptable
0–7: Poor

4️⃣ Deployment & Documentation — 15 pts

• Clear setup steps

• Env variables documented

• Easy to deploy
  

12–15: Very easy
6–11: Some friction
0–5: Poor

5️⃣ UX & Community Experience — 10 pts

• Friendly messaging

• Non-intrusive reminders

• Good community tone
  

8–10: Excellent
4–7: Neutral
0–3: Disruptive

6️⃣ Bonus Features — 5 pts

• Admin tools

• Configurability

• Extra polish
  

4–5: Multiple bonuses
1–3: Minor extras
0: None

🏆 Winner Selection

• Highest total score wins

• Ties broken by:
  

  1. Better UX

  2. Cleaner code

  3. Faster iteration & communication

⚠️ Disqualification

• Bot does not run

• Core requirements missing

• No documentation

Plagiarized code