Quizzical Bot User Guide

🎮 Quick Start Guide

Get your Telegram group quiz-ready in under 2 minutes!

🚀 Getting Started

Step 1: Find and Add the Bot

1. Open Telegram on your device (mobile or desktop)
2. Search for @QuizzicalBot in the search bar
3. Start a conversation by clicking "Start" or typing /start
4. Add to your group by clicking the "Add to Group" button or:
   • Go to your target group
   • Type @QuizzicalBot in a message
   • Select "Add QuizzicalBot to the group"

Step 2: Grant Necessary Permissions

For the bot to work properly, it needs:

✅ Send Messages - To post quiz questions and results
✅ Read Messages - To see user answers
✅ Manage Messages - To organize quiz sessions
✅ Add Users (Optional) - For inviting participants

How to set permissions:

1. Go to group settings (tap group name)
2. Select "Administrators"
3. Find @QuizzicalBot
4. Enable the required permissions

Step 3: Initialize Your Group

Once the bot is added with proper permissions:

/start

You'll see a welcome message with:

• 🎯 Group initialization confirmation
• 📋 Quick command overview
• 🏆 Empty leaderboard (ready for your first quiz!)
• ⚙️ Basic setup options

🎯 Creating Your First Quiz

Quick AI-Generated Quiz

The easiest way to start:

/quiz Science

What happens next:

1. ⚡ AI generates 5 questions instantly (default)
2. 📝 Questions are reviewed for accuracy
3. ⏰ 60-second joining period begins
4. 🎮 Players click JOIN button to participate
5. 🚀 Quiz starts automatically when minimum players join!

Advanced Quiz Options

/quiz [topic/URL] [questions] [min_players]

Examples:

• /quiz - Shows help for quiz command
• /quiz history - 5 questions about history
• /quiz science 10 - 10 questions about science
• /quiz "machine learning" 5 2 - 5 questions, 2 min players
• /quiz https://example.com/article 8 3 - Quiz from URL content

Example Topics That Work Great:

• Educational: Math, History, Science, Literature
• General: Movies, Sports, Geography, Music
• Specific: Harry Potter, World War 2, Space Exploration
• Current: Technology 2024, Recent News, Pop Culture

Quiz Flow

After creating a quiz:

1. 📢 Join Period - 60 seconds for players to join
2. 🔔 JOIN Button - Players click to participate
3. ⏰ Auto-Start - Quiz begins when minimum players reached
4. ❓ Questions - Appear one at a time with 30-second timer
5. 🅰️🅱️🅲️🅳️ Answers - Click letter buttons to respond
6. ✅ Results - Shown after each question
7. 🏆 Final Scores - Displayed at quiz end

📱 Essential Commands

For All Users:

/help              # Show all available commands
/leaderboard       # View current group rankings  
/stats             # See your personal performance
/quiz [topic]      # Create a new quiz (if allowed)
/language          # Change your preferred language
/projectinfo       # Display project information
/aichat [message]  # Chat with AI about the project

Quick Examples:

/quiz "Ancient Egypt"
/leaderboard
/stats
/language

🏆 Understanding the Scoring System

How Points Are Earned:

Base Points:

• ✅ Correct Answer: +1 point
• ❌ Wrong Answer: 0 points

Additional Features:

• ⚡ Speed Recognition - Fastest correct answers highlighted
• 🔥 Accuracy Tracking - Your correct answer percentage
• 🥇 Leaderboard Position - Your rank in the group

Example Scoring:

Question: "What is the capital of France?"
Your answer: A) Paris ✅
Time taken: 3 seconds

Points earned: +1
Status: Correct! (Fastest responder)

Leaderboard Rankings:

The leaderboard shows:

1. 🥇 Rank - Your position in the group
2. 👤 Username - Your display name
3. 📊 Total Points - Cumulative score
4. 🎯 Games Played - Number of quizzes joined

🎮 Participating in Quiz Sessions

Joining a Quiz:

When a quiz is announced:

🎯 New Quiz: Science
📚 Questions: 5
👥 Min Players: 2
⏰ Join within 60 seconds!

[🎮 JOIN QUIZ]

Click the JOIN button to participate!

During a Quiz:

When a question appears:

❓ Question 1/5: What is the largest planet in our solar system?

A) Earth
B) Jupiter  
C) Saturn
D) Mars

⏰ Time remaining: 28 seconds

How to answer:

• Click the letter button: A, B, C, or D
• Answer quickly but carefully
• You can only answer once per question

After answering:

• ✅ Your answer is recorded
• ⏳ Wait for timer to expire
• 📊 Results appear with correct answer
• 🏆 Points are awarded

Tips for Better Performance:

1. 🔥 Read Carefully - Don't rush, accuracy matters
2. ⚡ Think Fast - But prioritize getting it right
3. 🎯 Stay Consistent - Regular participation improves skills
4. 📚 Learn from Mistakes - Review correct answers
5. 🤝 Have Fun - It's about learning and community!

🌍 Multi-Language Support

Change Your Language:

/language

Available Languages:

• 🇬🇧 English
• 🇪🇸 Spanish
• 🇨🇳 Chinese
• 🇮🇳 Hindi
• 🇸🇦 Arabic
• 🇫🇷 French
• 🇷🇺 Russian
• 🇵🇹 Portuguese
• 🇯🇵 Japanese
• 🇵🇱 Polish

Your language preference is saved and used for all bot interactions!

📊 Tracking Your Progress

Personal Statistics

Check your progress anytime:

/stats

You'll see:

• 📈 Total Points - Your cumulative score
• 🎮 Quizzes Played - Number of quiz sessions joined
• 🎯 Questions Answered - Total questions attempted
• ✅ Correct Answers - Number of correct responses
• 📊 Accuracy Rate - Percentage of correct answers
• 🏆 Best Score - Highest score in a single quiz

Group Leaderboard

View everyone's performance:

/leaderboard

Top 10 display includes:

• 🏆 Rankings (1st, 2nd, 3rd, etc.)
• 👤 Member usernames
• 📊 Total points for each member

🎯 Special Features

Project Quizzes

If your group admin has configured project information:

/projectinfo    # View project details
/projectquiz    # Start a project-specific quiz

AI Chat Assistant

Chat with AI about the project (if enabled):

/aichat How does the staking work?

🚨 Common Issues & Quick Fixes

❓ Bot Not Responding

Problem: You type commands but nothing happens Quick Fixes:

1. Check if bot is still in the group
2. Verify bot has admin permissions
3. Try /help to test connection
4. Ask group admin to run /reload

❓ Can't Create Quizzes

Problem: /quiz command doesn't work Possible Reasons:

• Only admins can create quizzes in this group
• Another quiz is already active
• Bot needs to be set up first with /setup

What to do:

• Ask group admin about permissions
• Wait for current quiz to end
• Try /help to see available commands

❓ Quiz Stuck or Not Working

Problem: Quiz seems frozen or commands not working Solution:

• Admin should run /reload to refresh bot state
• This clears any stuck quizzes and resets the bot

❓ Language Not Changing

Problem: Bot still responds in wrong language Solution:

1. Use /language and select from menu
2. Your preference is saved individually
3. Group default can be set by admin in /settings

🎓 Best Practices for Group Members

Being a Great Participant:

1. 🤝 Be Respectful - Congratulate winners, encourage others
2. 🎯 Stay Engaged - Participate regularly to build community
3. 📚 Learn Together - Discuss interesting questions after quizzes
4. 💡 Suggest Topics - Recommend quiz subjects to admins
5. 🏆 Celebrate Others - Acknowledge great performances

Quiz Etiquette:

1. ⏰ Don't Share Answers - Let everyone think for themselves
2. 🤐 No Spoilers - Don't reveal correct answers during quiz
3. 📱 Stay Focused - Avoid off-topic chat during quiz sessions
4. 🎮 Have Patience - Wait for all questions to complete
5. 🙌 Good Sportsmanship - Win gracefully, lose positively

📞 Getting Help When You Need It

Quick Help Options:

In-Group Help:

/help     # Show command list
/start    # Bot information

When to Contact Admin:

• 🐛 Bot is completely unresponsive
• 📊 Quiz features not working properly
• 🔒 Permission issues
• 💻 Technical problems affecting the group

Support Contacts:

Check with your group admin for support contacts, or use:

/help

🎯 Making the Most of Quizzical Bot

Maximizing Your Learning:

1. 🎨 Diversify Topics - Try quizzes on various subjects
2. 📈 Track Progress - Regular check your /stats
3. 🤔 Review Mistakes - Learn from incorrect answers
4. 👥 Study Together - Discuss quiz content with group
5. 🏆 Set Goals - Aim for accuracy improvements

Building Friendly Competition:

1. 🤝 Encourage Others - Support all participants
2. 🎉 Celebrate Wins - Acknowledge top performers
3. 📊 Share Insights - Discuss interesting facts
4. ⚡ Create Challenges - Suggest themed quiz topics
5. 🌟 Stay Positive - Focus on learning and fun

---

🚀 Ready to Start?

Your Quizzical Bot journey begins with these simple steps:

1. ✅ Find @QuizzicalBot on Telegram
2. ✅ Add to your group with admin permissions
3. ✅ Type /start to initialize
4. ✅ Create your first quiz with /quiz [topic]
5. ✅ Click JOIN when the quiz is announced
6. ✅ Have fun learning with your community!

---

💡 Pro Tip

Start with popular, easy topics like "General Knowledge" or "Movies" to get everyone comfortable with the format before moving to more challenging educational content!

⚠️ Remember

The goal is learning and community building. Keep it fun, inclusive, and educational for the best group experience!

🔗 Next Steps

• Admin Guide - For group administrators
• Bot Documentation - Complete feature reference

---

Happy quizzing! 🎉 Transform your group into an engaging learning community with @QuizzicalBot today!