{"id":79,"date":"2024-09-19T11:31:19","date_gmt":"2024-09-19T09:31:19","guid":{"rendered":"https:\/\/lukasza.hopto.org\/blog\/wordpress\/?p=79"},"modified":"2024-12-18T13:15:40","modified_gmt":"2024-12-18T12:15:40","slug":"building-a-python-telegram-bot-to-check-csmatch-stats-after-a-premiere-match","status":"publish","type":"post","link":"https:\/\/lukasza.hopto.org\/index.php\/2024\/09\/19\/building-a-python-telegram-bot-to-check-csmatch-stats-after-a-premiere-match\/","title":{"rendered":"Building a Python Telegram Bot to Check CSMatch Stats After a Premiere Match"},"content":{"rendered":"\n

If you\u2019ve ever wanted instant updates on your CS<\/strong><\/p>\n\n\n\n

Premiere<\/strong> matches without constantly refreshing stats websites, you\u2019re in luck! With a little Python and the magic of Telegram, you can create a Telegram bot<\/strong> that automatically fetches and shares match stats from CSStats<\/strong> right after your game. Whether you\u2019re showing off your latest ace or keeping tabs on your performance, this bot will make your CS<\/p>\n\n\n\n

life much easier.<\/p>\n\n\n\n

Let\u2019s dive into how you can build this handy bot that does all the heavy lifting for you!<\/p>\n\n\n\n

\n\n\n\n

What You\u2019ll Need<\/strong><\/h3>\n\n\n\n

To get this project rolling, here\u2019s a list of the basic tools and accounts you\u2019ll need:<\/p>\n\n\n\n

    \n
  1. Python<\/strong>: Preferably Python 3.x.<\/li>\n\n\n\n
  2. Telegram Bot Token<\/strong>: You can get this by creating a bot through BotFather<\/a> on Telegram.<\/li>\n\n\n\n
  3. CSStats API or CSstats source<\/strong>: This is where you\u2019ll fetch match stats after each game.<\/li>\n\n\n\n
  4. Python Libraries<\/strong>: You\u2019ll need python-telegram-bot<\/code> for interacting with Telegram, and requests<\/code> to make HTTP requests to CSStats.<\/li>\n\n\n\n
  5. A Telegram Account<\/strong>: You\u2019ll be interacting with your bot here!<\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n

    Step 1: Creating Your Telegram Bot<\/strong><\/h3>\n\n\n\n

    First, you\u2019ll need to create a Telegram bot using BotFather<\/strong>:<\/p>\n\n\n\n

      \n
    1. Open Telegram<\/strong> and search for @BotFather<\/code>.<\/li>\n\n\n\n
    2. Start a chat with BotFather and type \/newbot<\/code>.<\/li>\n\n\n\n
    3. Follow the prompts to name your bot and get a bot token<\/strong>. You\u2019ll need this token for the Python code, so keep it handy.<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n

      Step 2: Setting Up the Python Environment<\/strong><\/h3>\n\n\n\n

      To get started, you\u2019ll need to install a few Python libraries. Open your terminal or command prompt and run the following commands to install the necessary packages:<\/p>\n\n\n\n

      pip install python-telegram-bot requests
      <\/code><\/pre>\n\n\n\n
      These will let you easily interact with the Telegram API and send HTTP requests to fetch stats.<\/p>\n\n\n\n
      \n\n\n\n
      Step 3: Writing the Bot Code<\/strong><\/h3>\n\n\n\n
      Here\u2019s a basic Python script that checks your CS<\/p>\n\n\n\n
      stats after a Premiere match and sends them to your Telegram bot.<\/p>\n\n\n\n
      Importing Required Libraries<\/strong><\/h4>\n\n\n\n
      import requests
      from telegram import Update
      from telegram.ext import Updater, CommandHandler, CallbackContext

      # CSStats API (replace with your actual API source or endpoint)
      CSSTATS_API_URL = 'https:\/\/api.csstats.example.com\/match_stats\/'

      # Replace with your Telegram bot token
      TELEGRAM_BOT_TOKEN = 'YOUR_TELEGRAM_BOT_TOKEN'
      <\/code><\/pre>\n\n\n\n
      Function to Fetch CSMatch Stats<\/strong><\/h4>\n\n\n\n
      Let\u2019s define a function that pulls the latest stats from CSStats. You\u2019ll need the match ID (or player ID, depending on the API) to get specific stats.<\/p>\n\n\n\n
      def get_match_stats(player_id: str) -> dict:
          \"\"\"Fetches match stats from CSStats API.\"\"\"
          response = requests.get(f\"{CSSTATS_API_URL}{player_id}\")
          
          if response.status_code == 200:
              return response.json()  # Returns stats as a dictionary
          else:
              return {\"error\": \"Could not fetch match stats. Please try again later.\"}
      <\/code><\/pre>\n\n\n\n
      Here, player_id<\/code> would be the ID associated with your CS<\/p>\n\n\n\n
      profile on CSStats (or whichever stats provider you\u2019re using).<\/p>\n\n\n\n
      Command to Fetch Stats<\/strong><\/h4>\n\n\n\n
      Next, you\u2019ll create a command in your bot to trigger the stats check. This function will respond to the \/stats<\/code> command from users and send back the match data.<\/p>\n\n\n\n
      def check_stats(update: Update, context: CallbackContext):
          \"\"\"Telegram command to check latest CS:GO match stats.\"\"\"
          chat_id = update.message.chat_id
          player_id = context.args[0]  # Pass the player ID as an argument to the bot command
          
          stats = get_match_stats(player_id)
          
          if \"error\" in stats:
              context.bot.send_message(chat_id=chat_id, text=stats[\"error\"])
          else:
              match_result = f\"\"\"
              Match Results for Player {player_id}:
              - Kills: {stats['kills']}
              - Deaths: {stats['deaths']}
              - MVPs: {stats['mvps']}
              - Headshots: {stats['headshots']}%
              - Total Score: {stats['score']}
              \"\"\"
              context.bot.send_message(chat_id=chat_id, text=match_result)
      <\/code><\/pre>\n\n\n\n
      In this function, the player\u2019s CS<\/p>\n\n\n\n
      stats (kills, deaths, MVPs, etc.) are fetched and sent back as a formatted message. You can customize this message to include any data available in the API response.<\/p>\n\n\n\n
      \n\n\n\n
      Step 4: Putting It All Together<\/strong><\/h3>\n\n\n\n
      Finally, you need to create the bot\u2019s main function, which will handle incoming messages and respond to commands.<\/p>\n\n\n\n
      def main():
          \"\"\"Start the bot.\"\"\"
          updater = Updater(token=TELEGRAM_BOT_TOKEN, use_context=True)
          dispatcher = updater.dispatcher
          
          # Command to check stats
          dispatcher.add_handler(CommandHandler('stats', check_stats))
          
          # Start the Bot
          updater.start_polling()
          print(\"Bot is running...\")
          
          # Keep the bot running until interrupted
          updater.idle()

      if __name__ == '__main__':
          main()
      <\/code><\/pre>\n\n\n\n
      Here\u2019s a breakdown of what this script does:<\/p>\n\n\n\n
        \n
      • It initializes the bot with your Telegram bot token<\/strong>.<\/li>\n\n\n\n
      • It sets up the \/stats<\/code> command that calls the check_stats()<\/code> function.<\/li>\n\n\n\n
      • It starts polling Telegram for messages and commands.<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        Step 5: Running the Bot<\/strong><\/h3>\n\n\n\n
        Save the code to a Python file (e.g., telegram_bot.py<\/code>), and run it with:<\/p>\n\n\n\n
        python telegram_bot.py
        <\/code><\/pre>\n\n\n\n
        Your bot is now live! You can interact with it by sending a \/stats<\/code> command followed by your CS<\/p>\n\n\n\n
        player ID. For example:<\/p>\n\n\n\n
        \/stats 76561198012345678
        <\/code><\/pre>\n\n\n\n
        The bot will reply with your latest match stats straight from CSStats.<\/p>\n\n\n\n
        \n\n\n\n
        Bonus: Automating Post-Match Updates<\/strong><\/h3>\n\n\n\n
        Want the bot to automatically notify you after every match? You can schedule the bot to periodically check for new match data by using Python\u2019s schedule<\/code> library or Telegram\u2019s job queue feature. This way, after every Premiere match, the bot can fetch the latest stats and push them to you.<\/p>\n\n\n\n
        \n\n\n\n
        Final Thoughts: Game Stats at Your Fingertips<\/strong><\/h3>\n\n\n\n
        With this Python bot, you\u2019ve now automated one of the most tedious parts of competitive gaming\u2014checking your post-match stats. By leveraging the power of Telegram<\/strong> and Python<\/strong>, you can stay updated on your performance with ease, all while impressing your friends with your newfound coding skills. The bot can be customized further to track multiple players, send match highlights, or even analyze performance trends over time.<\/p>\n\n\n\n
        So whether you\u2019re a CS<\/p>\n\n\n\n
        pro or just a casual player, your stats will always be just one chat away! Happy coding and happy fragging!<\/p>\n\n\n\n