Direkt zum Hauptinhalt

Reward erstellt aber nichts passiert

Die häufigste Frage im Rewards-Bereich. Folg dieser Reihenfolge — sie deckt die allermeisten Fälle ab. Alle Schritte beziehen sich auf /dashboard/reward-bindings (nicht auf /dashboard/rewards — falsche Seite, siehe Rewards Grundlagen).

0. Grundvoraussetzungen

  • Bot aktiv? Ohne laufenden Bot zeigt die Seite nur „Kein Bot aktiv" mit Link zum Setup-Wizard — dann kann logischerweise auch kein Reward binden.
  • Affiliate/Partner-Status auf Twitch? Ohne diesen Status gibt es auf Twitch gar keine Channel Points. Die Live-Rewards-Liste in Chatlix zeigt dann den Fehler channel_points_unavailable (meist ein HTTP-404 von Twitch dahinter) — kein Chatlix-Bug, sondern Twitch-Voraussetzung.

1. Ist der Twitch-Reward aktiviert?

Geh ins Twitch-Creator-Dashboard → Channel Points → Manage Rewards. Schau, ob der Reward auf enabled steht. Ist er aus, wird er Zuschauern gar nicht erst angezeigt und Chatlix bekommt keine Einlösung zu sehen.

Zusätzlich: Wenn dein Stream offline ist und der Reward auf „Nur während Streams aktiv" gestellt ist, ist er für Zuschauer ebenfalls unsichtbar. Für Tests temporär auf „immer aktiv" stellen oder live gehen.

2. Kommt das Event überhaupt bei Chatlix an?

Direkt auf /dashboard/reward-bindings gibt es über der Bindings-Liste einen Hinweis-Kasten „Damit Einlösungen hier ankommen, muss die Twitch-EventSub-Verbindung aktiv sein" mit einem Link « Verbindung prüfen » zu /dashboard/events-reactions?tab=subscriptions. Schau dort zuerst nach dem Status der Redemption-Subscription.

Zusätzlich kannst du unter /dashboard/events (Event-Feed) das Live-Ereignis-Log aller Plattformen einsehen — lös den Reward einmal selbst ein und schau, ob überhaupt ein Ereignis reinkommt.

Wenn nichts auftaucht:

  • Die EventSub-Subscription für channel.channel_points_custom_reward_redemption.add ist evtl. abgelaufen oder nie angelegt worden (braucht den Scope channel:read:redemptions). Prüfe/erneuere unter /dashboard/events-reactions?tab=subscriptions.
  • Twitch-Konto erneut verknüpfen: Geh zu /dashboard/twitch (Twitch-Integration) und klick « Twitch neu verbinden » bzw. « Account neu verbinden ». Das führt dich über /oauth/twitch/login und du autorisierst Chatlix erneut mit allen benötigten Scopes.

Wenn der Event ankommt: Twitch/EventSub ist sauber, das Problem liegt im Binding oder in der Aktion selbst → weiter mit Schritt 3.

3. Binding-Matching prüfen

Chatlix matcht eine eingehende Einlösung zuerst über die interne Twitch-Reward-ID, und nur falls das nicht greift, über einen case-insensitiven Titel-Vergleich. Typische Fehlerquelle: Du hast den Reward-Titel in Twitch geändert, das Binding wurde aber ursprünglich per Hand mit dem alten Titel angelegt (ohne aus der Live-Liste gewählt zu werden) — dann läuft das Titel-Matching ins Leere. Korrigiere den Titel im Chatlix-Binding oder lösch es und leg es über die Live-Rewards-Liste neu an.

4. Ist das Binding überhaupt aktiv?

Jedes Binding hat oben einen Schalter „Aktiv/Pausiert". Steht er auf Pausiert, wird die Einlösung zwar geloggt (Response-Code binding_disabled), aber keine Aktion ausgeführt.

5. Action isoliert testen

Klick am Binding auf « ⚡ Test auslösen ». Das triggert nur die Aktion(en), ohne Twitch dazwischen (deaktiviert, solange das Binding pausiert ist).

  • Test funktioniert: Die Aktion ist technisch OK, das Problem lag in Twitch/EventSub/Matching (Schritte 2–3).
  • Test funktioniert nicht: Das Problem liegt in der Aktion selbst → weiter mit Schritt 6.

6. Aktions-spezifische Probleme

  • Overlay-Alert: Ist überhaupt ein Overlay am Binding ausgewählt? Ohne overlay_id wird die Aktion als Fehler no_overlay_binding geloggt. Ist eins gewählt, aber niemand sieht was: Der Overlay-Browser-Source muss in OBS geladen und aktiv verbunden sein — ist keiner subscribed, loggt Chatlix no_subscriber, die Aktion „verpufft" technisch erfolgreich, aber ohne Zuschauer.
  • OBS-Aktionen (Szene, Source-Toggle, Screenshot, Mute): Ist Chatlix Connect zu OBS online? Ganz oben auf /dashboard/reward-bindings erscheint ein roter Banner „Chatlix Connect ist offline", sobald das der Fall ist, mit Link zum Setup-Wizard. Wenn Connect online ist, aber die Aktion trotzdem nicht klappt: Stimmt der Szenen- bzw. Source-Name exakt mit dem in OBS überein (Groß-/Kleinschreibung, Leerzeichen)? Ein Tippfehler im Feld ist die häufigste Ursache.

Sound, TTS und Automation-Trigger gibt es bei Twitch-Reward-Bindings aktuell nicht als Action-Typ — wenn dir sowas fehlt, siehe den Abschnitt dazu in Reward erstellen.

7. Dispatch-Antwortcodes zum Nachschlagen

Wenn du mit dem Support sprichst oder selbst tiefer debuggst, helfen die internen Response-Codes des Dispatch-Endpunkts weiter:

  • no_binding — kein Binding für Reward-ID/-Titel gefunden.
  • binding_disabled — Binding existiert, ist aber pausiert.
  • cooldown — Chatlix-eigener Cooldown greift (siehe Reward-Limits).
  • duplicate_suppressed — derselbe Nutzer hat innerhalb des Duplikat-Schutz-Fensters nochmal eingelöst.
  • dispatched — alle konfigurierten Aktionen wurden erfolgreich ausgelöst.
  • dispatched_partial — mindestens eine Aktion hat gefeuert, andere sind fehlgeschlagen (Details im failures-Array: z. B. no_overlay_binding, no_subscriber, OBS-Fehlermeldung).
  • publish_failed — keine einzige Aktion konnte ausgelöst werden, meist weil Redis nicht erreichbar war (kritischer interner Fehler, kein Konfigurationsproblem deinerseits).

8. Edge Cases

  • „Test funktioniert, echte Einlösung nicht" und im Event-Feed erscheint nichts: Twitch hat gelegentlich eine Verzögerung von 5–30 Sekunden, selten auch länger. Zwei Minuten warten, dann nochmal einlösen.
  • Wirklich gar nichts, auch nach Reconnect? Letzter, harter Reset: /dashboard/twitch → Account trennen und über /oauth/twitch/login komplett neu autorisieren. Achte darauf, dass im Consent-Screen sowohl channel:read:redemptions als auch (falls du Rewards aus Chatlix erstellen willst) channel:manage:redemptions mit angehakt sind.

Wenn nach all dem nichts geht

Dann ist es kein Standardproblem mehr. Notier dir den Reward-Titel, die Binding-ID (aus der Bindings-Liste), ungefähre Uhrzeit deines Test-Redeems und, falls bekannt, den Dispatch-Response-Code aus Schritt 7 — und schick das im Support-Channel. Ein Screenshot vom Event-Feed (/dashboard/events) rund um den Zeitpunkt der Einlösung hilft zusätzlich. Das spart mehrere Rückfrage-Runden.