Direkt zum Hauptinhalt

Rewards Grundlagen

Rewards verbinden Twitch-Channel-Points mit Chatlix-Actions. Wenn ein Zuschauer auf deinem Kanal einen Channel-Points-Reward einlöst, feuert Chatlix eine Aktion, die du dafür hinterlegt hast — z. B. ein Overlay-Alert, ein OBS-Szenenwechsel, ein Source-Toggle, ein Screenshot oder ein Mute/Unmute einer Audio-Quelle.

Wichtiger Hinweis vorab: Im Dashboard gibt es drei verschiedene Dinge, die „Rewards" heißen. Verwechsle sie nicht — das ist die häufigste Quelle für Verwirrung in diesem Bereich:

  • /dashboard/reward-bindings (Menüpunkt „Channel Points") — darum geht es in diesem Buch: Twitch-Channel-Points-Redeems an Chatlix-Aktionen binden.
  • /dashboard/stream-store (Menüpunkt „Stream Store") — ein separater Shop, in dem Zuschauer Loyalty-Punkte (die interne Chatlix-Währung, siehe unten) gegen von dir angelegte Items eintauschen, mit optionalem Approve/Fulfill-Workflow. Technisch komplett getrennt von Twitch-Channel-Points.
  • /dashboard/rewards (Menüpunkt „Gutscheine & Rewards", unter System & Konto) — hat mit Twitch-Rewards nichts zu tun. Das ist dein eigenes Chatlix-Wallet: Gutscheine einlösen, Guthaben-Verlauf, Empfehlungsprogramm. Wenn du auf der Suche nach der Channel-Points-Bindung bist und in diesem Menü landest, bist du falsch — geh zu /dashboard/reward-bindings.

Voraussetzung: Twitch Affiliate oder Partner

Twitch-Channel-Points gibt es nur für Kanäle mit Affiliate- oder Partner-Status. Ohne diesen Status zeigt dir Twitch im Creator-Dashboard gar keine Option „Channel Points" an, und Chatlix bekommt entsprechend auch nichts zu binden. Das ist eine reine Twitch-Voraussetzung, Chatlix kann sie nicht umgehen. Wenn die Reward-Liste in Chatlix leer bleibt und die Fehlermeldung channel_points_unavailable auftaucht, ist das meist der Grund (siehe Reward erstellt aber nichts passiert).

Worum es geht

Der Reward selbst wird in Twitch angelegt (Kanalpunkte-Reward mit Titel, Kosten, Cooldown, Limits) — entweder direkt im Twitch-Creator-Dashboard, oder seit der Reward-Create-Welle auch direkt aus Chatlix heraus, wenn du den zusätzlichen OAuth-Scope channel:manage:redemptions erteilt hast (siehe Reward erstellen). Chatlix sieht die Einlösung über Twitch-EventSub und bindet sie an eine deiner Actions. Diese Verknüpfung heißt Reward-Binding.

Standardmäßig braucht Chatlix zum reinen Lesen der Einlösungen nur den Scope channel:read:redemptions. Ohne den erweiterten Scope channel:manage:redemptions kann Chatlix Rewards weder erstellen noch Titel/Kosten bestehender Rewards ändern — das bleibt dann reine Twitch-Dashboard-Aufgabe.

Wo findest du das im Dashboard

  • /dashboard/reward-bindings — Übersicht aller Bindings (Twitch-Reward → Aktionen), Live-Liste deiner Twitch-Rewards, Verlaufs-Log. Menüpfad: Community aktivieren → Rewards & Loyalty → Channel Points.
  • /dashboard/channel-point-sets — „Channel-Point Sets": mehrere Reward-Bindings zu Sets gruppieren und automatisch nach erkanntem Spiel/Kategorie (de)aktivieren. Baut additiv auf den Bindings hier auf, siehe unten.
  • /dashboard/viewer-loyalty — Punkte, Streaks und Level deiner Zuschauer (das Loyalty-System, technisch getrennt von Twitch-Channel-Points).
  • /dashboard/stream-store — Loyalty-Punkte-Shop (siehe oben).

Die Aktionen, die ein Reward-Binding auslösen kann, sind bewusst schlank gehalten und decken sich nicht 1:1 mit allen Chatlix-Actions aus anderen Bereichen (z. B. Automations). Aktuell unterstützt:

  • Overlay anzeigen (overlay_alert) — feuert ein Event an ein bestimmtes Overlay.
  • Szene wechseln (obs_switch_scene) — OBS-Szenenwechsel per Chatlix Connect.
  • Source ein/aus (obs_toggle_source) — Sichtbarkeit einer OBS-Quelle umschalten.
  • Screenshot (obs_screenshot) — Screenshot einer OBS-Quelle.
  • Ton muten/unmuten (obs_mute_source) — Audio-Quelle stummschalten oder freigeben.

Sound, TTS und Automation-Trigger sind für Twitch-Reward-Bindings aktuell nicht verfügbar. Willst du sowas, hast du zwei Wege: (a) eine OBS-Szene/Source binden, die ihrerseits in OBS einen Filter/Sound triggert, oder (b) den Weg über den Loyalty-Punkte-Shop (Stream Store) nehmen, der zusätzlich soundboard_play als Action kennt — dann zahlen Zuschauer aber mit Loyalty-Punkten statt mit Twitch-Kanalpunkten.

Reward-Binding vs. Twitch-Channel-Points vs. Loyalty

  • Twitch-Channel-Points sind die Währung auf Twitch (lila Logo neben dem Chat). Zuschauer sammeln sie passiv beim Zuschauen und lösen sie gegen Custom Rewards ein.
  • Reward in Chatlix-Sprache (in diesem Buch) = ein Twitch-Channel-Points-Reward.
  • Reward-Binding = die Verknüpfung „dieser Twitch-Reward löst diese Chatlix-Aktion(en) aus". Ein Binding kann inzwischen mehrere Aktionen gleichzeitig auslösen (siehe Reward erstellen).
  • Loyalty-Punkte sind eine eigene Chatlix-Währung, komplett unabhängig von Twitch-Channel-Points. Sie werden im Stream-Store gegen selbst angelegte Items eingetauscht — nicht über Reward-Bindings.

Loyalty kurz angerissen

Loyalty ist ein separates System, taucht aber in der gleichen Menü-Gruppe „Rewards & Loyalty" auf:

  • Punkte: pro Minute Watchtime, plus Bonus für Chat-Aktivität.
  • Streaks: aufeinanderfolgende Tage, an denen ein Zuschauer in deinem Stream war.
  • Level: steigt automatisch bei Punkte-Schwellen.
  • Daily Bonus: einmal pro Tag, drückt den Streak.
  • Ranking: Top-Liste pro Kanal, kannst du im Overlay einblenden.

Die Loyalty-Auswertung findest du unter /dashboard/loyalty-analytics. Für Loyalty-Punkte-Rewards nutzt du den Stream Store, nicht die Reward-Bindings dieses Buchs.

Channel-Point Sets — wenn du viele Rewards spielabhängig steuern willst

Wenn du mehrere Spiele streamst und nicht willst, dass z. B. dein „Boss-Skip"-Reward auch läuft, wenn du gerade Just Chatting machst: /dashboard/channel-point-sets lässt dich Reward-Bindings zu Sets gruppieren und per Regel automatisch (de)aktivieren — nach erkanntem Spiel (exakt/enthält) oder Twitch-Kategorie. Das ist additiv, die einzelnen Bindings pflegst du weiterhin unter /dashboard/reward-bindings.

Routen / API (für Tüftler)

  • GET /v1/reward-bindings?channel_id=… — alle Bindings eines Kanals auflisten.
  • POST /v1/reward-bindings — Binding anlegen oder aktualisieren (Upsert über Reward-Titel).
  • DELETE /v1/reward-bindings/{id} — Binding entfernen.
  • POST /v1/reward-bindings/test — interner Chatlix-Test einer Binding-Aktion, ohne echte Twitch-Einlösung.
  • POST /v1/reward-bindings/dispatch — vom Worker aufgerufen, wenn eine echte Twitch-Einlösung reinkommt.
  • GET /v1/loyalty/ — Loyalty-Daten lesen (Punkte, Level, Streaks).
  • GET/POST/PATCH/DELETE /v1/loyalty/rewards — Stream-Store-Items verwalten (separates System, siehe oben).

Server-seitig läuft die Twitch-Reward-Bindung über Chatlix\Service\Rewards\RewardBindingService, das Matching einer Einlösung passiert primär über die interne Twitch-Reward-ID, mit case-insensitivem Titel-Abgleich als Fallback. Der Loyalty-Shop läuft separat über Chatlix\Service\Loyalty\LoyaltyRewardService.

Wann nutzt du Rewards, wann eine Event Reaction

  • Reward-Binding = Aktion gegen Kanalpunkte (Zuschauer bezahlt aktiv).
  • Event Reaction (/dashboard/events-reactions, Menüpunkt „Reaktionen") = Aktion bei Twitch-Events wie Sub, Bits, Follow, Raid (passiert „von selbst", kostet den Zuschauer nichts).

Wenn du willst, dass etwas auf jeden neuen Sub passiert, ist das eine Event Reaction, kein Reward. Auf derselben Seite /dashboard/events-reactions?tab=subscriptions siehst du übrigens auch den Status deiner Twitch-EventSub-Verbindung — praktisch, wenn Rewards nicht ankommen (siehe nächste Seite).

Nächste Schritte

  • Reward erstellen — Schritt-für-Schritt: Twitch-Reward anlegen (oder direkt aus Chatlix) und binden.
  • Reward erstellt aber nichts passiert — die häufigste Frage. Diagnose in mehreren Schritten inklusive aller Dispatch-Fehlercodes.
  • Reward-Limits — Twitch-seitige Limits vs. Chatlix-eigene Cooldown/Duplikat-Schutz-Einstellungen.