Discord Bot für Akuma Plugin Studio: Verifizierung und Support

Der Discord Bot ist Teil unseres Eigenprojekts Akuma Plugin Studio. Er verknüpft Discord-Nutzer mit ihrem Website-Konto und führt sie bei Supportanfragen durch passende Rückfragen. Eigener Bot-Code, n8n-Workflows und die Projektdatenbank übernehmen dabei unterschiedliche Aufgaben.

Warum ein eigener Discord Bot?

Akuma Plugin Studio verbindet einen Shop für digitale Produkte mit Kundenkonten und einem eigenen Lizenzmodell. Der Support sollte deshalb mehr als einen Discord-Namen sehen: Eine Anfrage sollte dem richtigen Konto, den gekauften Produkten und den vorhandenen Lizenzen zugeordnet werden können.

Hinzu kam ein Ticket-System mit unterschiedlichen Fragebögen für Hilfe, Fehler und Produktwünsche. Diese konkrete Verbindung zur eigenen Datenbank war der Anlass für eine individuelle Entwicklung. Standard-Bots können andere Community-Aufgaben übernehmen; hier ging es um den Ablauf zwischen Website, Produkt und Support.

Account-Verifizierung Schritt für Schritt

Im beschriebenen Standardablauf startet der Bot nach dem Server-Beitritt eine Direktnachricht. Er fragt, ob ein Konto auf der Website besteht. Ein Nutzer mit Konto gibt dessen E-Mail-Adresse an und bestätigt anschließend den Zugriff auf das zugehörige Postfach.

1. Beitritt und Dialog: Die Discord-API meldet den neuen Nutzer; der Bot beginnt den Verifizierungsdialog.
2. E-Mail übernehmen: Die eingegebene Adresse wird an den dafür vorgesehenen n8n-Workflow weitergegeben.
3. Konto abgleichen: Der Workflow prüft, ob die Adresse einem Website-Konto zugeordnet ist.
4. Code erzeugen: Für ein gefundenes Konto entsteht ein zufälliger Bestätigungscode. Er wird zusammen mit Konto-Zuordnung und Ablaufzeit temporär gespeichert.
5. E-Mail versenden: Der Code geht an das hinterlegte Postfach.
6. Eingabe prüfen: Der Nutzer gibt den Code im Bot ein. Der Workflow gleicht den Wert ab und prüft die Gültigkeit.
7. Konten verbinden: Nach erfolgreicher Prüfung wird die Discord-ID dem Website-Konto zugeordnet und die vorgesehene Rolle vergeben.
8. Code entwerten: Der verwendete Code wird gelöscht beziehungsweise ungültig. Abgelaufene Codes werden ebenfalls bereinigt.

Damit wird der Zugriff auf das E-Mail-Postfach nachgewiesen. Der Dialog fragt weder das Website-Passwort noch einen Lizenzschlüssel ab. Die E-Mail-Adresse bleibt dennoch ein personenbezogenes Datum. Begrenzte Versuche und ein kontrollierter Umgang mit bereits verknüpften Konten gehören zur Sicherheitsplanung.

Support, Fehlermeldungen und Wünsche getrennt erfassen

Nach der Verifizierung kann das Ticket der bestätigten Konto-Zuordnung folgen. Der Nutzer wählt zunächst, worum es geht:

• Support: Fragen zu Nutzung, Installation oder Aktivierung eines Produkts.
• Bug-Report: einen Fehler mit Produkt, Version, Beschreibung und Schritten zur Reproduktion melden.
• Update-Wunsch: eine gewünschte Funktion, Verbesserung oder Rückmeldung zu einer kommenden Version beschreiben.

Ein geführter Fragebogen

Je nach Kategorie erscheinen passende Fragen nacheinander. Zu einem Fehler fragt der Ablauf beispielsweise nach dem betroffenen Produkt, der verwendeten Version und dem Betriebssystem. Anschließend folgen Fehlerbeschreibung, Reproduktionsschritte und die Möglichkeit, einen Screenshot anzufügen.

Diese Abfolge macht die benötigten Angaben sichtbar, bevor das Ticket erstellt wird. Sie ersetzt keine fachliche Prüfung: Auch eine strukturierte Anfrage kann unvollständig sein oder Rückfragen auslösen.

Gespräch in Discord, Zuordnung in der Datenbank

Tickets werden in Discord und in einer eigenen Datenbank abgebildet. In Discord entsteht ein privater Kanal für das Gespräch mit dem Support. In der Ticket-Datenbank werden Kategorie, Antworten, Zeitpunkte und Ersteller gespeichert. Hinzu kommen die über das Konto zugeordneten Produkt- und Lizenzinformationen.

So kann bei der Bearbeitung nachvollzogen werden, welches Produkt gekauft wurde, welche Lizenz zugeordnet ist und ob frühere Tickets bestehen. Unklare Ergebnisse und Ausfälle benötigen einen sichtbaren Fehlerweg. Das betrifft beispielsweise einen erfolgreichen Datenbankeintrag bei fehlgeschlagener Kanalerstellung, damit der Vorgang nicht unbemerkt liegen bleibt.

Welche Aufgaben die n8n-Workflows übernehmen

Der Bot führt den Dialog in Discord. Die Workflows kümmern sich um Abfragen und Übergaben im Hintergrund:

• E-Mail-Abgleich: das eingegebene Postfach einem bestehenden Konto zuordnen.
• Code-Erstellung und Versand: einen zufälligen Code erzeugen, temporär speichern und per E-Mail versenden.
• Code-Prüfung: eingegebenen Wert und Gültigkeitsdauer abgleichen.
• Konto-Verknüpfung: die bestätigte Discord-ID in die Nutzerzuordnung schreiben.
• Ticket-Verarbeitung: Fragebogen-Daten übernehmen und mit Discord-Kanal sowie Ticket-Datenbank verbinden.
• Kontext ergänzen: die für die Anfrage erforderlichen Produkt- und Lizenzinformationen zuordnen.
• Bereinigung: abgelaufene Bestätigungscodes aus dem temporären Bereich entfernen.

Die Trennung von Dialog und Workflow-Logik erlaubt, E-Mail-Vorlagen, Datenbankfelder oder Teile des Ablaufs gezielt anzupassen. Solche Änderungen benötigen trotzdem Tests und eine kontrollierte Veröffentlichung. Wiederholte Ereignisse dürfen weder doppelte Tickets noch mehrfache Verknüpfungen anlegen.

Welche Daten miteinander verbunden werden

Vier Datenbereiche unterstützen den Bot: Nutzerkonten, Lizenzen, temporäre Codes und Tickets. Das Nutzerkonto enthält die bestätigte Discord-ID und den verwendeten Anmeldeweg. Die Lizenzzuordnung verbindet Produkte mit Schlüsseln und den im Projekt erlaubten bis zu zwei aktivierten Geräten.

Temporäre Codes haben jeweils eine Konto-Zuordnung und einen Ablaufzeitpunkt. Tickets halten Kategorie, Antworten, Ersteller, Zeitpunkte und Status fest. Diese Zuordnungen machen frühere Anfragen auffindbar und liefern den Kontext für ein neues Gespräch.

Eine gemeinsame Datenbasis bedeutet dabei nicht, dass jede Komponente alle Daten lesen darf. Der Bot, die Workflows und die Administration benötigen jeweils passende Rechte. In Protokollen sollten keine unnötigen Kontaktdaten oder Geheimnisse auftauchen.

Was der Ablauf im Betrieb unterstützt

Die Verifizierung übernimmt die wiederkehrende Konto-Zuordnung im vorgesehenen Standardfall. Der Fragebogen trennt allgemeine Hilfe von Fehlern und Wünschen. Die Ticket-Historie macht frühere Anfragen zum gleichen Nutzer auffindbar. Das sind die konkreten Funktionen, die dieses Projekt zusammenführt.

Die gespeicherten Kategorien und Zeitpunkte können außerdem eine Grundlage für Auswertungen bilden: Zu welchen Produkten entstehen Anfragen? Welche Fehler werden wiederholt gemeldet? Wie entwickelt sich die Bearbeitungsdauer? Voraussetzung dafür sind einheitlich gepflegte Status und aussagekräftige Daten. Für dieses Projekt veröffentlichen wir keine pauschale Zeitersparnis oder garantierte Antwortdauer.

Wann eine solche Verbindung zu einem Unternehmen passt

Das Muster kommt infrage, wenn eine Community tatsächlich über Discord arbeitet und zugleich Produkt- oder Mitgliedskonten außerhalb von Discord bestehen. Beispiele sind digitale Produkte, Software-Angebote, Online-Kurse oder Mitgliederbereiche. Vor einer eigenen Entwicklung prüfen wir, welche Aufgaben die vorhandenen Werkzeuge bereits abdecken.

Eine konkrete Frage ist: Welche Information muss der Support heute bei jeder Anfrage erneut zusammensuchen? Wenn Konto, Produkt und Anfrage bereits vor dem Gespräch zugeordnet sind, kann das den Einstieg in die Bearbeitung erleichtern. Die Qualität der Antwort bleibt eine Aufgabe des Supports.

Der Gesamtbericht zu Akuma Plugin Studio zeigt den zugehörigen Shop, das Kundenportal und die Geräteverwaltung. Unsere Seite zu API-Integrationen erklärt, wie wir vergleichbare Verbindungen für bestehende Systeme planen.