Twitch verbinden

Twitch verbinden

Um Twitch-Events (Subs, Bits, Rewards, Follower, Chat) in Chatlix zu nutzen, musst du deinen Twitch-Account einmalig verbinden. Das passiert über OAuth — du wirst auf twitch.tv weitergeleitet, bestätigst dort die Zugriffsrechte, und kommst zurück ins Dashboard.

Voraussetzungen

• Aktiver Chatlix-Account mit Streamer-Rolle.
• Twitch-Account (ein Affiliate- oder Partner-Status ist nicht zwingend, aber einige Features wie Subs / Bits funktionieren erst ab Affiliate).
• Du musst auf Twitch eingeloggt sein, bevor du den Flow startest — sonst Zwischenschritt mit Twitch-Login.

Flow

Dashboard → Integrations → Twitch → « Verbinden ».

Was im Hintergrund passiert:

1. Browser geht an /oauth/twitch/start.
2. Chatlix erzeugt einen state-Parameter (CSRF-Schutz), redirected zu https://id.twitch.tv/oauth2/authorize mit den nötigen Scopes.
3. Du loggst dich (ggf.) bei Twitch ein und siehst eine Zustimmungs-Seite mit der Liste der Berechtigungen.
4. « Authorize » schickt dich zurück an /oauth/twitch/callback.
5. Chatlix tauscht den code gegen Access- und Refresh-Token, speichert sie verschlüsselt, registriert die nötigen EventSub-Subscriptions.
6. Im Dashboard siehst du jetzt „Verbunden als <dein-twitch-name>“.

Wenn das Dashboard nach dem Callback eine Fehlermeldung zeigt: siehe Seite Reauth + Token-Erneuerung.

Was Chatlix tatsächlich anfordert

Chatlix fragt nur die Scopes ab, die du wirklich brauchst — abhängig davon, welche Features du nutzt. Wenn du in deinem Plan zum Beispiel keine Moderator-Aktionen aktiviert hast, fragt Chatlix den Moderator-Scope auch nicht ab. Welche Scopes potenziell auftauchen können, steht auf der Seite Permissions verstehen.

EventSub-Webhook

Nach erfolgreicher Verbindung registriert Chatlix automatisch EventSub-Subscriptions für die Event-Typen, die du nutzt. Twitch sendet diese Events dann an /webhook/twitch/eventsub (Chatlix-API). Du musst dafür nichts konfigurieren.

Wenn du Events vermisst (z. B. Sub-Alerts kommen nicht an):

1. Dashboard → Integrations → Twitch → « Diagnose ». Zeigt alle aktiven Subscriptions an.
2. Wenn dort etwas auf revoked oder failed steht: « Subscriptions neu registrieren ».
3. Wenn das nicht hilft: Token könnte abgelaufen sein → Reauth.

Mehrere Channels / Multi-Account

Pro Chatlix-Account ist genau ein Twitch-Account verknüpft. Wenn du als Moderator für einen anderen Channel arbeitest: dein Twitch-Account muss dort als Moderator hinterlegt sein, dann kannst du die Moderator-Aktionen für diesen Channel ausführen (siehe Permissions verstehen).

Verbindung trennen

Dashboard → Integrations → Twitch → « Trennen ».

Das:

• löscht Access- und Refresh-Token aus Chatlix
• versucht, die EventSub-Subscriptions sauber abzumelden
• entzieht die App-Berechtigung auf Twitch-Seite nicht automatisch — das geht nur über die Twitch-Connections-Seite (https://www.twitch.tv/settings/connections)

Automationen, die Twitch-Trigger nutzen, laufen nach dem Trennen nicht mehr — bleiben aber gespeichert, falls du später wieder verbindest.

Häufige Probleme beim Verbinden

• „state mismatch“ — Cookies blockiert oder der Flow wurde in einem anderen Tab abgeschlossen. Im selben Browser, im selben Tab nochmal starten.
• „redirect_uri mismatch“ — du nutzt eine Custom-Domain, die nicht in der Twitch-App-Config steht. Sollte bei Standard-Setups nicht passieren; melde dich beim Support.
• „access_denied“ — du hast bei Twitch „Cancel“ geklickt. Nochmal starten und « Authorize » bestätigen.