Skip to content

UniPi-Orari/telegram-bot

Repository files navigation

📚 Unipi Orari Informatica (UPIO) - Telegram Bot 💙

logo

Questo Bot permette agli studenti di ottenere l'orario delle lezioni direttamente su Telegram!

🚀 Funzionalità

shocked cat

  • 📅 Recupero orari delle lezioni: Tramite un wrapper dell'api dell'università
  • 🔄 Refresh dell'orario: Basta premere un pulsante per ottenere l'orario aggiornato
  • 🔍 Dati utente specifici: Il bot ricorda il corso che hai selezionato, così non devi inserirlo di nuovo!
  • 📝 Verifica del corso: Assicura che l'utente inserisca un corso valido (A, B, C), altrimenti ti manda a fanculo :D

🔧 Come Funziona

  1. Avvia il bot con il comando /start.
  2. Il bot ti chiederà in quale corso sei iscritto (A, B, o C).
  3. Recupera l'orario delle lezioni per i prossimi 7 giorni, includendo nome della lezione, orario di inizio e fine.
  4. I risultati sono mostrati in un messaggio formattato con HTML per una lettura più facile.
  5. Puoi cliccare sul pulsante per ripetere la ricerca in qualsiasi momento!

🛠️ Installazione

  1. Clona il repository:

    git clone https://github.com/UniPi-Orari/telegram-bot
  2. Installa le dipendenze:

    dart pub get
  3. Configura il token del bot nel file env.dart nella root directory:

    library telegram_bot.globals;
    String token = "TOKEN";
  4. Esegui il bot:

    dart run bin/telegram_bot.dart

⚙️ Comandi

  • /start - Avvia la conversazione e seleziona il tuo corso.
  • /help - Mostra un breve messaggio di aiuto con i comandi disponibili(anche se quali cazzo di comandi vuoi che abbia questo bot?)

💾 Memorizzazione dei Dati

  • Le informazioni sul corso selezionato dagli utenti sono salvate in un file JSON (users_data.json), consentendo al bot di ricordare le preferenze degli utenti.
  • Se non ci sono dati disponibili per l'utente, gli verrà chiesto di inserire nuovamente il corso.

🤖 Realizzato Con

  • Televerse: Una libreria Dart per costruire bot Telegram in modo semplice.

💻 With 💙 by zubby & ale

About

check repo name duh

Resources

License

Stars

Watchers

Forks

Languages