IWI Discord Bot

A Discord bot for the IWI department at HKA that provides student verification through RaumZeit API integration.

Features

• Student verification using RaumZeit credentials
• Automatic role assignment for verified students
• Interactive verification flow with Discord modals and buttons

Setup

1. Clone the repository

   git clone <repository-url>
   cd IWIDiscordBot

2. Create a virtual environment

   python -m venv .venv
   source .venv/bin/activate  # On macOS/Linux
   # or
   .venv\Scripts\activate  # On Windows

3. Install dependencies

   pip install discord.py python-dotenv aiohttp

4. Configure environment variables

   Copy .env.example to .env and fill in your values:

   cp .env.example .env

   Required variables:

   • DISCORD_TOKEN: Your Discord bot token
   • RAUMZEIT_URL: RaumZeit API endpoint
   • SERVER_ID: Your Discord server ID
   • CHANNEL_ID: Channel ID where verification message will be sent
   • STUDENT_ROLE_ID: Role ID to assign to verified students

5. Run the bot

   python src/main.py

Requirements

• Python 3.8+
• discord.py
• python-dotenv
• aiohttp

Bot Permissions Required

• Send Messages
• Embed Links
• Manage Roles
• Read Message History
• Use Slash Commands

Security Notes

• Discord modals cannot hide password input (API limitation)
• All verification interactions are ephemeral (only visible to the user)
• Credentials are only used for verification and are not stored
• Users receive a privacy notice before entering credentials

License

Private repository - All rights reserved