Permissions verstehen

Permissions verstehen

Wenn du Chatlix mit Twitch verbindest, fordert Chatlix bestimmte Scopes an — das sind die Rechte, die Twitch deinem Account für die Chatlix-App freigibt. Diese Seite erklärt, was jedes Recht bedeutet und wofür Chatlix es braucht.

Wichtig: Chatlix fragt nur die Scopes an, die nötig sind für die Features, die du aktiviert hast. Du wirst also nicht zwangsweise alle aus der Liste unten sehen.

Die Scopes im Detail

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. Plus: Reward-Einlösungen als FULFILLED oder CANCELED markieren.

Wofür: damit du Rewards direkt aus dem Chatlix-Dashboard verwalten kannst und Chatlix nach erfolgreicher Aktion den Reward als erledigt markieren (oder bei Fehler refunden) kann.

channel:read:subscriptions

Was: liest deine Subscriber-Liste und neue Sub-Events.

Wofür: Sub-Alerts, Sub-Goals, Sub-Counter im Overlay.

chat:read

Was: liest Chat-Nachrichten in deinem Channel.

Wofür: Command-Reaktionen (!befehl), Chat-Filter-Trigger, Stream-Memory-Chat-Highlights.

chat:edit

Was: schreibt Chat-Nachrichten als dein Account.

Wofür: Bot-Antworten, automatische Begrüßung, Reaktions-Nachrichten auf Events. Hinweis: Chatlix schreibt als dein Twitch-Account, nicht als separater Bot. Wenn du das nicht willst, lass diesen Scope weg und nutze einen eigenen Bot-Account, der separat verbunden wird.

bits:read

Was: liest Cheer-Events (Bits).

Wofür: Bit-Alerts, Bit-Goals, Cheer-Trigger in Automationen.

channel:manage:broadcast

Was: Titel, Spiel, Tags des Streams ändern.

Wofür: optional — z. B. Auto-Titel-Updates bei Game-Wechsel via Game-Watcher. Wenn du das nicht nutzt, brauchst du diesen Scope nicht.

moderator:read:followers

Was: liest die Follower-Liste (für Moderatoren, nicht öffentlich).

Wofür: präzise Follower-Alerts mit Zeitstempel, Follow-Goals. Twitch hat 2023 den öffentlichen Follower-Endpoint abgeschafft — ohne diesen Scope siehst du Follows nur grob.

Moderator-Aktionen

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

• Timeout / Ban
• Slow-Mode togglen
• Followers-Only togglen
• Shoutouts senden

Chatlix prüft das beim Auslösen der Aktion: wenn dein Twitch-Account auf dem Ziel-Channel keine Moderator-Rolle hat, kommt ein ok:false, error=not_a_moderator zurück.

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

Scopes nachträglich erweitern

Wenn du ein neues Feature aktivierst, das einen zusätzlichen Scope braucht (z. B. Bits-Alerts, nachdem du nur mit Subs angefangen hast), zeigt das Dashboard einen Banner:

Dieses Feature braucht den Scope bits:read. Bitte Twitch neu verbinden.

Dann den Flow aus Twitch verbinden erneut durchlaufen — Twitch zeigt nur die neuen Rechte zur Zustimmung an, die alten bleiben bestehen.

Rechte einsehen / entziehen

Auf Twitch direkt: https://www.twitch.tv/settings/connections. Dort siehst du die Chatlix-App und kannst sie komplett entziehen. Folge: Chatlix-Token wird invalidiert (TWITCH_TOKEN_EXPIRED), du wirst beim nächsten API-Call zur Reauth aufgefordert.