Fansly-Webhooks-Leitfaden: Echtzeit-Events ohne Polling

Wenn deine Fansly-Integration die API jede Minute abfragt, um nach neuen Nachrichten, Verkäufen oder Abos zu sehen, verbrennst du Credits, erzeugst Latenz und verpasst Events zwischen den Abfragen. Fansly-Webhooks drehen das Modell um: Jedes Event auf Fansly wird in dem Moment an deinen Server gepusht, in dem es passiert, mit kryptografischer Signatur, automatischen Retries und einem integrierten Idempotency-Vertrag für sichere Deduplizierung.

Dieser Leitfaden zeigt, welche Events Webhooks auslösen, wie du sie in weniger als fünf Minuten einrichtest, wie du sie im Produktivbetrieb sicher verarbeitest und welche Anwendungsfälle in Agenturen den Umstieg von Polling rechtfertigen.

Warum Webhooks bei Fansly besser sind als Polling

Polling wirkt harmlos: ein Cronjob, der die Fansly API jede Minute fragt: „Gibt's was Neues?“ In Wirklichkeit hat es drei teure Probleme:

1. Kosten: Jede Abfrage verbraucht Credits, ob neue Events passiert sind oder nicht. Eine minütliche Abfrage über 20 Creator-Accounts verbrennt 28.800 Aufrufe pro Tag. Webhooks für dieselbe Abdeckung kosten nur einen Bruchteil.
2. Latenz: Zwischen den Abfragen warten Events auf der Plattform. Ein Whale gibt um 9:00:15 Trinkgeld, dein Scraper bemerkt es um 9:01:00. In dieser 45-Sekunden-Lücke schließt sich das Zeitfenster, in dem Chatter nachfassen können.
3. Zuverlässigkeit: Polling liefert sich ein Rennen mit den Rate-Limits. Webhook-Zustellungen stellt Fansly in eine Warteschlange und wiederholt sie, bis dein Server sie bestätigt.

Webhooks beseitigen alle drei Probleme. Ein Event = eine HTTP-Zustellung = ein Credit pro 100 Events.

Event-Typen der Fansly-Webhooks

Jedes relevante Event auf einem verbundenen Fansly-Account löst einen Webhook aus. Die häufigsten:

Die vollständige Liste siehst du im Dashboard, sobald du einen Endpoint registriert hast. Neue Events kommen regelmäßig hinzu, ohne bestehende Handler zu brechen.

So richtest du Fansly-Webhooks in 5 Minuten ein

1. Öffne das Fansly-API-Dashboard: Geh zum Bereich Webhooks
2. Füg einen Endpoint hinzu: Füg deine Server-URL ein (nur HTTPS – Fansly stellt nicht an HTTP zu)
3. Wähl die Events, die du abonnieren willst: Fang mit message.received, sale.completed, subscription.renewed und subscription.expired an. Erweitern kannst du später.
4. Kopier das Signing Secret: Speichere es in deiner Umgebung als FANSLY_WEBHOOK_SECRET
5. Teste aus dem Dashboard heraus: Fansly löst ein Test-Event aus, damit du prüfen kannst, ob dein Server es annimmt und mit 200 antwortet
6. Geh live: Schalte den Endpoint auf Active

Das war's. Dein Server empfängt Events, sobald sie passieren.

Signaturen von Fansly-Webhooks prüfen

Jede Zustellung enthält einen X-Fansly-Signature-Header. Prüfe ihn, bevor du einen Payload verarbeitest – sonst könnte ein Angreifer gefälschte Events einschleusen.

import { createHmac } from 'crypto'
 
function verifyWebhook(rawBody, signatureHeader, secret) {
  const expected = createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex')
  return signatureHeader === expected
}
 
// In deinem Handler:
if (!verifyWebhook(req.rawBody, req.headers['x-fansly-signature'], process.env.FANSLY_WEBHOOK_SECRET)) {
  return res.status(401).send('invalid signature')
}

Beachte die Verwendung von rawBody: Du musst den Body hashen, bevor er als JSON geparst oder von Middleware verändert wird. Die meisten Web-Frameworks haben einen Raw-Body-Modus, den du aktivieren musst.

Retries von Fansly-Webhooks sicher verarbeiten

Fansly wiederholt jede Zustellung, die keine 2xx-Antwort zurückgibt, mit exponentiellem Backoff. Bei wackeligen Netzwerkbedingungen kann dein Server dasselbe Event 2- bis 5-mal sehen.

Dedupliziere mit dem Idempotency-Key, den jedes Event mitbringt:

const seen = new Set() // bei mehreren Instanzen Redis oder eine Datenbank nutzen
 
async function handleWebhook(event) {
  if (seen.has(event.idempotencyKey)) {
    return // schon verarbeitet, überspringen
  }
  seen.add(event.idempotencyKey)
  await processEvent(event) // Business-Logik kann jetzt sicher laufen
}

Für Anwendungsfälle mit geringem Volumen (< 10.000 Events pro Tag und Server) reicht ein In-Memory-Set. Im Produktivbetrieb mit mehreren Workern speicherst du die Keys in Redis mit einer TTL von 24 Stunden.

Anwendungsfälle für Agenturen – was Webhooks wirklich ermöglichen

Webhooks sind keine Bequemlichkeit für Entwickler. Sie sind das Fundament jeder umsatzbringenden Automatisierung, die eine Agentur betreibt.

Whale-Alerts in Echtzeit → Trinkgelder in Minuten aufgreifen

Abonniere tip.received, filtere nach Beträgen ≥ $100 und pushe sie in einen Slack-Channel oder an das Telegram der Chatter. Ergebnis: Chatter melden sich, während der Fan noch im Gespräch ist, und nicht erst am nächsten Morgen, wenn die Gelegenheit vorbei ist.

Willkommenssequenzen → neue Abonnenten in der ersten Stunde aktivieren

Abonniere subscription.created. Warte 1 Stunde. Schick über die Messaging-API eine personalisierte Willkommens-DM. Warte 24 Stunden. Fass mit einem PPV nach. Ergebnis: 3- bis 5-mal höherer Umsatz in der ersten Woche pro neuem Abonnenten, verglichen mit dem Warten auf manuelle Ansprache durch Chatter.

Churn-Winback → 15–25 % der abgelaufenen Abos zurückholen

Abonniere subscription.expired. Warte 7 Tage. Schick eine personalisierte DM mit einem Rabattcode aus dem Promotions-Endpoint und einem Tracking-Link. Ergebnis: Tausende Dollar an zurückgewonnenem MRR durch einen Workflow, der von selbst läuft.

Chatter-Routing → die richtige Person für den richtigen Fan

Abonniere message.received. Hol die Ausgabenstufe des Fans aus dem Fans-Endpoint. Leite Fans mit hohem LTV an erfahrene Chatter weiter, neue Fans an Onboarder und inaktive Fans an Retention-Spezialisten. Ergebnis: Jeder Fan bekommt das richtige Maß an Aufmerksamkeit, ohne manuelle Triage.

Umsatz-Dashboards in Echtzeit → die Finanzabteilung hört auf zu fragen

Abonniere sale.completed und subscription.renewed. Streame die Daten über n8n / Zapier / Make.com nach BigQuery, Snowflake oder in ein Google Sheet. Ergebnis: Die Finanzabteilung sieht Umsätze innerhalb von Sekunden in ihrem Dashboard und nicht erst beim Monatsabschluss.

Compliance- und Content-Monitoring → Probleme erkennen, bevor sie eskalieren

Abonniere message.received. Lass den Text durch einen Moderationsklassifikator laufen (OpenAI Moderation API, Perspective API oder dein eigenes Modell). Markiere problematische Nachrichten und leite sie an das Ops-Team weiter. Ergebnis: geringeres Risiko für die Account-Sicherheit, keine Stunden mehr für manuelle Prüfung.

Tipps für Fansly-Webhooks im Produktivbetrieb

• Antworte schnell mit 200. Bestätige den Empfang und stell das Event zur asynchronen Verarbeitung in eine Warteschlange. Lange synchrone Handler verursachen Timeouts und lösen Retries aus.
• Protokolliere jede Zustellung. Führe auch mit Idempotency-Keys ein Log aus Payload und Antwort, für Audits und Debugging. Das Dashboard hat eine Seite Webhook Logs, die die Sicht von Fansly zeigt.
• Teste Fehlerfälle. Simuliere langsame Datenbankabfragen, Ausfälle von Drittanbieter-APIs und Speicherfehler. Dein Handler sollte nie wegen eines einzelnen fehlerhaften Events abstürzen.
• Nutze HTTPS mit gültigen Zertifikaten. Fansly stellt weder an HTTP-Endpoints noch bei ungültigem TLS zu. Richte Let's Encrypt oder AWS ACM ein, falls du das noch nicht hast.
• Behalte das Dashboard im Blick. Die Seite Webhook Logs zeigt jeden Zustellversuch, die Zahl der Retries und den endgültigen Status. Richte einen Alert ein, wenn die Fehlerquote in einem 5-Minuten-Fenster 1 % übersteigt.

Preise für Fansly-Webhooks

Webhook-Zustellungen kosten 1 Credit pro 100 Events und sind damit typischerweise 100- bis 1.000-mal günstiger als eine vergleichbare Abdeckung per Polling.

Ein Creator-Account mit hoher Fan-Aktivität (über 5.000 Events pro Tag aus Nachrichten, Likes, Trinkgeldern und Abos) kostet etwa 50 Credits pro Tag für Webhook-Zustellungen. Dieselbe Abdeckung mit minütlichem Polling würde 1.440 Aufrufe pro Tag zu Standard-Credit-Kosten verbrauchen.

Pläne und Credit-Kontingente:

• Basic – $69/Monat: 20.000 Credits, 1 Account, voller Webhook-Zugriff
• Pro – $299/Monat: 100.000 Credits, 5 Accounts, voller Webhook-Zugriff
• Enterprise – 100+ Accounts: dynamische Preise ab $11,60 pro Account, individuelle Credits

Webhooks sind in jedem bezahlten Plan enthalten – du brauchst keine Premium-Stufe.

Credit-Kontingente und Preise für Mehrverbrauch findest du auf der vollständigen Preisseite.

Häufige Fragen zu Fansly-Webhooks

Was ist der Unterschied zwischen Polling und Fansly-Webhooks? Polling bedeutet, dass dein Server die Fansly API jede Minute (oder jede Sekunde) fragt, ob etwas Neues passiert ist. Webhooks bedeuten, dass Fansly deinem Server Bescheid gibt, sobald es passiert. Webhooks sind im großen Maßstab 100- bis 1.000-mal günstiger, schneller und zuverlässiger – es gibt keine Race Condition, durch die dir Events zwischen zwei Abfragen entgehen.

Sind Fansly-Webhooks zuverlässig genug für den Produktivbetrieb? Ja. Jede Zustellung enthält eine HMAC-SHA256-Signatur zur Prüfung, einen Idempotency-Key für sichere Wiederholungen und automatische Retries mit exponentiellem Backoff bei Fehlern. Wir haben über 150 Mio. Events mit Zustellgarantien verarbeitet, die Enterprise-Standards entsprechen.

Welche Fansly-Events lösen Webhooks aus? Empfangene und gesendete Nachrichten, abgeschlossene Verkäufe, neue, verlängerte und abgelaufene Abos, erhaltene Trinkgelder, gekaufte PPVs, Interaktionen mit Posts, Tippanzeigen, Statusänderungen von Accounts und mehr. Die vollständige Event-Liste findest du im Dashboard, sobald du einen Endpoint registriert hast.

Wie gehe ich sicher mit Retries von Fansly-Webhooks um? Jede Webhook-Zustellung enthält einen eindeutigen Idempotency-Key. Speichere die Keys, die du schon verarbeitet hast (in Redis, einer Datenbank oder bei geringem Volumen sogar in einem In-Memory-Set), und überspringe jedes Duplikat. Fehlgeschlagene Zustellungen werden mit exponentiellem Backoff wiederholt, bis sie erfolgreich sind oder ein Timeout erreicht ist.

Kann ich Fansly-Webhooks ohne Code nutzen? Ja. n8n, Zapier und Make.com bieten alle Webhook-Trigger-Nodes. Füg die URL im Fansly-Dashboard ein, und dein No-Code-Workflow startet in dem Moment, in dem das Event ausgelöst wird – ohne Server, ohne Code, ohne Infrastruktur, die gepflegt werden muss.

Was sich mit dem Release vom Juni 2025 geändert hat

Dieser Leitfaden basiert auf dem Fansly-API-Release vom Juni 2025, das Folgendes eingeführt hat:

• Webhooks für den Produktivbetrieb: Event-Zustellung in Echtzeit für Nachrichten, Verkäufe, Abos, Trinkgelder, Interaktionen mit Posts, Tippanzeigen und Statusänderungen von Accounts
• Make.com-Integration: die erste No-Code-Plattform mit voller Abdeckung der Fansly API, mit vorgefertigten Szenarien für die Synchronisierung von Transaktionen und das Link-Tracking
• Endpoints für Medienverwaltung: Fotos, Videos und Audio hochladen, Medien im Vault organisieren, Vault-Listen erstellen
• Post-Verwaltung: Posts mit Labels, Medien, Umfragen (normale und Quiz), Spendenzielen und Ablaufdaten planen
• Erweitertes Chat-Messaging: PPVs, Medienanhänge, Creator-Tags
• Textformatierung: Fett, kursiv, Farbe und Größe in Posts und Nachrichten

Folge @onlyfansapi_updates auf Telegram, um die neuesten Updates zu bekommen.

Bereit, Polling hinter dir zu lassen? Kostenlos registrieren – die ersten 100 Credits sind inklusive, keine Kreditkarte nötig.

Fragen? Melde dich per E-Mail oder über Telegram.