Direkt zum Hauptinhalt

Provider einrichten

Zwei getrennte Setups, je nachdem welchen Weg du aus „Donations Grundlagen" nutzt. Wenn du unsicher bist: die Chatlix-Tip-Page (Abschnitt 2) ist der einfachere Weg, weil sie ohne Provider-Account und ohne Zapier/Custom-Header auskommt.

Teil 1 — Generic Donation-Webhook (externer Provider)

Schritt 1 — Webhook-URL in Chatlix generieren

  1. Im Dashboard Donations öffnen (/dashboard/donations), Bereich „Webhook-Konfiguration".
  2. Webhook aktivieren/generieren.
  3. Du bekommst:
    • Eine Webhook-URL im Format https://api.chatlix.app/v1/integrations/donations/generic/<token>
    • Einen Webhook-Secret, der als Header X-Chatlix-Donation-Secret mitgeschickt werden muss

Beides nirgendwo teilen. Bei Verdacht auf Leak: „Secret regenerieren" klicken — der alte Secret wird sofort ungültig, die URL bleibt aber gleich (nur der Token ändert sich, wenn du auch den rotierst).

Schritt 2 — Provider konfigurieren

Ehrlicher Stand: Nicht jeder Provider lässt dich einen Custom-Header setzen. Prüfe das zuerst, bevor du Zeit investierst:

Ko-fi

  1. Ko-fi Dashboard → API → „Webhook URL".
  2. Chatlix-Webhook-URL eintragen.
  3. Ko-fi schickt kein Custom-Header-Secret, sondern ein eigenes Verification-Token im Payload. Das bedeutet: der reine X-Chatlix-Donation-Secret-Weg passt hier nicht 1:1 — praktisch heisst das, du testest den Ko-fi-Payload zuerst über „Test-Donation senden" im Dashboard nach, damit du siehst, wie das Feld-Mapping bei dir ankommt, und meldest Abweichungen im Support-Discord.

Tiltify

  1. Tiltify Campaign-Settings → Webhooks.
  2. Chatlix-Webhook-URL eintragen, Event-Type „Donation" aktivieren.
  3. Secret-Header wie oben setzen, falls Tiltifys Webhook-UI Custom-Header erlaubt.

Streamlabs / StreamElements

Beide bieten in der Standard-Oberfläche keine zuverlässige Möglichkeit, einen eigenen Header (X-Chatlix-Donation-Secret) an einen frei wählbaren Webhook zu hängen. Praktikable Wege:

  • Ein Zwischen-Service wie Zapier/Make/n8n, der den Streamlabs-/StreamElements-Trigger abgreift und mit gesetztem Header an die Chatlix-URL weiterreicht.
  • Alternativ: Nutze direkt die Chatlix-Tip-Page (Teil 2) als deinen Haupt-Spenden-Link — dann brauchst du weder Streamlabs noch StreamElements für neue Donations.

Wenn du von Streamlabs oder StreamElements wechselst und nur deine alten Daten (Custom-Commands, Timer, Quotes, Loyalty-Punkte) mitnehmen willst — das ist ein separates Feature, kein Donation-Webhook: Dashboard → Import-Wizard → „StreamElements-Export" bzw. „Streamlabs Chatbot (Desktop) XLSX". Das importiert historische Konfiguration/Punkte, keine Spenden-Transaktionen.

Schritt 3 — Test-Donation

Im Dashboard unter Donations → Test-Donation senden kannst du einen synthetischen Event (provider=manual_test) auslösen, ohne wirklich Geld zu bewegen. Betrag, Spender-Name und Nachricht sind frei wählbar. Damit prüfst du:

  • Erscheint das Event in der History?
  • Feuert die Automation, die du auf donation_received gemappt hast?
  • Sieht der Overlay-Alert so aus wie erwartet (Template Clean/Neon/Pixel)?

Limit: 30 Test-Donations pro Stunde pro Account.

Fehler beim Provider-Setup

  • 401 vom Provider / invalid_secret: Secret-Header falsch geschrieben, oder Secret in Chatlix regeneriert, aber Provider hat noch den alten.
  • 404 / token_not_found: Webhook-URL falsch kopiert, oder der Token wurde bei einer Secret-Rotation mit-erneuert.
  • 403 / donation_ingest_disabled: Der Webhook-Schalter im Dashboard steht auf „aus" — unter „Webhook-Konfiguration" wieder aktivieren.

Teil 2 — Chatlix-eigene Tip-Page (Mollie)

Setup

  1. Dashboard → Donations → Bereich „Tip-Page".
  2. Titel, Beschreibung, Slug (ergibt chatlix.app/tip/dein-slug) festlegen.
  3. Min./Max.-Betrag, Betrags-Presets (z.B. 2.00, 5.00, 10.00, 25.00), ob freier Betrag erlaubt ist.
  4. Ob Spender-Nachricht und anonyme Spenden erlaubt sind.
  5. Alert-Template wählen (Clean/Neon/Pixel) — bestimmt die Overlay-Optik bei eingehenden Tips.
  6. Aktivieren, Link kopieren, in Panels/Bio/Stream-Titel verlinken.

Donation-Goals

Im selben Bereich kannst du ein Spenden-Ziel anlegen (Betrag, Titel). Bezahlte Tips zählen automatisch mit, das Overlay-Widget „Goal-Bar" liest den Fortschritt öffentlich über /v1/public/donation-goal/dein-slug.

Wichtig zu Mollie

Es gibt keinen eigenen Mollie-Account, den du verbinden musst — Chatlix betreibt einen gemeinsamen Mollie-Zugang. Solange der Zahlungsflow für dein Konto nicht freigeschaltet ist, bekommst du beim Checkout-Start den Code server_misconfigured oder mollie_error zurück. Melde das im Support-Discord statt selbst an Konfiguration zu drehen.

Siehe auch

  • Donations Grundlagen — Unterschied Webhook-Weg vs. Tip-Page, Custody-Frage.
  • Donations Troubleshooting — Fehlercodes im Detail, hängende Tip-Payments, Import-Duplikate.