Direkt zum Hauptinhalt

TWITCH_TOKEN_EXPIRED

Chatlix hält pro verbundenem Twitch-Account einen OAuth-Access-Token und einen Refresh-Token. Der Access-Token läuft nach wenigen Stunden ab, Chatlix erneuert ihn automatisch mit dem Refresh-Token. Schlägt diese Erneuerung fehl, kommt dieser Zustand — sichtbar meistens daran, dass Chat-Nachrichten, Channel-Point-Redemptions oder Sub-Events plötzlich nicht mehr ankommen und Mod-Aktionen aus dem Dashboard ins Leere laufen.

Wie der Refresh technisch läuft

Beim Erneuern prüft Chatlix vor jedem Twitch-API-Call, ob der Token in weniger als 60 Sekunden abläuft, und erneuert ihn dann proaktiv — inklusive Redis-Lock, damit nicht mehrere parallele Requests gleichzeitig denselben Refresh anstoßen. Im Normalfall merkst du davon nichts.

Schlägt der Refresh fehl, loggt Chatlix das intern als twitch_token_refresh_failed. Das ist das eigentliche Signal, dass du die Twitch-Verbindung neu herstellen musst.

Warum Twitch den Token invalidiert

  • Du hast unter twitch.tv/settings/connections den Eintrag „Chatlix" entfernt oder einzelne Berechtigungen widerrufen.
  • Du hast dein Twitch-Passwort geändert.
  • Twitch hat den Token aus Sicherheitsgründen invalidiert (selten).
  • Der Token wurde sehr lange nicht benutzt (z.B. Connect/Bot war wochenlang inaktiv).

Scope-abhängige Teilausfälle

Ein wichtiger Unterschied zur reinen „ganz oder gar nicht"-Logik: Chatlix prüft Scope-Gruppen getrennt voneinander unter /v1/moderation/status — MODERATION_REQUIRED_SCOPES (Ban/Timeout/Delete), CHAT_SETTINGS_REQUIRED_SCOPES (Slow-Mode, Follower-Only) und REWARD_MANAGE_REQUIRED_SCOPES (Channel-Points-Rewards anlegen/bearbeiten). Es kann also sein, dass dein Chat-Bot weiterhin normal postet, aber Timeouts aus dem Dashboard plötzlich fehlschlagen, weil nur die Moderation-Scopes beim letzten Reconnect fehlten. Das Dashboard zeigt dafür einen eigenen Reconnect-Hinweis pro betroffener Gruppe, nicht nur einen pauschalen „Twitch getrennt"-Banner.

Was Chatlix macht

  1. Bei fehlgeschlagenem Refresh markiert Chatlix die Integration als abgelaufen.
  2. Der Token wird nicht sofort gelöscht — du siehst weiterhin, dass eine Verbindung mal bestand.
  3. Alle Twitch-abhängigen Features (Chat-Bot, Smart Shield, Rewards, EventSub-Alerts) pausieren automatisch, statt mit Fehlern zu spammen.

Lösung

  1. Dashboard → /dashboard/twitch öffnen.
  2. „Trennen" klicken, danach „Mit Twitch verbinden" — das erzwingt einen kompletten neuen OAuth-Flow inkl. frischem Refresh-Token.
  3. Beim Twitch-Consent-Screen alle angefragten Scopes bestätigen — lehnst du einzelne ab, bekommst du genau die oben beschriebenen Teilausfälle. Details zu den einzelnen Scopes: Twitch-Scopes verstehen.
  4. Prüfe danach /v1/moderation/status bzw. die entsprechende Dashboard-Ansicht — dort siehst du grün/rot pro Scope-Gruppe.

Vorbeugen

Wenn du planst, deinen Twitch-Account länger nicht zu benutzen (Pause, Urlaub), lass die Chatlix-Verbindung trotzdem bestehen — der proaktive Refresh hält den Token frisch, solange kein manueller Widerruf passiert. Ein Passwortwechsel bei Twitch invalidiert aber in jedem Fall alle verbundenen Drittanbieter-Apps inklusive Chatlix; danach ist ein Reconnect Pflicht.