Streamlabs Donation-Integration

Streamlabs-Donations kommen direkt in Streamer.bot rein. Du behältst Streamlabs als Donation-Plattform und nutzt SB für die Chat-Reaktionen und OBS-Steuerung.

Doku: docs.streamer.bot · Streamlabs

Setup

In Streamer.bot: Integrations → Streamlabs
Enabled aktivieren
Socket API Token aus Streamlabs eintragen:
- Streamlabs Dashboard → Settings → API Settings → API Tokens → Socket API Token
Status: Connected

Trigger

Trigger	Wann
Streamlabs Donation	Jemand spendet
Streamlabs Charity Donation	Charity-Spende
Streamlabs Merchandise	Merch-Kauf
Streamlabs Connected	Verbindung hergestellt
Streamlabs Disconnected	Verbindung verloren

Trigger-Pfad: Integrations → Streamlabs → [Event]

Variablen bei Donation

Variable	Inhalt
`%slDonationFrom%`	Name des Spenders
`%slDonationAmount%`	Betrag
`%slDonationCurrency%`	Währung
`%slDonationMessage%`	Nachricht

Beispiel: Donation-Alert

[Event] Streamlabs Donation
  Trigger: Streamlabs → Donation
├── 1. Send Message: "💰 %slDonationFrom% hat %slDonationAmount% %slDonationCurrency% gespendet! %slDonationMessage%"
├── 2. Play Sound: C:\StreamBot\sounds\donation.mp3

Connection prüfen

Im Integrations → Streamlabs Tab steht Status Connected. Wenn nicht:

Socket API Token noch einmal aus SL kopieren (Settings → API Settings → API Tokens → Socket API Token, NICHT Access Token)
Reconnect drücken (oben rechts)
SB Log prüfen – bei 401 Unauthorized ist der Token falsch, bei Network Error ist der SL-WebSocket-Server temporär weg

Test ohne echte Spende

Streamlabs-Dashboard → Alert Box → Test Donations. Mit beliebigem Betrag und Test-Username triggern. Kommt als echter Streamlabs Donation Trigger in SB an – Pflicht vor jedem Production-Setup.

Häufige Fallen

Socket Token ≠ Access Token: Es gibt verschiedene Token-Typen. Du brauchst den Socket API Token, nicht den OAuth Access Token.
Doppelte Alerts: Streamlabs hat eigene Alerts. Wenn du beides nutzt (SL Alerts + SB Trigger) → doppelt. Eins deaktivieren.
Charity Donations: Separter Trigger. Wenn du auch Charity-Spenden anzeigen willst, brauchst du einen zweiten Event-Handler.
Currency-Format: %slDonationCurrency% kann EUR, USD, € oder leer sein (je nach SL-Setting). In der Chat-Message lieber hardcoden wenn du Konsistenz brauchst.
Refund kommt nicht als Event: SL sendet kein Reverse-Event wenn eine Spende zurückgenommen wird. Falls relevant: separat im SL-Dashboard prüfen.