Discord-Bots

Mit der Aufgabe beginnen, nicht mit der Funktionsliste

Schreiben Sie vor der Wahl der Funktionen auf, womit Ihre Moderatoren und Community-Manager ihre Zeit verbringen. Auf den meisten Servern ist die Antwort dieselbe Handvoll Aufgaben: Menschen begrüßen und prüfen, ob sie echt sind, Rollen vergeben, dieselben Fragen beantworten, mit Regelbrechern umgehen und das festhalten, und Supportanfragen dorthin bringen, wo sie nicht verloren gehen.

Jede davon ist eine gute erste Funktion, weil sie vom ersten Tag an Zeit spart, leicht zu messen ist und niemand zur Nutzung überredet werden muss. Ein Punktesystem oder ein Minispiel funktioniert dagegen nur, wenn es den Mitgliedern wichtig ist, und das können Sie erst wissen, wenn die Grundlagen laufen.

Was Sie zuerst bauen sollten

1. 01

   Onboarding und Verifizierung

   Ein Begrüßungsablauf, der neue Mitglieder die Regeln akzeptieren lässt, optional ein Konto anderswo verknüpft und erst dann den Server öffnet. Er hält die meisten Spam-Konten an der Tür auf und gibt jedem Mitglied denselben ersten Eindruck.

2. 02

   Rollen zur Selbstauswahl

   Schaltflächen oder ein Menü, über die Mitglieder Region, Sprache, Interessen oder Benachrichtigungen wählen. Das nimmt Moderatoren einen stetigen Strom von Anfragen ab und hält Kanäle relevant.

3. 03

   Moderationsaktionen mit Protokoll

   Verwarnen, stummschalten, entfernen und sperren über Befehle, die festhalten, wer was wann und warum getan hat, in einem privaten Kanal und in einer Datenbank. Einheitliche Aufzeichnungen machen Moderation fair und lassen ein Team zwischen Schichten übergeben.

4. 04

   Antworten auf häufige Fragen

   Eine kleine Zahl von Slash-Befehlen oder eine durchsuchbare FAQ, die die offizielle Antwort postet. Der Text liegt in einem Dashboard, damit Mitarbeitende ihn ohne Entwickler ändern können.

5. 05

   Support-Tickets

   Eine Schaltfläche, die einen privaten Thread oder Kanal zwischen einem Mitglied und dem Supportteam öffnet, mit gespeichertem Verlauf beim Schließen. Community-Manager fragen am häufigsten danach, sobald sie es einmal haben.

Fünf Funktionen sind für die meisten Communities ein vollständiges erstes Release. Es lässt sich schnell bauen, testen und übergeben und liefert die Nutzungsdaten, die Sie brauchen, um zu entscheiden, was Sie als Nächstes bauen.

Wie Discord-Bots funktionieren, kurz gefasst

Moderne Discord-Bots bauen auf Anwendungsbefehlen auf. Es gibt drei Arten: Slash-Befehle, die erscheinen, wenn ein Mitglied einen Schrägstrich tippt, und Nutzer- und Nachrichtenbefehle, die erscheinen, wenn jemand mit der rechten Maustaste auf ein Mitglied oder eine Nachricht klickt oder tippt. Eine App kann bis zu 100 globale Slash-Befehle registrieren, dazu 15 Nutzer- und 15 Nachrichtenbefehle ^[1]. Das reicht reichlich; ein Bot, der mehr braucht, sind meist mehrere Bots in einem.

Nutzt ein Mitglied einen Befehl oder drückt eine Schaltfläche, schickt Discord dem Bot eine Interaktion, und der Bot muss innerhalb von 3 Sekunden eine erste Antwort senden ^[2]. Alles Langsamere, etwa der Aufruf eines anderen Systems oder eines KI-Modells, muss zuerst bestätigen und später nachliefern, und das Interaktionstoken zum Nachliefern gilt 15 Minuten ^[2]. Wer das von Anfang an einplant, vermeidet den häufigsten Fehler einer ersten Fassung: Befehle, die im Test funktionieren und scheitern, wenn der Server ausgelastet ist.

Um auf Ereignisse zu reagieren, die keine Befehle sind, etwa den Beitritt eines Mitglieds, verbindet sich ein Bot mit dem Gateway von Discord und deklariert Intents: die Kategorien von Ereignissen, die er empfangen will ^[3]. Und jeder Bot arbeitet innerhalb von Ratenlimits. Laut Discords Dokumentation können Bots bis zu 50 Anfragen pro Sekunde an die API stellen, und eine Adresse, die zu viele ungültige Anfragen stellt, derzeit 10.000 in 10 Minuten, wird vorübergehend eingeschränkt ^[4]. Ein Bot, der massenhaft Rollen vergibt oder in jeden Kanal gleichzeitig postet, muss seine Arbeit in eine Warteschlange stellen.

Fordern Sie so wenig Zugriff wie möglich

Manche Intents sind wegen der Daten, die sie offenlegen, privilegiert: Servermitglieder, Präsenz und Nachrichteninhalt ^[3]. Ohne den Intent für Nachrichteninhalte sieht ein Bot bei den meisten Nachrichten, die er nicht selbst gesendet hat oder in denen er nicht erwähnt wurde, leeren Inhalt ^[3]. Discords Dokumentation sagt auch: Hat eine App mehr als 10.000 einzelne Nutzer, die sie über ihre Server hinweg sehen können, braucht sie eine Prüfung für den weiteren Zugriff auf privilegierte Intents, und verifizierte Apps, was eine App ab 100 Servern sein muss, brauchen für jeden privilegierten Intent eine Freigabe ^[3].

Die praktische Lehre: Entwerfen Sie Funktionen, wo möglich, so, dass sie keinen privilegierten Zugriff brauchen. Slash-Befehle, Schaltflächen und Menüs liefern ihre eigenen Eingaben an den Bot, sodass eine FAQ, ein Ticketsystem oder Rollen zur Selbstauswahl nicht jede Nachricht lesen müssen. Stichwortbasierte Automoderation muss es, und Discords eigenes AutoMod kann das ganz ohne eigenen Bot abdecken.

• Fordern Sie den Intent für Servermitglieder nur an, wenn Sie Beitritts- und Austrittsereignisse brauchen, für Onboarding oder Mitgliederzahlen.
• Vermeiden Sie den Intent für Nachrichteninhalte, außer eine Funktion liest wirklich freien Text, und schreiben Sie für die Prüfung auf, warum.
• Geben Sie der Rolle des Bots nur die Berechtigungen, die seine Funktionen nutzen. Ein Bot mit Administratorrechten ist ein einzelner Ausfallpunkt für den ganzen Server.

Was Sie später bauen sollten, oder gar nicht

Zwei Discord-Projekte, nach unserer Preisliste berechnet

Die durchgerechneten Beispiele unten zeigen die Spanne nach unserer heutigen Preisliste, mit Zahlungsplan und monatlichen Betriebskosten. Das erste ist das erste Release mit fünf Funktionen von oben. Das zweite fügt ein Web-Dashboard hinzu, in dem Mitarbeitende den Bot verwalten, Mitglieder ihre Konten verknüpfen und das Team sieht, wie es der Community geht.

Einen Bot nach dem Start betreiben

Ein Bot, der auf das Gateway hört, ist ein Programm, das den ganzen Tag, jeden Tag verbunden bleiben muss. Planen Sie, wo er läuft, wie er nach einem Absturz neu startet und wie Sie erfahren, dass er ausgefallen ist, bevor Ihre Mitglieder es Ihnen sagen.

• Hosten Sie ihn auf einem Server oder einer Container-Plattform mit automatischen Neustarts und Health Checks, nicht auf dem Rechner von irgendjemandem.
• Halten Sie seine Daten (Moderationsprotokolle, Tickets, Einstellungen) in einer richtigen Datenbank mit Sicherungen, nicht in Dateien neben dem Code.
• Protokollieren Sie jeden Befehl und jeden Fehler, damit sich die Frage eines Moderators, was passiert ist, beantworten lässt.
• Bewahren Sie das Token des Bots in einem Geheimnisspeicher auf, tauschen Sie es aus, falls es je durchsickert, und fügen Sie es nie in einen Chat ein.
• Verfolgen Sie Discords Änderungsprotokoll für Entwickler. Plattformänderungen werden angekündigt, und ein Bot, den niemand pflegt, hört still auf zu funktionieren.

Wissen, ob es funktioniert hat

Legen Sie vor dem Livegang fest, wie Erfolg aussieht, damit die nächste Funktion nach Belegen gewählt wird und nicht danach, wer am lautesten fragt. Das meiste davon kann der Bot für Sie zählen.

• Onboarding: wie viele Menschen beitreten, wie viele die Verifizierung abschließen und wie viele in der ersten Woche wieder gehen.
• Moderation: Aktionen pro Woche, Wiederholungstäter und wie lange eine Meldung wartet, bis jemand handelt.
• Support: geöffnete Tickets, Zeit bis zur ersten Antwort, Zeit bis zum Schließen und welche Fragen immer wiederkommen.
• FAQ-Befehle: welche Antworten am meisten genutzt werden und welche Fragen trotzdem einen Menschen erreichen. Das sind die nächsten Antworten, die Sie schreiben sollten.

Prüfen Sie, was Discord schon kann, bevor Sie dafür bezahlen. Community-Server haben eingebaute Onboarding-Fragen und AutoMod, und für einen kleinen Server kann das genügen. Ein eigener Bot sollte tun, was diese nicht können: Ihre Regeln, Ihre Aufzeichnungen und Verbindungen zu Ihren eigenen Systemen.

Eine Checkliste für Ihr Briefing

1. 01

   Benennen Sie die Aufgaben

   Listen Sie auf, was Moderatoren und Manager jede Woche von Hand tun und wie lange es dauert.

2. 02

   Wählen Sie die ersten fünf

   Nehmen Sie die Funktionen, die die meiste Zeit sparen und den wenigsten Zugriff brauchen.

3. 03

   Entscheiden Sie, wer was bearbeitet

   FAQ-Texte, Rollenmenüs, Begrüßungsnachrichten und Protokollkanäle sollten Mitarbeitende ohne Entwickler bearbeiten können.

4. 04

   Schreiben Sie den nötigen Zugriff auf

   Intents und Berechtigungen, und warum jede gebraucht wird. Das beschleunigt die Prüfung und hält den Bot sicher.

5. 05

   Planen Sie den Betrieb

   Hosting, Überwachung, Sicherungen und wen man anruft. Ein Bot ist ein Dienst, keine einmalige Datei.