Discord Troubleshooting

"Bot online" wird nicht angezeigt, obwohl ich den Bot eingeladen habe

Discord-Cache: Discord-Client neu starten oder F5.
Manche Server haben den Bot mit "View Channel"-Restriktion auf bestimmte Channels. Der Bot ist drin, kann aber keine Channels listen → im Dashboard sieht die Channel-Liste leer aus.
Lösung: dem Bot die Permission View Channels zumindest in den Channels geben, in denen er posten soll.
Im Dashboard steht der zuletzt bekannte Status als bot_status (not_invited, invited, online, missing_perms, removed) — bei missing_perms fehlt konkret eine Berechtigung, bei removed wurde der Bot aus dem Server geworfen.

Channel-Liste bleibt leer trotz Server-Invite

Der Bot ist auf dem Server, aber die View-Channel-Permission fehlt. Der API-Call dahinter liefert dann 403 oder ein leeres Array. Prüfe die Bot-Rolle in den Server-Settings.

Test-Post liefert 401 / 403

401 = Webhook-URL ist invalid (gelöscht oder resettet) — betrifft nur die Pure-Webhook-Variante.
403 = Bot-Permissions reichen nicht (z.B. Channel-spezifischer Permission-Overwrite verbietet dem Bot "Send Messages").
Wenn der Bot-Token selbst ungültig geworden ist (z.B. rotiert, aber nicht neu eingespielt), kommt ebenfalls ein 401 — das betrifft dann aber alle deine Channels gleichzeitig, nicht nur einen.

Test-Post liefert 429

Discord throttled. Tritt fast nur auf, wenn man Test-Post schnell wiederholt (Bot-Rate-Limit: 50 req/s global; Webhook: ca. 5 Posts / 2s pro Channel). Kurz warten, erneut testen. Test-Posts nicht in einer Schleife feuern — das kann den Bot global throttlen und damit auch echte Alerts verzögern.

Stream-Alert kommt nicht im Channel an, obwohl ich live bin

Channel-Mapping für Stream Alerts (Purpose stream_alerts) gesetzt? (Discord-Seite checken.)
Stream wirklich als "online" erkannt? Twitch-EventSub hat eine Verzögerung (typisch bis zu 60s, in Ausnahmefällen mehr).
Bot hat Send-Messages-Permission im Ziel-Channel?
Nicht verwechseln mit Sub-/Follow-/Mod-Events: die lösen aktuell keinen Discord-Post aus. Live sind nur stream.online, stream.offline, channel.raid sowie Shoutout-/Songrequest-/Giveaway-Trigger aus den jeweiligen Chatlix-Modulen.

"Refresh Token expired" im Dashboard

Dein OAuth-State ist ungültig geworden (z.B. weil du Chatlix in deinen Discord-User-App-Einstellungen deautorisiert hast, oder weil du im falschen Browser-Tab weitergeklickt hast). Lösung: im Dashboard Discord trennen, dann nochmal Discord verbinden. Deine Channel- und Role-Mappings bleiben dabei erhalten — die OAuth-Verbindung ist nur der Identifikations-Layer für die Server-Auswahl, nicht die Quelle der Bot-Aktionen (die laufen über den separaten Bot-Token).

Rollen ändern sich nicht, wenn jemand subbt/kündigt/VIP wird

Das ist aktuell kein Bug, sondern der dokumentierte Ist-Zustand: die automatische Rollenvergabe ist noch nicht gebaut, siehe Rollen syncen für die Details und den Grund (fehlender Twitch-Viewer↔Discord-User-Mapping-Layer). Das Role-Mapping im Dashboard speichert nur deine gewünschte Zuordnung für später.

Bot postet doppelt

Hast du für denselben Zweck (z.B. Stream-Alerts) gleichzeitig ein Bot-Channel-Mapping UND einen Pure-Webhook eingerichtet? Beide feuern dann unabhängig voneinander. Eines davon entfernen — siehe Discord Webhooks (ohne Bot).

Bot ist plötzlich offline / "Bot down"

Wenn der Status-Punkt rot ist:

Discord-Status prüfen: status.discord.com.
Bot wurde eventuell aus dem Server geworfen (bot_status = removed) — Mappings bleiben in der Datenbank erhalten, aber jeder Post-Versuch schlägt fehl, bis der Bot neu eingeladen wird.
Bot-Token bei uns rotiert? Im Support melden, wir prüfen die Backend-Logs (Bot-Token wird nie öffentlich ausgegeben).

Wo sehe ich, was der Bot zuletzt versucht hat?

Jede ausgehende Bot-Aktion (Post, Rollen-Änderung) wird intern mit Status ok/error/rate_limited/skipped geloggt. Ein Support-Ticket mit ungefährer Uhrzeit und betroffenem Server hilft uns, gezielt in diesem Log nachzuschauen.