Twitch-Scopes verstehen
Twitch-Scopes verstehen
Chatlix verbindet sich über OAuth mit Twitch. Bei der Bestätigung in Twitch siehst du eine Liste von Berechtigungen, sogenannte Scopes. Chatlix fragt nicht pauschal alles ab, sondern nur die Scopes, die wir für die jeweils aktiven Features brauchen. Diese Seite erklärt, was jeder Scope tut und welcher Feature-Bereich darauf aufsetzt.
Lese-Scopes (Events empfangen)
-
chat:read— Chat-Nachrichten in deinem Channel mitlesen. Pflicht für jedes Chat-bezogene Feature: Chat-Overlay, Chat-Commands, Persona-Reaktionen auf Chat, Mini-Games mit Chat-Trigger. -
channel:read:redemptions— Channel-Points-Custom-Reward-Redemptions als Event empfangen. Pflicht für Channel-Points-getriebene Alerts, AI-Bild-Auslöser via Channel-Points, Reward-Queues. -
channel:read:subscriptions— Sub- und Resub-Events empfangen. Pflicht für Sub-Alerts mit korrekten Sub-Plan-Infos. Ohne diesen Scope siehst du Subs nur als allgemeine "Notification", aber nicht mit Tier/Plan. -
bits:read— Cheer/Bits-Events empfangen. Pflicht für Bits-Alerts, Bits-Tracker, Bits-getriebene Mini-Game-Trigger. -
moderator:read:followers— Follow-Events. Twitch hat hier 2023 umgestellt: Follow-Events sind nicht mehr Public, sondern erfordern diesen Mod-Scope. Ohne ihn keine Follow-Alerts.
Schreib-Scopes (aktiv handeln)
-
chat:edit— Im Namen deines Accounts in deinen Chat schreiben. Pflicht für Auto-Antworten, Bot-Messages, Persona-Outputs in Chat. -
channel:manage:redemptions— Custom-Rewards verwalten, Refunds setzen, Auto-Approve toggeln. Pflicht für Auto-Refund bei fehlgeschlagenen AI-Aktionen, Reward-Auto-Approve-Workflows. -
channel:manage:broadcast— Stream-Title, Game/Kategorie ändern. Optional. Brauchst du nur, wenn du Title/Game per Chatlix-Action wechseln willst (z.B. StreamDeck-Button "Just Chatting setzen"). -
channel:manage:moderators— Mods promoten/demoten. Optional. Default aus. Nur einschalten, wenn du wirklich aus Chatlix heraus Mod-Status setzen willst. -
channel:manage:vips— VIPs setzen/entfernen. Ebenfalls optional. Use-Case: Loyalty-Reward gibt automatisch VIP für einen Monat.
Was Chatlix damit macht
Für jeden Scope führt Chatlix intern Buch, welche Features ihn brauchen. Wenn du in /dashboard/integrations siehst, dass ein Scope fehlt, listet das UI gleich auf, welche Features dadurch deaktiviert sind. Beispiel: Fehlt moderator:read:followers, ist der Follow-Alert grau und mit dem Hinweis "Berechtigung fehlt — Twitch neu verbinden" beschriftet.
Scopes nachträglich hinzufügen
Twitch kann Scopes nicht inkrementell ergänzen. Wenn du einen zusätzlichen Scope freigeben willst (z.B. weil du jetzt VIP-Automatik nutzen möchtest), musst du:
/dashboard/integrations→« Twitch neu verbinden ».- Im Twitch-Dialog die jetzt erweiterte Scope-Liste bestätigen.
- Chatlix erkennt den neuen Scope und schaltet das passende Feature in der UI frei.
Der bisherige Token wird ersetzt, EventSub-Subscriptions werden re-provisioniert.
Was Chatlix nicht macht
Wir fragen keine Scopes ab, die wir nicht brauchen. Es gibt keinen "Master-Scope" und kein blindes all. Wenn du eine Berechtigung in einer dritten Anwendung nicht findest, liegt das in der Regel daran, dass das Feature dort schlicht nicht angeboten wird.
Privatsphäre
Lese-Scopes liefern uns Events, die Twitch ohnehin an unseren EventSub-Endpoint schickt. Wir speichern sie nur so lange, wie es für Statistiken, Audit-Log und Alert-Reproduktion nötig ist. Details stehen in der Datenschutzerklärung.