Channel-Point-Rewards Setup

Bevor du Reward-Actions baust, kläre ein wichtiges Detail: Wer hat das Reward angelegt. Streamer.bot oder Twitch direkt?

Twitch-managed vs SB-managed Rewards

Anlegt	Trigger funktioniert	Refund via SB möglich
In Twitch Dashboard	✅ Ja	❌ Nein
In Streamer.bot UI	✅ Ja	✅ Ja

Konsequenz: Wenn du einen Reward willst der bei Fehler die Channel Points zurückgibt (z.B. “Skip Song” wenn die Skip-Action fehlschlägt), MUSS der Reward in Streamer.bot angelegt sein. Im Twitch-Dashboard angelegte Rewards kannst du nicht via Update Redemption Status zurückerstatten.

Reward in Streamer.bot anlegen

Methode A: Direkt im Trigger-Dialog

Action öffnen → Tab Triggers → + Add Trigger
Twitch → Channel Reward → Reward Redemption
Im Dialog: Create Reward Button (rechts oben)
Felder ausfüllen:

Feld	Beschreibung	Beispiel
Title	Anzeige-Name	`Hydrate Reminder`
Cost	Channel-Points-Preis	`500`
Prompt	Beschreibung für Viewer	`Erinner mich ans Trinken`
Background Color	Hex-Farbe (optional)	`#9147FF`
Skip Request Queue	Auto-fulfill ohne Queue?	`true` für simple Rewards
Max Per Stream	Limit pro Stream	leer = unlimited
Max Per User Per Stream	Limit pro User	`5`
Global Cooldown	Sekunden Cooldown	`60`
User Input Required	Viewer muss Text eingeben?	meist `false`

Save → Reward erscheint in Twitch und in der SB Reward-Liste.

Methode B: Reward im SB-Pane “Channel Points”

Linkes Pane → Tab Twitch → Sub-Tab Channel Points
Rechtsklick → + Add Reward
Gleiche Felder wie oben

Reward-Trigger anlegen

Sobald der Reward existiert, kannst du eine Action damit verknüpfen:

Action [Reward] Hydrate Reminder anlegen
Triggers-Tab → + Add Trigger → Twitch → Channel Reward → Reward Redemption
Reward Filter → das angelegte Reward auswählen
Save

Jetzt feuert die Action wenn jemand dieses spezifische Reward einlöst.

”Any Reward” Trigger

Du kannst auch eine Catch-all-Action machen die auf JEDES Reward reagiert:

| Reward Filter | Any |

In der Action kannst du dann via If/Else auf %rewardId% oder %rewardName% verzweigen.

[Reward] Catch-All
├── 1. If/Else: %rewardName% Equals "Hydrate Reminder"
│   ├── ... hydrate-logic ...
│   └── Break
├── 2. If/Else: %rewardName% Equals "Skip Song"
│   ├── ... skip-song-logic ...
│   └── Break
└── 3. (default-handling)

Vorteil: Eine Action für alles, übersichtlich. Nachteil: Mit vielen Rewards wird die Action lang. Pro Reward eine eigene Action ist sauberer.

Reward Queue / Skip Queue

Twitch hat zwei Modi für Rewards:

Modus	Verhalten
Skip Request Queue ✅	Reward wird sofort gefulfilled, keine Mod-Bestätigung nötig
Skip Request Queue ❌	Reward landet in der Queue, Mod muss approven/cancel

Für SB-Actions empfiehlt sich Skip Queue = ✅ plus eigene Refund-Logik bei Fehler (siehe refund-pattern.md). Sonst musst du nach jedem Reward in OBS/Twitch klicken um approven.

Globaler Reward-Status

Sub-Actions zum Bulk-Management:

Sub-Action	Was sie tut
`Twitch → Rewards → Set Enabled State`	Einzelnes Reward an/aus
`Twitch → Rewards → Set Paused State`	Einzelnes Reward pausieren
`Twitch → Rewards → Set Group Enabled State`	Alle Rewards einer Gruppe an/aus
`Twitch → Rewards → Set Cost`	Reward-Preis ändern
`Twitch → Rewards → Set Title`	Reward-Name ändern
`Twitch → Rewards → Configure Rewards`	Mehrere Rewards verwalten (group-based)

Use-Case: Rewards beim Stream-Start automatisch aktivieren, beim Stream-Ende deaktivieren.

[Sys] Stream Start. Enable Rewards  (Trigger: Stream Online)
└── Set Group Enabled State: Group = "Stream Rewards", Enabled = true

[Sys] Stream End. Disable Rewards  (Trigger: Stream Offline)
└── Set Group Enabled State: Group = "Stream Rewards", Enabled = false

Konkrete Reward-Beispiele

Reward	MD	Patterns
Hydrate Reminder	hydrate-reminder.md	Reward Trigger + Send Message + OBS-Source-Flash
Skip Song	skip-song.md	Reward Trigger + Update Redemption Status (Refund on Fail)
Custom Title (mit Text-Input)	custom-title.md	Reward Trigger + %userInput% + Set Channel Title
Refund-Pattern	refund-pattern.md	Update Redemption Status für Refunds

Häufige Fallen

Twitch-angelegte Rewards zeigen kein Trigger-Filter: SB sieht sie zwar, aber Update Redemption Status funktioniert nicht. Reward in SB neu anlegen
Reward Cost in SB vs Twitch divergent: wenn du Cost im Twitch-Dashboard änderst, syncs SB nicht sofort. SB-UI öffnen + refresh
Skip-Queue mit Mod-Approval verwirrt User: bei langen Queues sehen Viewer ihre Reward-Anfrage nicht als “fulfilled”. Skip Queue = ✅ macht’s transparenter

Quellen

Reward Redemption Trigger: docs.streamer.bot/api/triggers/twitch/channel-reward/reward-redemption
Update Redemption Status: docs.streamer.bot/api/sub-actions/twitch/rewards/update-redemption-status
Configure Rewards: docs.streamer.bot/api/sub-actions/twitch/rewards/configure-rewards
Get Reward Info: docs.streamer.bot/api/sub-actions/twitch/rewards/get-reward-info