Twitch-Scopes verstehen

Chatlix verbindet sich über OAuth mit Twitch. Beim Verbinden fragt Chatlix eine feste Liste von Scopes an — nicht mehr, aber auch nicht weniger, als für die aktuell gebauten Features nötig ist. Diese Seite listet jeden Scope und erklärt, welches Chatlix-Feature ihn braucht.

Die vollständige Scope-Liste

Chatlix fragt beim Connect-Flow exakt diese Scopes an (Stand aktueller Code, dem Backend):

• chat:read — Chat-Nachrichten mitlesen. Basis für Chat-Overlay, Chat-Commands, Smart Shield, Persona-Reaktionen.
• chat:edit — Chatlix darf selbst Nachrichten in deinen Chat schreiben (Bot-Antworten, Command-Ausgaben).
• user:read:chat — moderne Variante des Chat-Lesezugriffs, ergänzt chat:read für EventSub-basierte Chat-Events.
• channel:moderate — legacy Mod-Sichtbarkeit (welche User gerade Mod-Status haben).
• moderator:manage:banned_users — Bans/Timeouts/Unbans aktiv aussprechen. Pflicht für Smart Shield und manuelle Mod-Aktionen im Dashboard.
• moderator:manage:chat_messages — einzelne Nachrichten löschen / Chat leeren. Ohne diesen Scope kann Smart Shield Nachrichten zwar bewerten, aber nicht entfernen.
• moderator:manage:chat_settings — Slow-Mode, Follower-Only-Mode, Emote-Only-Mode umschalten.
• channel:manage:vips / channel:manage:moderators — VIP-/Mod-Status setzen. Wichtig: Das läuft (, Sprint 7D/7E) ausschließlich über die in Twitch-Chat getippten Commands !vip/!unvip und !mod/!unmod, broadcaster-only. Es existiert aktuell keine Dashboard-Oberfläche dafür (kein Treffer für „vip" in den Dashboard-Svelte-Quellen).
• channel:read:subscriptions — Sub-/Resub-Events inklusive Tier/Plan. Pflicht für korrekte Sub-Alerts.
• moderator:read:followers — Follow-Events empfangen.
• bits:read — Cheer/Bits-Events. Pflicht für Bits-Alerts und Bits-Tracker.
• channel:read:redemptions / channel:manage:redemptions — Channel-Points-Redemptions empfangen und eigene Custom Rewards anlegen/bearbeiten. Pflicht für Reward-Automation.
• channel:read:hype_train — Hype-Train-Events für entsprechende Alerts.
• channel:read:polls — Twitch-Poll-Ergebnisse einlesen.
• channel:read:ads — Ad-Break-Zeitpunkte, Basis für die Ad-Break-Automation.
• clips:edit — Twitch-Clips über die API erstellen. Von Clip Studio genutzt, um Kandidaten direkt als Twitch-Clip zu markieren.
• user:read:email — Account-Identifikation (E-Mail als eindeutiger Identifier), keine Marketing-Nutzung.

Scope-Gruppen und Teilausfälle

Wichtig zu verstehen: Chatlix prüft nicht nur „ist überhaupt ein Twitch-Token da", sondern unterscheidet drei Scope-Gruppen getrennt, sichtbar unter /v1/moderation/status:

• Moderation-Scopes (Ban/Timeout/Delete) — ohne die laufen Chat-Bot und Alerts weiter, aber Mod-Aktionen aus dem Dashboard und Smart-Shield-Auto-Aktionen schlagen fehl.
• Chat-Settings-Scopes (Slow-/Follower-Only-Mode) — betrifft die !slow/!followers/!emoteonly/!subscribers-Chat-Commands. Diese sind Twitch-Chat-Commands, keine Dashboard-Toggle-Buttons — im Dashboard-Frontend gibt es dafür keine UI.
• Reward-Manage-Scopes (Channel-Points-Rewards anlegen/bearbeiten) — betrifft nur die Reward-Verwaltung, nicht das Empfangen bestehender Redemptions.

Das erklärt ein häufiges Support-Ticket: „Mein Bot postet noch, aber Timeouts funktionieren nicht mehr" — meistens fehlt exakt die Moderation-Scope-Gruppe, z.B. weil beim letzten Twitch-Consent-Screen nicht alle Häkchen bestätigt wurden. Lösung und Diagnose-Weg: TWITCH_TOKEN_EXPIRED.

Was Chatlix bewusst nicht anfragt

Es gibt keinen Scope für Kontoeinstellungen, Zahlungsdaten oder das Löschen deines Twitch-Accounts — solche Scopes existieren bei Twitch entweder gar nicht oder werden von Chatlix schlicht nicht gebraucht und daher nicht angefragt. Wenn du beim Verbinden Scopes siehst, die dir hier nicht auflisted sind, kontaktiere den Support — das wäre ein Abweichen vom dokumentierten Verhalten.