Whitelabel

Whitelabel ist ein Add-on zusätzlich zu Premium. Das Ticket-System läuft dann unter deiner eigenen Discord-Anwendung: Mitglieder sehen deinen Bot mit seinem Namen, Avatar und Status, in Panels, Tickets, DMs und in der Mitgliederliste. Das Dashboard, deine Panels und alle Einstellungen bleiben genau, wie sie sind.

#Bevor du anfängst

• Der Server braucht Premium. Whitelabel buchst du zusätzlich, pro Server.
• Du brauchst eine eigene Anwendung im Discord-Entwicklerportal. Sie und ihr Token gehören dir, wir betreiben den Bot für dich.
• Der Bot braucht die privilegierten Intents Server Members und Message Content. Discord lässt dich beide frei einschalten, solange der Bot auf weniger als 100 Servern ist. Größere Bots brauchen vorher die Verifizierung durch Discord.

#1. Anwendung anlegen

1. Öffne das Discord-Entwicklerportal (öffnet in einem neuen Tab) und leg eine neue Anwendung an. Ihr Name wird der Name des Bots.
2. Unter Bot setzt du auf Wunsch Avatar und Banner.
3. Unter Bot · Privileged Gateway Intents schaltest du Server Members Intent und Message Content Intent ein. Speichern.
4. Unter Bot schaltest du Requires OAuth2 Code Grant aus. Ist die Option an, funktioniert der Einladungslink nicht.
5. Unter Bot drückst du Reset Token und kopierst den Token. Discord zeigt ihn nur einmal.

Behandle den Token wie ein Passwort. Wer ihn hat, kann als dein Bot handeln. Poste ihn nie in Discord und schick ihn niemandem.

#2. Im Dashboard verbinden

1. Öffne deinen Server im Dashboard und geh zu Whitelabel.
2. Füg den Token ein und speichere. Er wird verschlüsselt gespeichert und nie wieder angezeigt, auch dir nicht. Wenn du ihn verlierst, setz ihn im Portal zurück und füg den neuen ein.
3. Die Seite zeigt den Zustand deines Bots. Nach ein paar Sekunden sollte dort online stehen.

#3. Bot einladen

Nutz den Einladungslink, den die Seite zeigt. Er fragt dieselben Rechte an wie der gemeinsame Bot, siehe Erste Schritte. Lass alle angehakt.

Lass den gemeinsamen Bot Roleplay+ ebenfalls auf dem Server. Es antwortet immer nur einer der beiden, und der gemeinsame Bot übernimmt wieder, wenn du Whitelabel pausierst oder Premium endet.

#4. Präsenz festlegen

Wähl, was Mitglieder neben deinem Bot sehen:

• Status: online, abwesend, bitte nicht stören oder unsichtbar.
• Aktivität: spielt, schaut, hört, tritt an, ein eigener Text oder keine, mit einem Text von bis zu 128 Zeichen. Standard ist schaut tickets.

#5. Name und Avatar

Name und Avatar deines Bots kannst du auch im Dashboard ändern, ohne das Entwicklerportal zu öffnen. Discord erlaubt zwei Namensänderungen pro Stunde. Eine dritte Änderung in dieser Stunde schlägt fehl, bis die Stunde vorbei ist.

#6. Alle Panels neu senden

Buttons und Menüs gehören dem Bot, der die Nachricht gesendet hat. Panels, die der gemeinsame Bot gesendet hat, zeigen auch nach dem Wechsel weiter auf ihn. Drück Alle Panels neu senden: Dein Bot postet jedes bekannte Panel neu, und die alten Nachrichten werden gelöscht.

Buttons in älteren Nachrichten, zum Beispiel in Tickets, die vor dem Wechsel schon offen waren, gehören weiter dem alten Bot. Reagiert einer davon nicht, nutz stattdessen den passenden Befehl, etwa $close.

#Ein Bot für mehrere Server

Eine Anwendung kann mehrere deiner Server bedienen. Jeder davon braucht sein eigenes Premium und sein eigenes Whitelabel-Add-on. Lade denselben Bot auf jeden Server ein und verbinde ihn auf der Whitelabel-Seite jedes Servers.

#Pausieren oder entfernen

• Pausieren schaltet den Server zurück auf den gemeinsamen Bot. Token, Präsenz und Einstellungen bleiben gespeichert, du kannst später zurückwechseln.
• Entfernen löscht den gespeicherten Token und schaltet den Server zurück auf den gemeinsamen Bot.
• Drück danach jeweils wieder Alle Panels neu senden, damit die Panels dem gemeinsamen Bot gehören.
• Endet Premium, fällt der Server von selbst auf den gemeinsamen Bot zurück. Sende auch dann die Panels neu.

#Grenzen

• Setzt Premium auf demselben Server voraus. Ohne Premium nutzt der Server den gemeinsamen Bot.
• Die Anwendung gehört dir. Löschst du sie, setzt den Token zurück oder schaltest einen Intent aus, geht dein Bot offline, bis du es auf der Whitelabel-Seite behebst.
• Nach jedem Wechsel zwischen deinem Bot und dem gemeinsamen Bot müssen die Panels neu gesendet werden.
• Discord erlaubt zwei Namensänderungen pro Stunde.

#Fehlerbehebung

#Der Zustand zeigt ungültiger Token

Discord hat den Token abgelehnt. Er wurde im Portal zurückgesetzt, nur zum Teil kopiert, oder die Anwendung wurde gelöscht. Setz den Token im Portal zurück, kopier ihn vollständig und füg ihn erneut ein.

#Der Zustand zeigt Intents nicht erlaubt

Discord hat die Verbindung abgelehnt, weil Server Members Intent oder Message Content Intent aus ist. Schalte beide unter Bot · Privileged Gateway Intents ein und speichere dann auf der Whitelabel-Seite, damit sich der Bot neu verbindet. Ist dein Bot auf 100 oder mehr Servern, muss Discord die Intents erst freigeben.

#Der Bot ist online, aber nichts passiert

Wahrscheinlich ist der Bot noch nicht auf dem Server. Lade ihn mit dem Link von der Whitelabel-Seite ein. Zeigt Discord beim Einladen einen Fehler, prüf, ob Requires OAuth2 Code Grant aus ist.

#Mitglieder sehen weiter den gemeinsamen Bot

Die Panels wurden vor dem Wechsel gesendet. Drück Alle Panels neu senden.