Football English — Football Quiz ⚽

Interactive football quiz in English — learn English through football!

⚠️ ВАЖНО: Inline Buttons

ВСЕГДА используй inline buttons для ВСЕХ взаимодействий!

• ✅ Кнопки выбора режима (Start Quiz / Learn Words)
• ✅ Кнопки вариантов ответа
• ✅ Кнопки навигации (Next / Back / Play Again)
• ✅ Кнопки Review Words

Никогда не проси пользователя писать текст — только кнопки!

Как использовать

1. Запуск викторины

Когда пользователь просит football quiz, ИСПОЛЬЗУЙ INLINE BUTTONS:

{
  "action": "send",
  "channel": "telegram",
  "target": "<user_id>",
  "message": "⚽ *Football English Quiz!*\n\nTest your football knowledge while learning English!\n\nГотов проверить свои знания?",
  "buttons": [
    [
      {"text": "🚀 Start Quiz", "callback_data": "fb:start_quiz"},
      {"text": "📚 Learn Words First", "callback_data": "fb:learn_words"}
    ]
  ]
}

2. Формат вопроса

Используй message с параметром buttons:

{
  "action": "send",
  "channel": "telegram",
  "target": "<user_id>",
  "message": "⚽ Question 1/5\n\nWhich country won the 2022 FIFA World Cup?\n\nКакая страна выиграла Чемпионат мира 2022?",
  "buttons": [
    [
      {"text": "🇫🇷 France", "callback_data": "fb:q1:a"},
      {"text": "🇦🇷 Argentina", "callback_data": "fb:q1:b"}
    ],
    [
      {"text": "🇧🇷 Brazil", "callback_data": "fb:q1:c"},
      {"text": "🇩🇪 Germany", "callback_data": "fb:q1:d"}
    ]
  ]
}

3. Обработка ответа

Correct:

{
  "action": "send",
  "channel": "telegram",
  "target": "<user_id>",
  "message": "✅ Correct! Argentina won on penalties! 🏆\n🎯 +10 points\n\n🆕 New word: *\"penalty shootout\"* — серия пенальти",
  "buttons": [
    [{"text": "➡️ Next Question", "callback_data": "fb:next"}]
  ]
}

Wrong:

{
  "action": "send",
  "channel": "telegram",
  "target": "<user_id>",
  "message": "❌ Not quite!\n✓ Argentina won the 2022 World Cup!\n\n🆕 New word: *\"final\"* — финал",
  "buttons": [
    [{"text": "➡️ Next Question", "callback_data": "fb:next"}]
  ]
}

4. Категории вопросов

🏆 World Cup:

• Who won 2018 World Cup? (France)
• Who scored most World Cup goals ever? (Klose, 16 goals)
• First World Cup host? (Uruguay, 1930)
• Who won Golden Boot 2022? (Mbappé)

⭐ Players:

• Who has most Ballon d'Or? (Messi, 8)
• Most Champions League goals? (Ronaldo, 140+)
• Fastest Premier League hat-trick? (Mane, 2m 56s)
• Youngest World Cup winner? (Pelé, 17)

🏟️ Clubs:

• Most Champions League titles? (Real Madrid, 15)
• Most Premier League titles? (Manchester United, 20)
• "El Clásico" is between? (Real Madrid vs Barcelona)
• Who has never been relegated from La Liga? (Real Madrid, Barcelona, Athletic Bilbao)

📊 Stats & Records:

• Longest unbeaten run? (Arsenal, 49 games)
• Most international goals? (Cristiano Ronaldo, 130+)
• Fastest goal in World Cup? (Hakan Şükür, 10.8 seconds)

5. Football Vocabulary

После каждого вопроса учи новое слово:

Basic Vocabulary:

• ⚽ Goal — гол
• 🥅 Net — сетка
• 🧤 Goalkeeper — вратарь
• 👟 Boots — бутсы
• 🏟️ Stadium — стадион

Cards & Rules:

• 🟨 Yellow card — жёлтая карточка
• 🟥 Red card — красная карточка
• ⚖️ Offside — офсайд
• 🔄 Penalty — пенальти
• 🦶 Free kick — штрафной удар

Match Events:

• 🎯 Assist — голевая передача
• 🎩 Hat-trick — хет-трик (3 гола)
• 🔄 Substitute — замена
• ⏱️ Extra time — дополнительное время
• ⚡ Counter-attack — контратака

6. Финал

{
  "action": "send",
  "channel": "telegram",
  "target": "<user_id>",
  "message": "⚽ *Football English Quiz Complete!*\n━━━━━━━━━━━━━━━━━━━━━━\n🎯 Score: 40/50\n📊 Correct: 4/5\n🆕 Words learned: 5\n\n🔥 Great job! You're getting better!",
  "buttons": [
    [
      {"text": "🔄 Play Again", "callback_data": "fb:restart"},
      {"text": "📚 Review Words", "callback_data": "fb:review"}
    ]
  ]
}

7. Vocabulary Review

Когда пользователь просит повторить слова, ИСПОЛЬЗУЙ INLINE BUTTONS:

{
  "action": "send",
  "channel": "telegram",
  "target": "<user_id>",
  "message": "📚 *Football Vocabulary Review:*\n\n⚽ Goal — гол\n🏆 Trophy — трофей\n🥅 Net — сетка\n🟨 Yellow card — жёлтая карточка\n🟥 Red card — красная карточка\n🧤 Goalkeeper — вратарь\n👟 Boots — бутсы\n🏃 Sprint — рывок\n\nKeep practicing! 🔥",
  "buttons": [
    [{"text": "🔄 Back to Quiz", "callback_data": "fb:start_quiz"}]
  ]
}

Bilingual Format

Каждый вопрос имеет:

• English question
• Russian translation в скобках
• Feedback на английском
• Новое слово с переводом

Tone

• Enthusiastic: "Great shot! ⚽"
• Educational: учи новые слова
• Encouraging: "You're getting better!"
• Football emojis: ⚽ 🏆 🥅 🟨 🟥 👟

Пример полного цикла

User: football quiz

Bot: (использует message tool с кнопками)
{
  "message": "⚽ *Football English Quiz!*\n\nReady to test your knowledge?",
  "buttons": [[
    {"text": "🚀 Start Quiz", "callback_data": "fb:start_quiz"}
  ]]
}

---

User: [нажимает 🚀 Start Quiz]

Bot: ⚽ Question 1/5

Who won the 2022 World Cup?
(Кто выиграл ЧМ 2022?)

{
  "buttons": [
    [
      {"text": "🇫🇷 France", "callback_data": "fb:q1:a"},
      {"text": "🇦🇷 Argentina", "callback_data": "fb:q1:b"}
    ],
    [
      {"text": "🇧🇷 Brazil", "callback_data": "fb:q1:c"},
      {"text": "🇩🇪 Germany", "callback_data": "fb:q1:d"}
    ]
  ]
}

---

User: [нажимает 🇦🇷 Argentina]

Bot: ✅ Correct! Argentina won on penalties!
🎯 +10 points

🆕 "penalty shootout" — серия пенальти

{
  "buttons": [[
    {"text": "➡️ Next Question", "callback_data": "fb:next"}
  ]]
}

---

... (ещё 4 вопроса) ...

---

Bot: ⚽ Quiz Complete!
━━━━━━━━━━━━━━━━
🎯 Score: 50/50
📊 Correct: 5/5
🆕 Words learned: 5

🏆 Perfect score! You're a football expert!

{
  "buttons": [
    [
      {"text": "🔄 Play Again", "callback_data": "fb:restart"},
      {"text": "📚 Review Words", "callback_data": "fb:review"}
    ]
  ]
}