Ko-Fi Integration

Ko-Fi ist eine Donation-Plattform für Creator. Streamer.bot hat eine native Ko-Fi Integration: Donations, Subscriptions, Shop-Orders und Commissions lösen automatisch Trigger aus.

Doku: docs.streamer.bot · Ko-Fi

Setup

In Streamer.bot: Integrations → Ko-Fi
Enabled aktivieren
Streamer.bot zeigt dir eine Webhook URL an (z.B. http://localhost:7474/kofi)
In deinem Ko-Fi Dashboard:
- Webhook URL eintragen
- Token kopieren und in SB einfügen
Test senden über Ko-Fi’s Dashboard → SB sollte den Event empfangen

Verfügbare Trigger

Trigger	Wann es feuert
Ko-Fi Donation	Jemand spendet (einmalig)
Ko-Fi Subscription	Jemand abonniert (monatlich)
Ko-Fi Resubscription	Abo-Verlängerung
Ko-Fi Shop Order	Jemand kauft etwas im Shop
Ko-Fi Commission	Jemand bestellt eine Commission

Trigger-Pfad: Integrations → Ko-Fi → [Event]

Verfügbare Variablen

Nach einem Ko-Fi Event stehen diese Variablen bereit:

Variable	Inhalt
`%kofiFrom%`	Name des Spenders
`%kofiAmount%`	Betrag (z.B. `5.00`)
`%kofiCurrency%`	Währung (z.B. `EUR`)
`%kofiMessage%`	Nachricht des Spenders
`%kofiType%`	Art: `Donation`, `Subscription`, `Shop Order`, `Commission`

Beispiel: Donation-Alert im Chat

[Event] Ko-Fi Donation
  Trigger: Ko-Fi → Donation
├── 1. Send Message: "☕ %kofiFrom% hat %kofiAmount% %kofiCurrency% gespendet! Nachricht: %kofiMessage%"
├── 2. Play Sound: C:\StreamBot\sounds\donation.mp3

Beispiel: Donation an Discord weiterleiten

Kombiniere Ko-Fi mit Discord Webhook:

[Event] Ko-Fi Donation
  Trigger: Ko-Fi → Donation
├── 1. Send Message: "☕ %kofiFrom% hat %kofiAmount% %kofiCurrency% gespendet!"
├── 2. Discord → Basic Webhook
│     Webhook Name: (dein in SB angelegter Discord-Webhook)
│     Content: "☕ **%kofiFrom%** hat %kofiAmount% %kofiCurrency% gespendet: %kofiMessage%"

Streamer.bots Fetch URL kann nur GET. Für Discord nimmst du deshalb die native Discord → Basic Webhook Sub-Action statt eines manuellen POST. Ein Embed (Card-Layout statt Plain-Text) braucht C# – Details im Discord Webhook-Guide.

Häufige Fallen

Webhook nicht erreichbar: Ko-Fi muss deinen PC erreichen. Ohne Port-Forwarding/Tunnel kommen keine Events an.
Token falsch: Der Token aus dem Ko-Fi Dashboard muss exakt in SB eingetragen sein.
Test-Events: Ko-Fi hat einen Test-Button im Webhook-Dashboard. Nutze ihn zum Debuggen.
Betrag als String: %kofiAmount% ist ein String (z.B. "5.00"). Für Vergleiche in If/Else ggf. Auto Type aktivieren.