Donations Grundlagen

Chatlix kennt zwei komplett getrennte Wege, wie eine Donation bei dir im Dashboard landet. Verwechsle sie nicht — sie haben unterschiedliches Geld-Handling und unterschiedliche Einrichtung:

1. Generic Donation-Webhook — du nutzt weiterhin einen externen Provider (z.B. Streamlabs, StreamElements, Tiltify, Ko-fi, oder irgendein anderes Tool mit ausgehenden Webhooks). Chatlix empfängt nur das Event (Betrag, Name, Nachricht) als Auslöser. Geld fliesst nie über Chatlix. Siehe „Provider einrichten".
2. Chatlix-eigene Tip-Page (Mollie) — dein eigener Spenden-Link chatlix.app/tip/dein-slug, den du direkt im Dashboard unter Donations konfigurierst. Hier läuft die Zahlung durch Chatlix (Mollie-Checkout), inkl. Spenden-Ziel (Goal-Bar), Betrags-Presets und Alert-Theme. Kein externer Account nötig.

Es gibt keine native OAuth-/API-Key-Integration einzelner Provider (kein „Mit StreamElements verbinden"-Knopf). Der Generic-Webhook ist bewusst provider-neutral — er funktioniert mit jedem Tool, das JSON per POST an eine URL schicken kann, nicht nur mit den vier genannten.

Wichtig: Custody-Unterschied

• Generic-Webhook-Weg: Chatlix hält keine Custody, kein Wallet, ist kein Zahlungsdienstleister. Geld fliesst weiter direkt zwischen Donator und Provider zu dir.
• Tip-Page-Weg (Mollie): Hier läuft die Zahlung technisch über einen gemeinsamen Mollie-Account, den Chatlix betreibt (shared Account für mehrere Chatlix-Produkte). Das ist real Zahlungsabwicklung, nicht nur Event-Empfang — behandle Auszahlungsfragen dazu über den Support, nicht als „wir speichern nur Events".

Was passiert nach einer Donation? (Generic-Webhook-Weg)

1. Der Donator zahlt über deinen Provider-Link (z.B. dein StreamElements-Tip-Page oder Ko-fi-Profil).
2. Der Provider sendet ein Webhook an Chatlix — vorausgesetzt, du hast die Chatlix-Webhook-URL beim Provider hinterlegt.
3. Chatlix prüft den Secret-Header, normalisiert das Event, speichert es in chatlix_donation_events.
4. Automation-Trigger donation_received feuert (zusätzlich donation_threshold, wenn eine Regel einen Mindestbetrag verlangt) — alle Automations, die darauf hören, laufen.
5. Parallel: Overlay-Alert-Fanout an alle aktiven Overlays des Kanals (ohne dass du dafür eine Automation-Regel brauchst) + optional Chat-Bot-Nachricht über Event-Reactions ("Danke {user} für {amount} {currency}! {message}").

Was passiert nach einer Zahlung über deine Tip-Page?

1. Besucher öffnet chatlix.app/tip/dein-slug, wählt Betrag (Preset oder frei, wenn erlaubt), optional Name + Nachricht.
2. Chatlix startet einen Mollie-Checkout und legt einen Datensatz mit Status open in chatlix_tip_payments an.
3. Sobald Mollie den Zahlungsabschluss meldet, wird der Datensatz auf paid gesetzt — erst dann entsteht ein normales Donation-Event (gleicher Trigger donation_received wie beim Webhook-Weg).
4. Dein konfiguriertes Donation-Goal (falls aktiv) wird live weitergezählt; das Alert-Template (Clean/Neon/Pixel) bestimmt die Overlay-Optik.

Wo siehst du das Ergebnis?

• Donations-Seite im Dashboard (/dashboard/donations) zeigt Webhook-Konfiguration, Tip-Page-Einstellungen, Donation-Goals, Alert-Template-Auswahl, „Echte Tip-Payments (Mollie)" und die Event-History in einer Ansicht.
• Jeder Event hat einen Status: received, duplicate, failed.
• duplicate heisst: Provider hat das Event nochmal geschickt (oft nach 5xx-Retry). Chatlix erkennt das über einen Dedupe-Hash und ignoriert die Duplikate.
• Ein Revenue-Dashboard (Stats für 7/30/90 Tage/gesamt, Top-Donors, letzte bezahlte Tips, CSV-Export) läuft aus denselben Tabellen — nützlich, um schnell zu sehen, ob eine Automation überhaupt Daten bekommt.

Limits

Verknüpfung mit TTS & Chat-Reactions

Es gibt keine dedizierte „Donation-TTS"-Funktion, aber donation_received (und donation_threshold für Mindestbeträge) ist ein ganz normaler Automation-Trigger. Das heisst: Du kannst jede Automation-Action daran hängen, inklusive „TTS abspielen" — z.B. die Donation-Nachricht vorlesen lassen. Details zur TTS-Action, Credits-Verbrauch und Sicherheits-Filtern findest du im Voice&TTS-Buch unter „TTS-Grundlagen".

Datenschutz

Donor-Name und Donor-Nachricht sind personenbezogene Daten. Chatlix speichert sie, weil du sie für Shoutouts/Alerts brauchst. Beim Generic-Webhook wird der Rohpayload bewusst ohne Name/Nachricht gespeichert (Datenminimierung) — nur die normalisierten Felder landen vollständig in der DB. Wenn du eine DSGVO-Löschanfrage bekommst:

• Im Support-Discord melden.
• Wir löschen die History-Einträge des betreffenden Donators.

Ein automatisches Anonymisieren/Löschen nach X Tagen ist aktuell nicht eingebaut — Löschung läuft manuell auf Anfrage.

Siehe auch

• Provider einrichten — konkrete Schritte für Webhook-Konfiguration und Tip-Page-Setup.
• Donations Troubleshooting — was tun bei 401/404, fehlenden Alerts, hängenden Tip-Payments.

Dritter Weg: betterplace-Spendenaktionen

Neben dem Generic-Webhook und der eigenen Tip-Page kann Chatlix seit August 2026 direkt auf Spenden bei betterplace.org reagieren — der übliche Weg für Charity-Streams.

Eingerichtet wird das nicht auf dieser Donations-Seite, sondern in einer Automation mit dem Auslöser betterplace-Spende. Dort trägst du den Link deiner Spendenaktion (oder ihre Event-Nummer) und ein Abfrageintervall ein, wahlweise mit einer Betragsgrenze.

Zum Geldfluss: Chatlix ist hier — wie beim Generic-Webhook — nicht beteiligt. Die Spenden laufen vollständig über betterplace.org; Chatlix liest nur die öffentliche Spendenliste und nutzt sie als Auslöser. Ein Zugangsschlüssel ist dafür nicht erforderlich.

Die Einstellungen im Einzelnen stehen im Buch „Automations“, Seite „Automations Grundlagen“.