Skip to main content

MSK Ticket Bot – Service Setup (Deutsch)

Diese Anleitung erklärt, wie du den MSK Transcript Service für deinen selbst-gehosteten Bot einrichtest.
Der Service speichert Ticket-Transkripte online und macht sie über einen öffentlichen Link abrufbar.
Premium-Nutzer können Transkripte zusätzlich unter ihrer eigenen Domain bereitstellen.

1. Was ist der Transcript Service?​

Wenn ein Ticket geschlossen wird, generiert der Bot ein vollständiges HTML-Transkript aller Nachrichten.
Ohne konfigurierten API Key wird das Transkript wie bisher als Dateianhang per DM versendet.

Mit dem MSK Transcript Service wird das Transkript stattdessen auf www.msk-scripts.de hochgeladen
und ein öffentlicher Link zurückgegeben. Nutzer können das Transkript direkt im Browser öffnen.

Premium-Nutzer erhalten zusätzlich herunterladbare Dateianhänge im Transkript und können eine
eigene Domain konfigurieren, sodass Transkripte unter ihrer eigenen URL abrufbar sind.

2. Abo-Modelle im Überblick​

FeatureBasic (kostenlos)Premium (5 €/Monat)Premium+ (10 €/Monat)
Transkript als Link✅✅✅
Max. Transkriptgröße10 MB100 MB250 MB
Dateianhänge im Transkript❌✅✅
Max. Anhangsgröße pro Ticket—150 MB500 MB
Eigene Domain❌✅✅
Speicherdauer30 Tage60 Tage90 Tage

Premium und Premium+ werden über GitHub Sponsors freigeschaltet.
Hier sponsern: github.com/sponsors/MSK-Scripts

3. Schritt 1 – GitHub OAuth App erstellen​

Zweck: Die Website verifiziert deinen GitHub-Account, um deinen Sponsoring-Status zu prüfen
und ihn mit deinem Discord-Server zu verknüpfen.

Anleitung​

  1. Öffne github.com/settings/developers

  2. Klicke links auf „OAuth Apps"

  3. Klicke auf „New OAuth App"

  4. Fülle die Felder aus:

    FeldWert
    Application nameMSK Ticket Bot (oder beliebig)
    Homepage URLhttps://www.msk-scripts.de
    Authorization callback URLhttps://www.msk-scripts.de/api/auth/github/callback
    Enable Device FlowNicht angehakt lassen

  5. Klicke auf „Register application"

  6. Kopiere die Client ID

  7. Klicke auf „Generate a new client secret" und kopiere das Client Secret

Wo eintragen​

Diese Werte kommen in die .env.local auf dem Webserver (nicht in die Bot-.env):

GITHUB_CLIENT_ID=deine_client_id_hier
GITHUB_CLIENT_SECRET=dein_client_secret_hier

4. Schritt 2 – Discord OAuth App erstellen​

Zweck: Die Website liest deine Discord-Server-Liste, damit du auswählen kannst,
für welchen Server der API Key gelten soll.

Anleitung​

  1. Öffne discord.com/developers/applications
  2. Klicke auf „New Application"
  3. Vergib einen Namen, z.B. MSK Ticket Verify
  4. Klicke links auf „OAuth2"
  5. Klicke unter „Redirects" auf „Add Redirect" und trage ein: 
    https://www.msk-scripts.de/api/auth/discord-verify/callback
  6. Klicke auf „Save Changes"
  7. Kopiere die Client ID auf der OAuth2-Seite
  8. Klicke auf „Reset Secret" und kopiere das Client Secret

Wo eintragen​

DISCORD_VERIFY_CLIENT_ID=deine_client_id_hier
DISCORD_VERIFY_CLIENT_SECRET=dein_client_secret_hier

⚠️ Dies ist eine separate App vom Discord-Bot selbst.
Verwende hier nicht den Bot-Token — nur Client ID und Secret.

5. Schritt 3 – Verifizierung auf der Website​

Dieser Prozess muss einmalig pro Server von einem Server-Administrator durchgeführt werden.

5.1 Website aufrufen​

Öffne www.msk-scripts.de/verify in deinem Browser.

5.2 GitHub verbinden​

Klicke auf „Mit GitHub anmelden".
Du wirst zu GitHub weitergeleitet und musst die Anwendung autorisieren.
Danach wirst du automatisch zurückgeleitet.

ℹ️ Wenn du GitHub Sponsors für Premium oder Premium+ nutzt, musst du dich mit demselben GitHub-Account
anmelden, über den du sponserst. So wird dein Tier automatisch erkannt.

5.3 Discord verbinden​

Klicke auf „Mit Discord anmelden".
Du wirst zu Discord weitergeleitet — klicke dort auf „Autorisieren".

Die App benötigt zwei Berechtigungen:

  • identify — damit dein Discord-Account erkannt werden kann
  • guilds — damit deine Server-Liste angezeigt werden kann

5.4 Server auswählen​

Du siehst nun eine Liste aller Discord-Server, auf denen du Administrator-Rechte hast.
Wähle den Server aus, für den du den API Key haben möchtest, und klicke auf „API Key generieren".

ℹ️ Jeder Server benötigt einen eigenen API Key.
Wenn du mehrere Server betreust, führe den Prozess für jeden Server separat durch.

5.5 API Key speichern​

Nach der Generierung wird dein persönlicher API Key angezeigt.
Kopiere ihn sofort — er wird nicht erneut angezeigt.

MSK_API_KEY=a1b2c3d4e5f6...

⚠️ Wichtig: Wenn du den Verify-Prozess für denselben Server erneut durchläufst,
wird ein neuer API Key generiert und der alte wird sofort ungültig.
Du musst den neuen Key in der .env deines Bots eintragen und den Bot neu starten.

🔒 Teile diesen Key mit niemandem. Wer ihn kennt, kann Transkripte in deinem Namen hochladen.

✅ Du kannst diese Seite schließen, sobald du den Key sicher kopiert hast.

6. Schritt 4 – API Key in den Bot eintragen​

Öffne die .env-Datei in deinem Bot-Ordner und trage ein:

MSK_API_KEY="dein_api_key_hier"
MSK_API_URL="https://www.msk-scripts.de"

Starte den Bot danach neu.

7. Schritt 5 – Eigene Domain einrichten (Premium)​

Dieser Schritt ist nur für Premium und Premium+ verfügbar.
Basic-Nutzer können diesen Schritt überspringen.

Mit einer eigenen Domain sind Transkripte unter deiner URL abrufbar,
z.B. https://tickets.deinserver.de/... statt https://www.msk-scripts.de/...

7.1 Dashboard aufrufen​

Klicke nach der Verifizierung auf „Zum Dashboard",
oder öffne direkt www.msk-scripts.de/dashboard.

7.2 Domain eintragen​

Im Bereich „Eigene Domain" trägst du deine gewünschte Domain ein, z.B.:

tickets.deinserver.de

Klicke auf „Setzen". Falls der DNS noch nicht korrekt gesetzt ist, werden die DNS-Anweisungen angezeigt.

7.3 DNS A-Record setzen​

Melde dich bei deinem Domain-Anbieter an (z.B. Cloudflare, IONOS, Namecheap) und erstelle einen A-Record:

TypNameZiel (IP)
Atickets (oder @ für die Root-Domain)Die im Dashboard angezeigte IP-Adresse

⏱ DNS-Änderungen können bis zu 24 Stunden dauern.
Die meisten Anbieter verarbeiten Änderungen jedoch innerhalb weniger Minuten bis einer Stunde.

7.4 DNS prüfen und aktivieren​

Sobald die DNS-Propagierung abgeschlossen ist, klicke im Dashboard auf „DNS prüfen".
Falls die Domain korrekt auf den Server zeigt, wird sie automatisch aktiviert:

  • Ein Apache2 VirtualHost wird auf dem Server erstellt
  • Ein kostenloses SSL-Zertifikat (Let's Encrypt) wird über Certbot eingerichtet
  • Deine Transkripte sind sofort unter deiner Domain abrufbar

7.5 Domain entfernen​

Um eine eigene Domain zu entfernen, klicke im Dashboard auf das Papierkorb-Symbol neben der aktiven Domain.
Der VirtualHost wird vom Server entfernt und Transkripte sind wieder über die Standard-URL abrufbar.

8. Konsolenausgabe beim Start​

Beim Start siehst du folgende Ausgabe im Terminal:

                        ███╗   ███╗███████╗██╗  ██╗
                        ████╗ ████║██╔════╝██║ ██╔╝
                        ██╔████╔██║███████╗█████╔╝
                        ██║╚██╔╝██║╚════██║██╔═██╗
                        ██║ ╚═╝ ██║███████║██║  ██╗
                        ╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝
████████╗██╗ ██████╗██╗  ██╗███████╗████████╗    ██████╗  ██████╗ ████████╗
...
                 https://github.com/MSK-Scripts/discord_ticketbot

Checking API Key... [Ergebnis]

Connecting to Discord...

  ✔ MSK Ticket Bot successfully started!
  ──────────────────────────────────────────
  Bot       BotName#1234
  Guilds    3
  Commands  17

Mögliche API Key Ergebnisse​

AusgabeBedeutung
Kein API Key konfiguriert → BasicKein MSK_API_KEY in der .env eingetragen
API Key ungültig → BasicDer Key ist falsch oder wurde neu generiert
MSK-Server nicht erreichbar → Basicwww.msk-scripts.de ist vorübergehend nicht erreichbar
API Key gültig → Premium✅ Premium aktiv
API Key gültig → Premium+✅ Premium+ aktiv