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 Reminderanlegen - 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 Statusfunktioniert 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: https://docs.streamer.bot/api/triggers/twitch/channel-reward/reward-redemption
- Update Redemption Status: https://docs.streamer.bot/api/sub-actions/twitch/rewards/update-redemption-status
- Configure Rewards: https://docs.streamer.bot/api/sub-actions/twitch/rewards/configure-rewards
- Get Reward Info: https://docs.streamer.bot/api/sub-actions/twitch/rewards/get-reward-info