Fehlerbehebung

Allgemeine Probleme

Der Bot ist offline oder reagiert nicht

• Stelle sicher, dass der Bot in deinem Dashboard online ist.
• Versuche den Bot über den Neuladen-Knopf im Dashboard neu zu starten.
• Überprüfe, ob der Bot auf deinen Server eingeladen wurde und die erforderlichen Berechtigungen hat.

Befehle werden nicht angezeigt

• Stelle sicher, dass die Funktion, die zum Befehl gehört, in deinem Dashboard aktiviert ist.
• Überprüfe, ob der Bot die Berechtigung hat, Slash-Befehle auf deinem Server zu registrieren.
• Versuche den Bot zu entfernen und erneut über den Einladungslink in deinem Dashboard einzuladen.

Der Bot sendet keine Nachrichten

• Überprüfe, ob der Bot die Berechtigungen "Nachrichten senden" und "Links einbetten" in den entsprechenden Kanälen hat.
• Wenn du Ticket-Kategorien verwendest, stelle sicher, dass der Bot die Berechtigung hat, Kanäle in der Kategorie zu verwalten.

Modmail-Probleme

Nutzer können keine Tickets per DM öffnen

• Überprüfe, ob Modmail in deinem Dashboard aktiviert ist.
• Stelle sicher, dass der Wartungsmodus nicht aktiviert ist.
• Überprüfe, ob der Nutzer nicht auf der Blockierungsliste steht.
• Stelle sicher, dass der Nutzer einen gemeinsamen Server mit dem Bot hat und DMs aktiviert sind.
• Wenn Öffnungszeiten konfiguriert und "Nachrichten-Verarbeitung außerhalb Öffnungszeiten komplett deaktivieren" aktiviert ist, können außerhalb der Öffnungszeiten keine Tickets erstellt werden.

Ticket-Kanäle werden nicht erstellt

• Überprüfe, ob die konfigurierte Ticket-Kategorie existiert und der Bot die Berechtigung "Kanäle verwalten" darin hat.
• Stelle sicher, dass die Kategorie nicht voll ist (Discord begrenzt Kategorien auf 50 Kanäle).

Nachrichten werden nicht weitergeleitet

• Überprüfe, ob der Ticket-Kanal noch existiert und der Bot die Berechtigung hat, dort Nachrichten zu senden.
• Stelle sicher, dass der Wartungsmodus nicht aktiviert ist.
• Überprüfe, ob der Nutzer nicht blockiert wurde.

Ticket-System-Probleme

Nutzer können keine Tickets öffnen

• Überprüfe, ob das Ticket-System in deinem Dashboard aktiviert ist.
• Stelle sicher, dass der Wartungsmodus nicht aktiviert ist.
• Überprüfe, ob der Nutzer nicht auf der Blockierungsliste steht.
• Wenn "Nur ein Ticket pro Nutzer erlauben" aktiviert ist, hat der Nutzer möglicherweise bereits ein offenes Ticket.
• Wenn Ticket-Themen mit benötigten Rollen konfiguriert sind, überprüfe, ob der Nutzer die erforderlichen Rollen hat.
• Wenn Öffnungszeiten konfiguriert sind, überprüfe, ob der Support-Bot gerade geschlossen ist.

Ticket-Eröffnungsnachrichten erscheinen nicht

• Stelle sicher, dass du mindestens eine Ticket-Eröffnungsnachricht in deinem Dashboard konfiguriert hast.
• Überprüfe, ob der Bot die Berechtigung hat, im konfigurierten Kanal Nachrichten zu senden.
• Lade den Bot nach Konfigurationsänderungen neu.

Ticket-Claiming funktioniert nicht

• Überprüfe, ob Ticket-Claiming in deinem Dashboard aktiviert ist.
• Stelle sicher, dass der Claim-Knopf aktiviert ist, wenn Teammitglieder per Knopf claimen sollen.
• Überprüfe, ob der Benachrichtigungskanal existiert und der Bot die Berechtigung hat, dort Nachrichten zu senden.

Sprachsupport-Probleme

Die /voice-Befehle werden nicht angezeigt

• Sprachsupport ist eine Early-Access-Preview. Die /voice-Befehle werden nur registriert, solange der Serverinhaber den Early-Access-Perk der ScootKit-Mitgliedschaft besitzt.
• Stelle sicher, dass Sprachsupport in deinem Dashboard aktiviert ist.
• Lade den Bot nach dem Umschalten der Early-Access- oder „Sprachsupport aktivieren"-Schalter neu - die Slash-Befehlsliste wird erst beim Neustart des Bots aktualisiert.

Sprachsupport bleibt offline

• Prüfe den Status-Modus. Im Modus staff-presence ist Sprachsupport geschlossen, bis mindestens ein Teammitglied einem Kanal in der Support-Kategorie beitritt. Im Modus opening-hours ist er außerhalb der konfigurierten Öffnungszeiten geschlossen.
• Stelle sicher, dass ein Mitglied einer Team-Rolle in einem Sprachkanal innerhalb der Support-Kategorie verbunden ist (nicht im Warteschlangen-Kanal selbst).
• Wenn du Sprachsupport gerade aktiviert hast, warte bis zu 60 Sekunden auf die Aktualisierung des Dashboard-Embeds - der Status-Ticker läuft einmal pro Minute.

Nutzer erhalten keine Positions-DMs

• Der Nutzer muss Direktnachrichten von Server-Mitgliedern in den Discord-Datenschutzeinstellungen aktiviert haben. Der Bot kann keinen Nutzer anschreiben, dessen DMs für den Server geschlossen sind.
• Prüfe, ob der Nutzer tatsächlich dem Warteschlangen-Sprachkanal beigetreten ist - nicht direkt einem Support-Kanal.
• Wenn Positions-Updates mittendrin aufhören anzukommen, hat der Nutzer möglicherweise die ursprüngliche DM-Nachricht gelöscht; der Bot bearbeitet die bestehende DM, statt eine neue zu senden.

„Nächsten Nutzer holen"-Knopf reagiert nicht / ist ausgegraut

• Der Knopf ist deaktiviert, solange Sprachsupport offline oder die Warteschlange leer ist - prüfe den Status im Dashboard-Embed.
• Das klickende Teammitglied muss in einem Support-Kanal sitzen (jeder Sprachkanal in der Support-Kategorie außer dem Warteschlangen-Kanal). Klicks aus dem Warteschlangen-Kanal werden absichtlich ignoriert - die Warteschlange ist für Nutzer, nicht für das Team.
• Bestätige, dass das klickende Mitglied eine der konfigurierten Team-Rollen hat.

Wartemusik spielt nicht

• Prüfe, ob Wartemusik aktivieren eingeschaltet ist und mindestens ein Track im Wartemusik-Abschnitt konfiguriert ist.
• Wenn drei Tracks in Folge fehlschlagen, deaktiviert der Bot die Wiedergabe automatisch und postet einen Hinweis im Dashboard-Kanal. Korrigiere oder ersetze die fehlerhaften URLs und aktiviere die Musik wieder.
• Mit aktiviertem Bot nur beitreten lassen, wenn jemand in der Warteschlange ist verbindet sich der Bot erst, wenn ein Nutzer dem Warteschlangen-Kanal beitritt - eine leere Warteschlange bedeutet beabsichtigt keine laufende Musik.
• KI-generierte Tracks, die nach dem Löschen aus der Dateibibliothek 404 zurückgeben, schlagen bei der Wiedergabe fehl - generiere sie erneut oder lade eine Ersatzdatei hoch.

Warteschlangen-Kanalname wechselt nicht zwischen Offen/Offline

• Stelle sicher, dass Warteschlangen-Kanal bei Zustandswechsel umbenennen eingeschaltet ist und beide Online-/Offline-Namen gesetzt sind - ein leerer Zielname überspringt diesen Übergang einfach.
• Discord begrenzt Kanal-Umbenennungen auf 2 pro 10 Minuten. Der Bot erzwingt auf seiner Seite eine 4-minütige Abkühlzeit; schnelle Offen/Offline-Wechsel können eine Umbenennung verzögern, bis die Abkühlzeit abgelaufen ist.
• Bestätige, dass der Bot die Berechtigung Kanäle verwalten am Warteschlangen-Kanal hat.

Forum-Support-Probleme

Neue Forum-Threads werden nicht bearbeitet

• Stelle sicher, dass Forum-Support aktiviert und der Forum-Kanal auf der Seite Forum-Kanäle hinzugefügt ist.
• Der Kanal muss ein Discord-Forum-Kanal sein - kein normaler Textkanal.
• Prüfe die Berechtigungen des Bots im Forum-Kanal: Er braucht Kanal ansehen, Nachrichten in Threads senden, Öffentliche Threads erstellen, Threads verwalten und Nachrichten verwalten.
• Es werden nur Threads automatisch erfasst, die nach dem Aktivieren von Forum-Support erstellt wurden.

Die /forum-Befehle werden nicht angezeigt

• Die Befehle erscheinen nur, wenn Forum-Support aktiviert und das Feature für deinen Server verfügbar ist (Early Access).
• Discord kann ein paar Minuten brauchen, um Slash-Befehle zu aktualisieren - starte deinen Discord-Client vollständig neu.

Das Team-Warteschlangen-Panel erscheint nicht

• Lege in der Konfiguration einen Kanal für das Warteschlangen-Panel fest.
• Der Bot braucht die Berechtigung, in diesem Kanal Nachrichten zu senden und zu bearbeiten.

Mitglieder können nicht in ihrem eigenen Thread antworten

• Wenn du Sperren bis beansprucht aktiviert hast, bleibt der Thread gesperrt, bis ein Teammitglied ihn beansprucht - das Beanspruchen entsperrt ihn automatisch. Siehe Claiming.

Nachrichten anderer Mitglieder werden immer wieder gelöscht

• Das ist die Option Nur Ersteller und Team dürfen schreiben. Schalte sie in der Konfiguration aus, wenn alle kommentieren dürfen sollen.

Priority-Threads kommen nicht in der Warteschlange nach vorn

• Priorität ergibt sich aus einem als priorisiert markierten Thema oder aus den Priority-Einstellungen eines Forum-Kanals (Priority-Rollen oder -Tag). Stelle sicher, dass eines davon konfiguriert ist.

Feedback oder Schließ-DMs werden nicht gesendet

• Das Mitglied hat möglicherweise DMs deaktiviert - der Bot kann Nutzern, die Direktnachrichten blockieren, nichts senden.
• Prüfe beim Feedback, dass es aktiviert ist und der Thread länger als die konfigurierte Mindestdauer bestand.

AI-FAQ-Probleme

Der AI-FAQ-Bereich fehlt in meinem Dashboard

• AI FAQ ist eine Early-Access-Beta. Wenn du den Bereich nicht siehst, ist dein Server noch nicht in der Beta - fordere Zugang über das Kontaktformular an.
• Dein Support-Bot muss v3 oder neuer sein - ältere Versionen enthalten AI FAQ nicht.

Die KI beantwortet keine Fragen

• Schalte den Hauptschalter ein: Einstellungen → AI FAQ auf diesem Server aktivieren.
• Der Hauptschalter allein bewirkt nichts - du musst der KI auch sagen, wo sie antworten soll. Aktiviere die Kanal-Auto-Antwort und/oder den Pre-Ticket-Gatekeeper.
• Die KI antwortet aus deiner Wissensdatenbank. Wenn du noch keine FAQ-Einträge geschrieben hast, hat sie nichts, worauf sie antworten kann.
• Stelle sicher, dass du noch KI-Credits hast (siehe unten).

Die KI hat plötzlich aufgehört zu antworten

• Wahrscheinlich sind deine KI-Credits aufgebraucht. Jede Antwort kostet Credits - prüfe Einstellungen → Status auf der AI-FAQ-Seite. Dein monatliches Guthaben wird am 25. aufgefüllt, oder du kaufst Credits nach. Siehe Credits & Preise.

Die Antworten sind unpassend oder nicht hilfreich

• Die KI antwortet nur aus deinen FAQ-Einträgen - füge klarere, spezifischere Einträge hinzu, die abdecken, was deine Mitglieder wirklich fragen.
• Nutze die Insights, um zu sehen, was gefragt wird und wo die Antworten zu kurz greifen.

Brauchst du noch Hilfe?

Wenn dein Problem hier nicht aufgelistet ist, erstelle gerne ein Ticket auf unserem Discord-Server - wir helfen dir gerne weiter!