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!*nnTest your football knowledge while learning English!nnГотов проверить свои знания?",
  "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/5nnWhich country won the 2022 FIFA World Cup?nnКакая страна выиграла Чемпионат мира 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 pointsnn🆕 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!nn🆕 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/50n📊 Correct: 4/5n🆕 Words learned: 5nn🔥 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:*nn⚽ Goal — голn🏆 Trophy — трофейn🥅 Net — сеткаn🟨 Yellow card — жёлтая карточкаn🟥 Red card — красная карточкаn🧤 Goalkeeper — вратарьn👟 Boots — бутсыn🏃 Sprint — рывокnnKeep 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!*nnReady 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"}
    ]
  ]
}

football-english

Installation