Permissions verstehen

Wenn du Chatlix mit Twitch verbindest, fordert Chatlix eine feste Liste von Scopes an — das sind die Rechte, die Twitch deinem Account für die Chatlix-App freigibt. Diese Seite listet alle 19 Scopes auf, die Chatlix im Standard-Connect-Flow anfragt, plus was jeder davon konkret ermöglicht.

Anders als früher an dieser Stelle beschrieben: Chatlix fragt beim ersten Connect alle Scopes auf einmal an, unabhängig davon, welche Features du im Plan aktiviert hast. Das vereinfacht spätere Feature-Aktivierungen (kein Reconnect nötig), heißt aber auch: die Twitch-Zustimmungsseite zeigt dir immer die volle Liste.

Die vollständige Scope-Liste

`chat:read`

Was: liest Chat-Nachrichten in deinem Channel.
Wofür: Command-Reaktionen (!befehl), Chat-Filter-Trigger, Stream-Memory-Chat-Highlights.

`chat:edit`

Was: erlaubt das Schreiben von Chat-Nachrichten.
Wofür: wird für den zentralen Chatlix-Bot-Account (chatlix_bot) genutzt, über den Bot-Antworten, Begrüßungen und automatische Reaktionen laufen (siehe Twitch verbinden, Abschnitt Bot-Account). Der Scope wird trotzdem bei deinem eigenen Account mit angefragt, u. a. als Fallback, falls der Bot in deinem Channel keine Schreibrechte hat.

`user:read:chat`

Was: liest Chat über die neuere User-zentrierte API-Variante, inklusive Nachrichten-Metadaten.
Wofür: wird intern u. a. genutzt, um channel.chat.notification-Events zu bekommen — darüber erkennt Chatlix zum Beispiel Prime-Gaming-Subs, die über den normalen Sub-Event-Typ nicht sauber unterscheidbar wären.

`channel:moderate`

Was: allgemeiner Moderations-Lesezugriff (u. a. Moderationsaktionen im Chat sehen).
Wofür: Grundlage für Chat-Filter- und Moderations-Automationen, die auf bestehende Mod-Aktionen reagieren.

`moderator:manage:banned_users`

Was: Timeout, Ban, Untimeout, Unban aussprechen.
Wofür: Moderations-Automationen (z. B. automatischer Timeout bei Spam-Erkennung, Shield-Patterns).

`moderator:manage:chat_messages`

Was: einzelne Chat-Nachrichten löschen.
Wofür: Chat-Filter, die einzelne Nachrichten entfernen statt gleich den ganzen Nutzer zu timeouten. Intern wird dieser Endpoint teils auch für Timeouts wiederverwendet, wenn kein neuer OAuth-Reconnect ausgelöst werden soll.

`moderator:manage:chat_settings`

Was: Slow-Mode, Emote-Only, Follower-Only, Subscriber-Only umschalten.
Wofür: Chat-Moderation per Automation oder manuellem Dashboard-Toggle (z. B. „Slow-Mode an, wenn Chat zu schnell wird“).

`channel:manage:vips`

Was: VIP-Status vergeben/entziehen.
Wofür: die Chat-Commands !vip / !unvip (broadcaster-only) — nicht über ein Dashboard-Formular, sondern per Chat-Befehl.

`channel:manage:moderators`

Was: Moderator-Status vergeben/entziehen.
Wofür: die Chat-Commands !mod / !unmod (broadcaster-only) — kein Dashboard-Formular. Wichtig auch dafür, den Chatlix-Bot-Account selbst zum Moderator in deinem Channel zu machen (das läuft aber weiterhin über den regulären Twitch-/mod-Befehl, nicht über diesen Scope).

`channel:read:redemptions`

Was: liest Channel-Point-Reward-Einlösungen.
Wofür: damit Chatlix mitbekommt, wann jemand einen Reward einlöst (z. B. „TTS abspielen“, „AI-Bild generieren“). Ohne diesen Scope funktioniert keine Reward-Automation.

`channel:manage:redemptions`

Was: anlegen, ändern, löschen von Channel-Point-Rewards; Einlösungen als FULFILLED oder CANCELED markieren.
Wofür: Reward-Verwaltung direkt aus dem Chatlix-Dashboard und automatisches Abschließen/Refunden nach Ausführung.

`channel:read:subscriptions`

Was: liest deine Subscriber-Liste und Sub-/Resub-/Gift-Sub-Events.
Wofür: Sub-Alerts, Sub-Goals, Sub-Counter im Overlay.

`bits:read`

Was: liest Cheer-Events (Bits).
Wofür: Bit-Alerts, Bit-Goals, Cheer-Trigger in Automationen.

`channel:read:hype_train`

Was: liest Hype-Train-Start/-Fortschritt/-Ende.
Wofür: Hype-Train-Overlays und -Alerts.

`channel:read:polls`

Was: liest Poll-Start/-Fortschritt/-Ende und Ergebnisse.
Wofür: Poll-Overlays, die live mitlaufen, wenn du über Twitch selbst eine Poll startest. Wichtig: Es gibt aktuell keinen channel:manage:polls-Scope in der Standard-Liste — Chatlix kann Polls also nur anzeigen/mitverfolgen, aber nicht selbst starten oder beenden. Gleiches gilt für Predictions: die werden von Chatlix derzeit gar nicht per EventSub abonniert.

`moderator:read:followers`

Was: liest die Follower-Liste (Moderator-Sicht, nicht öffentlich).
Wofür: präzise Follower-Alerts mit Zeitstempel, Follow-Goals. Twitch hat den öffentlichen Follower-Endpoint abgeschafft — ohne diesen Scope siehst du Follows gar nicht in Echtzeit.

`channel:read:ads`

Was: liest Ad-Break-Status und -Zeitpunkte.
Wofür: Ad-Break-Automation (Overlay-Countdown, automatische Aktionen rund um Werbeunterbrechungen).

`user:read:email`

Was: liest deine bei Twitch hinterlegte E-Mail-Adresse.
Wofür: Account-Abgleich/Support, z. B. um deinen Chatlix-Account eindeutig deinem Twitch-Account zuzuordnen.

`clips:edit`

Was: erstellt Clips in deinem Namen.
Wofür: „Clip erstellen“-Automationen bzw. Reward, der automatisch einen Clip vom aktuellen Moment auslöst.

Was es nicht (mehr) gibt

channel:manage:broadcast (Titel/Spiel/Tags ändern) ist nicht Teil der aktuellen Standard-Scope-Liste. Falls du dich an eine Auto-Titel-Update-Funktion über einen Game-Watcher erinnerst: die ist entweder nie in dieser Form live gegangen oder wurde entfernt — verlass dich für Titel-/Spiel-Änderungen aktuell nicht auf Chatlix, das läuft weiterhin direkt über Twitch oder deine Streaming-Software.

Moderator-Aktionen

Manche Aktionen kannst du nur ausführen, wenn du Moderator des Ziel-Channels bist (oder Broadcaster). Beispiele:

Timeout / Ban / Unban
Chat-Nachricht löschen
Slow-Mode, Emote-Only, Follower-/Subscriber-Only togglen
VIP-/Moderator-Status vergeben

Chatlix führt diese Aktionen entweder über deinen eigenen Broadcaster-Token oder über den zentralen Bot-Account aus (siehe Twitch verbinden). Voraussetzung ist in beiden Fällen, dass der jeweilige Account (dein Account bzw. der Bot) auf dem Ziel-Channel tatsächlich Moderator-Rechte hat. Schlägt eine Aktion mangels Berechtigung fehl, liefert Twitch einen entsprechenden API-Fehler zurück, den Chatlix im Dashboard bei der jeweiligen Aktion anzeigt — es gibt dafür keinen einzelnen, festen Fehlercode wie früher hier beschrieben, sondern die konkrete Twitch-Fehlermeldung wird durchgereicht.

Der Streamer / Broadcaster ist auf seinem eigenen Channel automatisch berechtigt — er muss sich nicht selbst zum Moderator machen.

Scopes nachträglich erweitern

Weil Chatlix inzwischen alle Scopes auf einmal beim Erst-Connect anfragt, brauchst du für neue Standard-Features in der Regel keinen Reconnect mehr. Ausnahme: einzelne fortgeschrittene Aktionen (z. B. Ad-Break-Automation, VIP-Verwaltung) prüfen zum Ausführungszeitpunkt zusätzlich, ob der jeweils nötige Scope tatsächlich vorhanden ist. Fehlt er — etwa weil du deinen Account vor einer Scope-Erweiterung verbunden hast — zeigt das Dashboard einen Banner:

Dieses Feature braucht einen zusätzlichen Twitch-Scope. Bitte Twitch neu verbinden.

Dann den Flow aus Twitch verbinden erneut durchlaufen — Twitch zeigt dir bei einem Reconnect grundsätzlich wieder die volle angefragte Scope-Liste zur Bestätigung an.

Rechte einsehen / entziehen

Auf Twitch direkt: https://www.twitch.tv/settings/connections. Dort siehst du die Chatlix-App und kannst sie komplett entziehen. Folge: dein Access- und Refresh-Token werden bei Twitch ungültig, der nächste Refresh-Versuch von Chatlix schlägt fehl, und du wirst zur Reauth aufgefordert (siehe Reauth + Token-Erneuerung).