Ko-fi verbinden (Spenden & Mitgliedschaften)
Ko-fi-Spenden und -Mitgliedschaften landen automatisch als Alert im Stream (DonationModule). Die Anbindung läuft über einen Webhook-Relay: Ko-fi schickt das Event an unseren Server, die App holt es von dort ab — deine Desktop-App braucht dafür keinen offenen Port. Zuordnung zu deiner Zuschauer-DB nur per `!username` ganz am Anfang der Ko-fi-Nachricht (z. B. „!MaxMustermann Danke für den Stream!") — der Teil wird aus Anzeige und Vorlesen automatisch entfernt. Ohne passenden, bereits im Chat gesehenen Usernamen erscheint der Alert trotzdem, wird aber niemandem in der DB gutgeschrieben. Die Syntax für `!username` ist case-insensitiv (z. B. `!MaxMustermann` oder `!maxmustermann`). Es muss ein Leerzeichen nach dem Namen folgen. Die Zuordnung funktioniert sowohl für Twitch- als auch für YouTube-Namen.
Voraussetzungen
- Ein Ko-fi-Konto (ko-fi.com) mit eingerichteter Seite.
- In der App im Konto-Bereich bei aaronius.com angemeldet (nötig, damit dir die Events zugeordnet werden können).
Schritt für Schritt
- In der App unter Einstellungen → Integrationen → Ko-fi „Ko-fi" als Anbieter auswählen.
- Auf ko-fi.com/Manage/webhooks den „Verification Token" kopieren und in der App einfügen, speichern.
- Bei Ko-fi als Webhook-URL exakt die in der App angezeigte Adresse eintragen und dort speichern.
- In der App auf „Verbindung testen" klicken — meldet konkret, falls Token oder Webhook nicht passen.
- Bei Ko-fi „Send Test Message" senden — die Test-Spende erscheint als Alert im Overlay.
Wenn's nicht klappt
- Alert bleibt aus, „Verbindung testen" meldet aber grün: Verification-Token in der App und bei Ko-fi Zeichen für Zeichen vergleichen — wurde er bei Ko-fi neu generiert, muss er auch in der App neu eingetragen werden.
- „Nicht bei Supabase angemeldet": im Konto-Bereich der App einloggen und erneut testen.
- Mitgliedschafts-Stufen: Alle Ko-fi Mitgliedschaften werden aktuell pauschal als eine Stufe behandelt (eine getrennte Tier-Zuordnung ist vorerst nicht vorhanden).
Zuletzt aktualisiert: 5. September 2026