Webhook

Ein Webhook ist ein HTTP-Callback, der automatisch Daten von einer Anwendung an eine andere sendet, wenn ein bestimmtes Ereignis eintritt. Im Gegensatz zu [APIs](/glossary/api), bei denen du aktiv nach Aktualisierungen fragst, übertragen Webhooks Daten in Echtzeit, sobald Ereignisse eintreten. Die empfangende Anwendung lauscht an einem festgelegten URL-Endpunkt und verarbeitet die eingehenden Daten sofort. Webhooks folgen einem Publisher-Subscriber-Modell: Die Quellanwendung sendet eine HTTP-POST-Anfrage an eine vorregistrierte URL, wann immer ein auslösendes Ereignis stattfindet, und der Subscriber verarbeitet die Nutzlast, ohne sie jemals anfordern zu müssen.

Webhooks eliminieren die Notwendigkeit manueller Datenübertragungen oder ständigen Pollings zwischen Systemen. Für digitale Publisher bedeutet dies, dass erfasste Leads, Verkaufstransaktionen und Besucher-Aktivitäten automatisch in CRMs, E-Mail-Plattformen oder interne Datenbanken fließen können, im Moment ihres Eintretens. Dies reduziert Verzögerungen von Minuten oder Stunden auf Millisekunden, beseitigt manuelle Export-Import-Arbeit und stellt sicher, dass deine Geschäftssysteme immer aktuelle Daten haben. Ohne Webhooks müssen Teams entweder Dashboards manuell prüfen oder geplante Batch-Prozesse aufbauen, die hinter Echtzeit-Ereignissen zurückbleiben.

FlipLinks Funktion [Automatisierung und Integrationen](/features/automation-and-integrations) unterstützt Webhooks, die bei wichtigen Ereignissen ausgelöst werden. Du kannst Webhook-Endpunkte konfigurieren, um Daten zu empfangen, wenn ein neuer Lead erfasst wird, ein Dokument angesehen wird oder ein Verkauf über Stripe abgeschlossen wird. Jeder Webhook sendet eine strukturierte JSON-Nutzlast mit den Ereignisdetails an deine angegebene URL. Dies ermöglicht die Verbindung von FlipLink mit praktisch jedem System, einschließlich Tools wie Zapier, Make oder eigenen Backends. In Kombination mit der [Google Sheets-Integration](/features/automation-and-integrations) geben Webhooks Publishern eine flexible Möglichkeit, ihren gesamten Publikations-Workflow ohne Programmierung zu automatisieren.

Wenn ein auslösendes Ereignis eintritt, sendet FlipLink eine HTTP-POST-Anfrage an deinen registrierten Endpunkt-URL. Der Anfragetext enthält eine JSON-Nutzlast mit folgender Struktur: - **Ereignistyp** — eine Zeichenkette, die das Ereignis identifiziert (z.B. `lead.captured`, `document.viewed`, `sale.completed`) - **Zeitstempel** — Datum und Uhrzeit des Ereignisses im ISO 8601-Format - **Nutzlastdaten** — die ereignisspezifischen Felder wie Kontaktname, E-Mail, Dokumenttitel oder Transaktionsbetrag Dein Endpunkt sollte einen HTTP-200-Statuscode zurückgeben, um den Empfang zu bestätigen. Wenn der Endpunkt einen Fehler zurückgibt oder ein Timeout auftritt, wiederholt FlipLink die Zustellung, um sicherzustellen, dass keine Ereignisse verloren gehen. Alle Webhook-Nutzlasten werden über [HTTPS](/glossary/https) gesendet, sodass Daten bei der Übertragung verschlüsselt sind. Für Entwickler, die eigene Integrationen erstellen, macht die konsistente JSON-Struktur es einfach, Ereignisse zu parsen und an den richtigen Handler in deiner Anwendung weiterzuleiten.

1. **Bereite deinen Endpunkt vor.** Richte eine HTTPS-URL auf deinem Server, bei Zapier, Make oder einem beliebigen Dienst ein, der POST-Anfragen empfangen kann. Der Endpunkt muss öffentlich erreichbar sein und eine 200-Antwort zurückgeben. 2. **Navigiere zu den Integrationen.** Gehe in deinem FlipLink-Dashboard zu den Einstellungen für [Automatisierung und Integrationen](/features/automation-and-integrations) deiner Publikation. 3. **Füge die Webhook-URL hinzu.** Füge die URL deines Endpunkts in das Webhook-Konfigurationsfeld ein. 4. **Wähle die auslösenden Ereignisse.** Wähle, welche Ereignisse den Webhook auslösen sollen — Lead-Erfassung, Dokumentenansicht, Verkaufsabschluss oder andere je nach deinen Workflow-Anforderungen. 5. **Sende ein Test-Ereignis.** Verwende die Testfunktion, um eine Beispiel-Nutzlast an deinen Endpunkt zu senden. Überprüfe, ob dein System die Daten korrekt empfängt und verarbeitet. 6. **Geh live.** Speichere deine Konfiguration. Ab diesem Zeitpunkt löst jedes passende Ereignis in deinem [Flipbook](/glossary/flipbook) einen Echtzeit-POST an deinen Endpunkt aus. 7. **Überwache die Zustellung.** Überprüfe regelmäßig die Logs deines Endpunkts, um die Ankunft der Webhooks zu bestätigen. Wenn du Lücken bemerkst, prüfe, ob dein Endpunkt 200-Antworten zurückgibt und ob dein Server keine Firewall-Regeln hat, die FlipLink-Anfragen blockieren.

| Aspekt | Webhook | API Polling | |--------|---------|-------------| | **Datenlieferung** | Automatischer Push bei Ereignissen | Pull nach einem definierten Zeitplan | | **Latenz** | Nahezu sofort (Millisekunden) | Abhängig vom Polling-Intervall (Sekunden bis Minuten) | | **Serverlast** | Minimal — Anfragen nur bei Ereignissen | Höher — Anfragen bei jedem Intervall, auch wenn nichts passiert ist | | **Implementierung** | URL registrieren und eingehende POST-Anfragen verarbeiten | Geplanten Job erstellen, der den API-Endpunkt wiederholt aufruft | | **Ideal für** | Echtzeit-Benachrichtigungen, CRM-Synchronisation, Sofort-Alerts | Batch-Verarbeitung, periodische Berichte, Daten-Snapshots | | **Risiko** | Endpunkt-Ausfall kann Ereignisse verlieren ohne Retry-Logik | Keine verlorenen Ereignisse bei rechtzeitigem Polling, aber verzögertes Bewusstsein | Für die meisten FlipLink-Publisher sind Webhooks die bessere Wahl für Lead-Erfassungs- und Verkaufsereignisse, bei denen Geschwindigkeit zählt. API-Polling funktioniert besser für periodische Analytics-Exporte oder Dashboards, die sich in festen Intervallen aktualisieren. Viele Teams nutzen beides: Webhooks für Echtzeit-Lead-Routing und die [REST API](/glossary/rest-api) für nächtliche Analytics-Abfragen.