Kanalpunkte sind das einfachste Mittel, Zuschauer am Stream mitwirken zu lassen: ein Lied wünschen, ein Video überspringen, eine Frage stellen. Spannend wird es, sobald ein Bot auf die Einlösung reagieren soll. Dann entscheiden ein paar Einstellungen darüber, ob er sie überhaupt sieht und ob er Punkte zurückgeben kann.
Was eine eigene Belohnung ist
Neben den festen Belohnungen von Twitch kannst du eigene anlegen. Das geht nur als Affiliate oder Partner. Twitch erlaubt bis zu 50 eigene Belohnungen pro Kanal, aktive und deaktivierte zusammengezählt. Jede Belohnung kostet mindestens einen Punkt und kann einen Hinweistext für die Zuschauer haben, höchstens 200 Zeichen lang.
Ob du die Belohnung im Creator-Dashboard anlegst oder ein Programm sie über die Twitch-API erstellen lässt, macht für Zuschauer keinen Unterschied. Für Bots ist es ein großer, dazu unten mehr.
Die Einstellungen, auf die es ankommt
Die Namen im Dashboard können sich ändern. Die Twitch-API nennt die Einstellungen so, und dort sind sie verbindlich beschrieben:
| Feld in der API | Wirkung | Wann sinnvoll |
|---|---|---|
is_user_input_required | Zuschauer muss beim Einlösen Text eingeben. | Wünsche, Fragen, alles, was ein Bot auswerten soll. |
max_per_stream | Höchstzahl an Einlösungen pro Stream, für alle zusammen. | Teure Aktionen, die den Stream sonst überfluten. |
max_per_user_per_stream | Höchstzahl pro Zuschauer und Stream. | Damit nicht eine Person alle Plätze belegt. |
global_cooldown_seconds | Abklingzeit zwischen zwei Einlösungen, wirkt nur, wenn die Abklingzeit eingeschaltet ist. | Alles, was sichtbar im Stream passiert. |
should_redemptions_skip_request_queue | Einlösung gilt sofort als erledigt und landet nicht in der Warteschlange. | Nur, wenn nie jemand nacharbeiten muss. |
Wie ein Bot eine Einlösung bemerkt
Es gibt zwei Wege. Der offizielle ist EventSub: Ein Programm abonniert das Ereignis channel.channel_points_custom_reward_redemption.add und bekommt jede Einlösung gemeldet. Dafür braucht es von dir die Berechtigung channel:read:redemptions. Das Abo lässt sich auf eine bestimmte Belohnung beschränken.
Der zweite Weg ist der Chat. Löst jemand eine Belohnung mit Texteingabe ein, erscheint der Text als Chatnachricht, versehen mit der Kennung der Belohnung. Ein Chat-Bot kann daran erkennen, welche Belohnung gemeint ist. So arbeitet unser eigener Bot. Unsere Beobachtung im Betrieb: Belohnungen ohne Texteingabe tauchen im Chat gar nicht auf. Twitch dokumentiert die Kennung im Chat nicht offiziell; verlass dich darauf nur, wenn dein Werkzeug es ausdrücklich so beschreibt.
Faustregel: Soll ein Bot auf eine Belohnung reagieren, schalte die Texteingabe ein. Dann funktioniert sie mit EventSub-Bots und mit Chat-Bots.
Die Client-ID-Falle: Wer darf eine Belohnung verwalten?
Hier liegt der häufigste Irrtum. Lesen darf jede App mit der passenden Berechtigung alle Belohnungen. Verwalten darf sie aber nur die App, die sie angelegt hat. Die Twitch-API prüft dafür die Client-ID: Ändern, Löschen, Einlösungen abrufen und den Status einer Einlösung setzen klappt nur mit derselben Client-ID, mit der die Belohnung erstellt wurde. Sonst antwortet Twitch mit einem Fehler 403.
Belohnungen, die du von Hand im Dashboard angelegt hast, gehören keiner App. Kein Bot kann ihren Status ändern oder sie für dich bearbeiten. Er kann nur sehen, dass jemand sie eingelöst hat.
Warteschlange und Rückerstattung
Ohne „Warteschlange überspringen“ landet jede Einlösung im Zustand UNFULFILLED in deiner Warteschlange. Dort kannst du sie als erledigt markieren oder ablehnen. Laut Twitch gibt das Ablehnen (CANCELED) dem Zuschauer die Punkte zurück. Mit „Warteschlange überspringen“ gilt die Einlösung sofort als erledigt, und eine Rückerstattung ist nicht mehr vorgesehen.
Eine automatische Rückerstattung durch einen Bot, etwa wenn ein Wunsch nicht erfüllbar ist, setzt beides voraus: Die Belohnung wurde von genau dieser App angelegt, und die App hat die Berechtigung channel:manage:redemptions. Fehlt eines davon, bleibt nur der Weg über deine Warteschlange.
Was wir im Betrieb gelernt haben
- Eine Belohnung, eine Aufgabe. Nutzt du dieselbe Belohnung für zwei Funktionen, entscheidet das Werkzeug, welche gewinnt. Bei uns gewinnt „Video überspringen“ vor dem Wunsch. Leg lieber zwei Belohnungen an.
- Doppelte Zustellung einplanen. Dieselbe Einlösung kann zweimal ankommen. Unser Plugin verwirft eine zweite Überspringen-Einlösung innerhalb von fünf Sekunden.
- Neue Belohnung, neue Liste. Manche Werkzeuge laden die Liste deiner Belohnungen nur beim Verbinden mit Twitch. Eine später angelegte Belohnung fehlt dann in der Auswahl, bis du neu verbindest.
- Mit dem richtigen Konto verbinden. Twitch fragt beim Verbinden nicht nach, welches Konto gemeint ist. Bist du im Browser mit einem anderen Kanal angemeldet, verbindest du diesen.
Wie Zuschauer im 24/7-Stream per Kanalpunkte ein Video überspringen oder sich ein bestimmtes wünschen, steht auf der Seite zum OBS-Plugin.
Checkliste
- Affiliate oder Partner, und noch unter 50 eigenen Belohnungen?
- Texteingabe an, wenn ein Bot die Belohnung auswerten soll?
- Limits pro Stream, pro Zuschauer oder eine Abklingzeit gesetzt?
- Warteschlange überspringen nur, wenn nie eine Rückerstattung nötig ist?
- Soll ein Bot Punkte zurückgeben: Hat er die Belohnung selbst angelegt?
- Nach dem Anlegen einer neuen Belohnung die Liste im Werkzeug neu geladen?