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"}
    ]
  ]
}