Ein Webhook ist eine automatische HTTP-Benachrichtigung, die Fakturia an eine vordefinierte URL sendet, sobald ein bestimmtes Ereignis eintritt – etwa ein neuer Vertrag, eine erfolgreiche Zahlung oder eine Kündigung. Statt dass ein angebundenes System ständig über die REST-API nachfragen muss, ob sich etwas geändert hat, informiert Fakturia proaktiv und in Echtzeit – das reduziert Netzwerkverkehr, eliminiert Verzögerungen und stellt sicher, dass kein Ereignis übersehen wird.
Push statt Pull: Wie Webhooks funktionieren
Während die REST-API für gezielte, aktive Abfragen genutzt wird – „Gib mir alle aktiven Verträge dieses Kunden" –, funktionieren Webhooks umgekehrt: Fakturia sendet von sich aus eine HTTP-Anfrage mit allen relevanten Daten an das Zielsystem, sobald ein Ereignis eintritt. Die Nutzlast ist ein strukturiertes JSON-Objekt mit Ereignistyp, Zeitstempel und den betroffenen Datensätzen – direkt maschinenlesbar für die Weiterverarbeitung im empfangenden System.
Typische Ereignisse, über die Fakturia informiert
Zu den häufigsten Webhook-Ereignissen zählen die Anlage eines neuen Vertrags, eine erfolgreiche oder fehlgeschlagene Zahlung, eine Kündigung sowie Tarifwechsel. Bei einem neuen Vertrag kann so automatisch ein CRM-Datensatz angelegt und eine Onboarding-E-Mail ausgelöst werden. Bei einer fehlgeschlagenen Zahlung lässt sich das Support-Team umgehend benachrichtigen, parallel zum ohnehin automatisch laufenden Mahnwesen. Bei einer Kündigung kann das CRM den Kunden automatisch als gefährdet markieren und eine Win-back-Kampagne vorbereiten.
Zuverlässigkeit durch Retry-Logik
Ist das Zielsystem zum Zeitpunkt eines Ereignisses kurzzeitig nicht erreichbar – etwa wegen eines Deployments oder einer Netzwerkstörung –, sendet Fakturia den Webhook nach einem definierten Muster automatisch erneut, bis das Zielsystem den Empfang bestätigt oder eine maximale Anzahl an Versuchen erreicht ist. Auf Empfängerseite empfiehlt sich eine idempotente Verarbeitung anhand der eindeutigen Ereignis-ID, damit eine mehrfache Zustellung nicht zu doppelten Aktionen führt.
Grundlage für No-Code-Automatisierung
Webhooks sind auch die technische Basis für No-Code-Integrationen: In Verbindung mit Plattformen wie im Beitrag zur No-Code-Automatisierung beschrieben, lassen sich Fakturia-Ereignisse ohne eigene Entwicklungsarbeit mit CRM-, Marketing- oder Buchhaltungstools verknüpfen.
Webhooks und REST-API im Zusammenspiel
Wer beide Mechanismen kombiniert, baut eine Systemlandschaft, die weder auf ständiges Abfragen (Polling) angewiesen ist noch auf manuelle Datensynchronisation. Die REST-API übernimmt gezielte Abfragen und Änderungen, Webhooks sorgen für die sofortige Reaktion auf Ereignisse – gemeinsam bilden sie die Grundlage für einen vollständig automatisierten Order-to-Cash-Prozess.
Was Webhooks mit Fakturia konkret ermöglichen
- Echtzeit-Benachrichtigung über neue Verträge, Zahlungen, Kündigungen und mehr
- Automatische Retry-Logik bei vorübergehend nicht erreichbaren Zielsystemen
- Grundlage für No-Code-Integrationen ohne eigene Entwicklungsarbeit
- Nahtloses Zusammenspiel mit der REST-API für vollautomatisierte Prozessketten
- Sofortige Reaktion auf Ereignisse statt zeitversetztem Abfragen