aslain.dev
0%
01 Hizmetler 02 Hakkımda 03 Projeler 04 Stack 05 Blog 06 İletişim
← Tüm makaleler Discord-Bots

Discord Bot Verifizierung: Der komplette Verified-Bot-Leitfaden

Dein Bot wächst, der Einladungslink wird von Hand zu Hand weitergereicht, und eines Tages bemerkst du, dass er keinen neuen Servern mehr beitreten kann. Genau hier kommt die Discord-Bot-Verifizierung ins Spiel. Discord verlangt eine offizielle Verifizierung von jeder Anwendung, die die Schwelle von 100 Servern überschreitet; ohne diesen Schritt kann dein Bot keinen Servern jenseits von 100 beitreten. In diesem Leitfaden erkläre ich genau, was an der Schwelle passiert, wie der Verifizierungsantrag funktioniert, wie die Freigabe der Privileged Intents dazu passt und welche praktischen Wege es gibt, den Prozess reibungslos zu durchlaufen.

Warum gibt es die 100-Server-Schwelle?

Discords Logik ist einfach: Ein kleiner Bot ist experimentell, aber ein Bot, der Hunderttausende von Nutzern erreicht, ist eine ernste Verantwortung. Bevor du 100 Server erreichst, kannst du frei entwickeln und testen; es ist keine Freigabe nötig. In dem Moment, in dem dein Bot seinem 100. Server beitritt, zerstört sich nichts selbst, aber von da an muss er den Status verified (verifiziert) erreichen, um weiterhin neuen Servern beizutreten. Die Verifizierung ist also eigentlich ein Meilenstein, den du einplanen solltest, solange der Bot noch klein ist; den Antrag bei Server 50 vorzubereiten ist weit angenehmer, als bei Server 99 in Panik zu geraten.

Vorbereitung vor dem Antrag

Der Verifizierungsantrag verlangt von dir, klar zu beschreiben, was dein Bot tut und wie er Daten nutzt. Halte Folgendes bereit, bevor du den Antrag öffnest:

  • Eine klare Bot-Beschreibung: Erkläre die Kernfunktion, welche Befehle er bietet und welche Daten er berührt, in einfacher Sprache.
  • Begründungen für Privileged Intents: Wenn du die Intents GUILD_MEMBERS, PRESENCE oder MESSAGE_CONTENT nutzt, erkläre mit einem konkreten Beispiel, warum jeder davon nötig ist.
  • Datenschutzerklärung und Nutzungsbedingungen: Für einen Bot, der Daten verarbeitet, sind diese inzwischen ein erwarteter Standard. Halte sie bereit, sei es nur als einfache Seite.
  • Team- / Identitätsangaben: Die Verifizierung kann verlangen, dass der Eigentümer der Anwendung seine Identität bestätigt; dafür brauchst du ein gültiges Ausweisdokument.

Privileged Intents: der eigentliche Kern der Verifizierung

Die meisten Entwickler denken, bei der Verifizierung gehe es nur darum, "das Serverlimit freizuschalten", während der wirklich anspruchsvolle Teil die Freigabe der Privileged Intents ist. Discord setzt drei datenschutzsensible Gateway-Intents ab:

  • GUILD_MEMBERS — die Mitgliederliste, Beitritts-/Austritts-Events, Rollenänderungen.
  • GUILD_PRESENCES — der Online-Status der Nutzer und ihre Aktivitäten.
  • MESSAGE_CONTENT — der Textinhalt von Nachrichten (seit 2022 privileged).

Unter 100 Servern kannst du diese Intents im Developer Portal mit einem einzigen Klick aktivieren. Aber für einen verifizierten Bot musst du für jeden Privileged Intent eine separate Freigabe erhalten. Der häufigste Fehler hier ist, MESSAGE_CONTENT anzufordern, obwohl du es gar nicht brauchst. Wenn dein Bot rein über Slash Commands funktioniert, brauchst du in der Regel keinen Zugriff auf Nachrichteninhalte, und diesen Intent nicht anzufordern beschleunigt deinen Antrag.

Aktiviere im Code nur die Intents, die du wirklich nutzt. Eine typische minimale Einrichtung mit discord.js sieht so aus:

const { Client, GatewayIntentBits } = require('discord.js');

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    // MessageContent nur, wenn du Prefix-Befehle / Text lesen brauchst:
    GatewayIntentBits.MessageContent,
  ],
});

client.once('clientReady', () => {
  console.log(`Eingeloggt als: ${client.user.tag}`);
});

client.login(process.env.DISCORD_TOKEN);

Die goldene Regel hier: Der angeforderte Intent muss mit dem Intent in deinem Code übereinstimmen. Wenn du im Antrag sagst "Ich höre Member-Events für die Moderation ab", aber der GuildMembers-Intent in deinem Code nicht aktiviert ist, oder umgekehrt, dauert die Prüfung länger.

Der Antragsprozess Schritt für Schritt

  1. Öffne deine Anwendung im Developer Portal und prüfe unter dem Tab Bot, welche Privileged Intents aktiviert sind.
  2. Verschiebe deinen Bot nach Möglichkeit unter ein Team; das ist sowohl für die Sicherheit als auch für die organisatorische Sichtbarkeit gesünder.
  3. Fülle das Verifizierungsantragsformular aus: Bot-Beschreibung, Intent-Begründungen, Link zur Datenschutzerklärung.
  4. Schließe den Identitätsprüfungsschritt ab, falls verlangt.
  5. Reiche den Antrag ein und warte auf den Prüfungszeitraum. Dieser kann je nach Auslastung von wenigen Tagen bis zu mehreren Wochen reichen.

Praktische Tipps, um eine Ablehnung zu vermeiden

  • Mache Begründungen konkret. Statt "Ich brauche Mitgliederdaten" schreibe "Ich höre das GuildMemberAdd-Event ab, um neuen Mitgliedern beim Beitritt eine Willkommensrolle zuzuweisen".
  • Fordere keine zusätzlichen Intents an. Jeder aktivierte Privileged Intent bedeutet eine separate Begründung und eine zusätzliche Prüflast.
  • Kläre deine Datenaufbewahrungsrichtlinie. Speicherst du Nachrichteninhalte, und wie lange? Eine klare Antwort schafft Vertrauen.
  • Halte deinen Bot am Laufen. Ein Bot, der während der Prüfung nicht erreichbar ist oder Fehler wirft, hinterlässt einen schlechten Eindruck.
  • Beantrage früh. Beginne, bevor du 100 Server erreichst, damit dein Wachstumsmomentum nicht unterbrochen wird.

Was ändert sich nach der Verifizierung?

Nach der Freigabe erscheint ein Verified-Abzeichen im Profil deines Bots, und er kann frei Servern jenseits von 100 beitreten. Dieses Abzeichen beruhigt auch die Nutzer; wenn man einen unbekannten Bot hinzufügt, ist verifiziert zu sein ein ernsthafter Pluspunkt. Freigegebene Privileged Intents sind dauerhaft, aber wenn du das Verhalten des Bots erheblich änderst (zum Beispiel beginnst, neue Daten zu sammeln), wird von dir erwartet, dass du deinen Datenschutzversprechen treu bleibst. Die Verifizierung ist kein Ende, sondern der Anfang des Betriebs eines verantwortungsvollen Bots.

Häufige Fragen

Brauche ich eine Verifizierung, wenn mein Bot unter 100 Servern ist?

Nein. Unter 100 Servern ist die Verifizierung nicht verpflichtend, und du kannst Privileged Intents selbst im Developer Portal aktivieren. Wenn du jedoch zu wachsen planst, lohnt es sich, den Prozess früh zu lernen.

Kann ich einen Bot ohne den MESSAGE_CONTENT-Intent bauen?

Ja. Die meisten modernen Bots arbeiten mit Slash Commands, Buttons und Menüs; diese Interaktionen erfordern keinen Zugriff auf Nachrichteninhalte. Dieser Ansatz ist sowohl datenschutzfreundlich als auch leichter zu verifizieren.

Wie lange dauert die Verifizierung?

Es gibt keine feste Dauer; sie reicht meist von wenigen Tagen bis zu mehreren Wochen. Ein klarer Antrag, konkrete Begründungen und angeforderte Intents, die mit deinem Code übereinstimmen, beschleunigen den Prozess merklich.

Möchtest du deinen Bot auf die Verifizierung vorbereiten? Ob du eine saubere Intent-Architektur von Grund auf willst oder ich deinen bestehenden Bot für den Verifizierungsantrag vorbereiten soll — für einen soliden, nachhaltigen Discord-Bot nimm Kontakt mit mir auf.

Bu kategorideki tüm yazılar →

Devamı için