Vivoldi Webhook — Echtzeit-Eventübertragung
Übertragen Sie Ereignisdaten für Link-Klicks, Coupon-Einlösungen und Stempelprämien auch bei hohem Traffic stabil und in Echtzeit.
Von HMAC-SHA256-Signaturprüfung und Schutz vor doppelten Events bis hin zu automatischen Wiederholungen — Enterprise-Level-Zuverlässigkeit ist bereits integriert und sofort einsatzbereit.
Was ist der Vivoldi Webhook?
Der Vivoldi Webhook ist ein Echtzeit-Server-zu-Server-Integrationssystem, das Ereignisdaten direkt an Ihren Endpoint sendet, sobald ein Event ausgelöst wird.
Ohne separates API-Polling werden Eventdaten sofort an die in Vivoldi registrierten Endpoints übertragen und ermöglichen dadurch eine schnelle und nahtlose Echtzeit-Datensynchronisierung.
💡 Warum Webhooks verwenden?
Beim klassischen API-Polling müssen in regelmäßigen Abständen Anfragen an den Server gesendet werden, was zu unnötigem API-Traffic und Verzögerungen bei der Ereigniserkennung führen kann.
Vivoldi Webhook ruft Ihren Server nur dann auf, wenn tatsächlich ein Event ausgelöst wird, wodurch sofortige Reaktionen ohne unnötige Requests möglich sind.
Dies eignet sich ideal für zeitkritische Workflows wie CRM-Updates, Zahlungsabwicklung und Marketing-Automatisierung.
Webhook-Ablauf
Vivoldi Webhooks funktionieren in vier Schritten: Ereigniserkennung → Signaturerstellung → HTTPS-Übertragung → Zustellbestätigung.
Ereigniserkennung
Sobald bei einem Link, Coupon oder einer Stempelkarte mit aktiviertem Webhook ein Ereignis eintritt, erkennt Vivoldi es sofort.
Signaturerstellung
Vor der Übertragung erstellt Vivoldi eine HMAC-SHA256-Signatur für die Payload und fügt sie den Request-Headern hinzu.
Ihr Server kann diese Signatur prüfen, um zu bestätigen, dass die Anfrage von Vivoldi stammt.
HTTPS-Übertragung
Vivoldi sendet eine POST-Anfrage an die registrierte Callback URL. Das Antwort-Timeout beträgt 5 Sekunden.
Zustellbestätigung
Gibt Ihr Server eine 2xx-Antwort zurück, gilt die Zustellung als erfolgreich. Erfolgt keine Antwort oder wird ein HTTP-Fehler zurückgegeben, fährt Vivoldi mit dem unten beschriebenen Wiederholungsprozess fort.
Wo werden Webhooks konfiguriert?
Das Einrichten eines globalen Webhooks allein führt noch nicht dazu, dass Ereignisse gesendet werden. In den globalen Einstellungen werden die standardmäßige Callback URL und der Secret Key für die Ereignisübertragung festgelegt. Ereignisse werden nur gesendet, wenn Webhooks für den jeweiligen Link, Coupon oder die jeweilige Stempelkarte aktiviert sind.
Wenn für eine Linkgruppe, Coupongruppe oder Stempelkarte ein eigener Webhook konfiguriert ist, hat diese Konfiguration Vorrang vor den globalen Einstellungen. Auch wenn sowohl der globale als auch der individuelle Webhook aktiviert sind, wird jedes Ereignis nur einmal gesendet.
Was passiert, wenn die Zustellung fehlschlägt?
Die Zustellung gilt als fehlgeschlagen, wenn der HTTP-Statuscode der Antwort nicht 2xx ist oder innerhalb von 5 Sekunden keine Antwort eingeht.
Fehlgeschlagene Anfragen werden unabhängig vom HTTP-Statuscode erneut versucht. Daher wird der Webhook nicht bereits nach einem einzelnen Zustellfehler deaktiviert.
Ein Zustellfehler führt nicht dazu, dass der Webhook sofort deaktiviert wird.
Vivoldi informiert zunächst per E-Mail über den Fehler und gewährt anschließend eine Karenzzeit von 60 Minuten.
Wenn der empfangende Server innerhalb dieses Zeitraums wieder ordnungsgemäß erreichbar ist, bleibt der Webhook aktiv und die Zustellung wird fortgesetzt.
| Phase | Zeitpunkt | Aktion |
|---|---|---|
| Sofortiger Wiederholungsversuch | Nach 1 Sek. · 2 Sek. | Bei vorübergehenden Netzwerkfehlern werden Wiederholungsversuche durchgeführt. Einschließlich der ersten Zustellung erfolgen insgesamt 3 Versuche. |
| Verzögerter Wiederholungsversuch | Nach 10 Min. · 20 Min. | Zusätzliche Wiederholungsversuche werden durchgeführt, um Neustarts des empfangenden Servers oder vorübergehende Störungen zu berücksichtigen. Einschließlich der ersten Zustellung erfolgen bis zu 5 Versuche. |
| Warnbenachrichtigung | Nach ca. 30 Min. | Der Webhook wird in dieser Phase nicht deaktiviert. Eine E-Mail informiert über das betroffene Ziel und die Ursache des Fehlers. |
| Karenzzeit | 60 Min. | Wenn der empfangende Server innerhalb der Karenzzeit wieder verfügbar ist, wird die Zustellung automatisch fortgesetzt, ohne den Webhook zu deaktivieren. Während der Karenzzeit entstandene Coupon- und Stempelkartenereignisse werden ebenfalls nacheinander zugestellt. |
| Automatische Deaktivierung | Nach ca. 90 Min. | Wenn die Zustellungsfehler nach Ablauf der Karenzzeit weiterhin bestehen, wird der Status des Webhooks auf Vom System deaktiviert geändert und eine E-Mail-Benachrichtigung gesendet. |
Wenn vom selben Empfangs-Endpunkt wiederholt Fehler auftreten, wird die Zustellung vorübergehend pausiert. Vivoldi führt Testzustellungen durch, um zu prüfen, ob der Server wieder verfügbar ist.
Anfragen werden so verwaltet, dass sie sich nicht dauerhaft auf einem nicht erreichbaren Empfangsserver ansammeln. Kurze Unterbrechungen wie Kundendeployments oder vorübergehende Störungen werden automatisch behoben.
Ereignisse zur Coupon-Nutzung und Stempelvergabe gehen niemals verloren.
Da es sich um wichtige einmalige Ereignisse handelt, werden sie während erneuter Zustellversuche oder bei einer Ratenbegrenzung in einer Warteschlange gespeichert und nach Wiederaufnahme der Zustellung der Reihe nach übertragen.
Link-Klickereignisse treten wiederholt auf und alle Analysedaten werden in Vivoldi gespeichert. Daher erfolgen während vorübergehender Zustellbeschränkungen keine zusätzlichen Zustellversuche.
Wenn ein Webhook automatisch deaktiviert wird
Der Status eines Webhooks wird mit drei Zuständen verwaltet.
Mit dem Webhook-Filter auf der Listenseite können Webhooks nach Status angezeigt werden.
- Aktiv Der Webhook funktioniert normal und Ereignisse werden übertragen.
- Deaktiviert Der Webhook wurde vom Benutzer manuell deaktiviert.
- Vom System deaktiviert Der Webhook wurde von Vivoldi aufgrund wiederholter Zustellfehler automatisch deaktiviert. Bei der Deaktivierung wird eine E-Mail-Benachrichtigung gesendet.
Der Status Vom System deaktiviert kann nach Behebung des Problems auf dem Empfangsserver über das Dashboard wieder aktiviert werden.
Nach der Aktivierung wird die Zustellung für neue Ereignisse fortgesetzt. Ereignisse, die während der Deaktivierung aufgetreten sind, werden gemäß der vorherigen Richtlinie verarbeitet.
Wichtige Funktionen des Webhooks
Echtzeit-Automatisierung
Automatisieren Sie Ihre Marketing-, CRM- und Zahlungs-Workflows mit sofortigen Aktualisierungen zu Link-Aufrufen, Coupon-Nutzung sowie Stempel-Sammlung und Prämieneinlösung.
Enterprise-Sicherheit
Schützen Sie Link-, Coupon- und Stempel-Events vor Manipulation und Replay-Angriffen durch HMAC-SHA256-Signaturen, Inhalts-Hashing und Zeitstempel-Überprüfung.
Betriebsfreundlichkeit
Verarbeiten Sie Link-, Coupon- und Stempel-Events selbst bei Systemstörungen zuverlässig – mit mindestens einmaliger Zustellung, automatischen Wiederholungen, E-Mail-Benachrichtigungen und Deaktivierungslogik.
Verfügbarkeit nach Tarif
Webhooks sind ab dem Premium-Tarif und höher verfügbar. Die Anzahl verfügbarer Webhooks ist auf Basis der Anzahl der Ziele begrenzt, für die Webhooks aktiviert werden können.
| Kostenlos · Personal | Premium | Business | Business Plus | Enterprise | |
|---|---|---|---|---|---|
| Webhook-Nutzung | — | ✓ | ✓ | ✓ | ✓ |
| Einzellinks | — | 1 | 5 | 1 pro 1,000 Links pro Monat (max. 50) |
Unbegrenzt |
| Linkgruppen | — | — | — | — | Unbegrenzt |
| Einzelne Coupons | — | Unbegrenzt | Unbegrenzt | Unbegrenzt | Unbegrenzt |
| Coupongruppen | — | — | Unbegrenzt | Unbegrenzt | Unbegrenzt |
| Stempelkarten | — | 1 | 5 | 1 pro 1,000 Links pro Monat (max. 50) |
Unbegrenzt |
| Anfragen pro Minute / Stunde | — | 240 / 12,000 | 384 / 20,000 | Ab 614 / 32,000 | Ab 960 / 48,000 |
Das Aufruflimit für Webhooks wird auf 80 % des API-Aufruflimits festgelegt.
Im Business Plus-Tarif erhöht sich die Anzahl verfügbarer Webhooks entsprechend dem ausgewählten monatlichen Link-Erstellungslimit.
Der Enterprise-Tarif wird abhängig von Ihren Nutzungsanforderungen individuell vereinbart.
Detaillierte Werte finden Sie unter Aufruflimits nach Tarif.
Linkgruppen-Webhooks sind ausschließlich im Enterprise-Tarif verfügbar.
Wenn ein Webhook für eine Linkgruppe aktiviert wird, gilt er automatisch für alle Links innerhalb dieser Gruppe.
Ein Upgrade auf einen höheren Tarif erweitert die Nutzungsmöglichkeiten von Webhooks sofort.
Wenn Sie zu einem niedrigeren Tarif wechseln und die neue Grenze überschritten wird, werden die ältesten Ziele automatisch zuerst deaktiviert. Eine Liste der deaktivierten Ziele wird per E-Mail gesendet.
Auch wenn das Konto nach Ablauf des Nutzungszeitraums auf den kostenlosen Tarif wechselt, bleiben die Webhook-Einstellungen erhalten und werden bei einem erneuten kostenpflichtigen Tarif ohne zusätzliche Einrichtung automatisch wieder aktiviert.
✨ Echtzeit-Integration auf Enterprise-Niveau
Optimiert für Enterprise-Umgebungen, die große Mengen an Link-, Coupon- und Stempel-Events verarbeiten.
Basierend auf hochverfügbarer Infrastruktur und zuverlässigen Queueing-Systemen ermöglicht Vivoldi stabile Integrationen mit CRM-, Zahlungs- und Analyseplattformen ohne Eventverlust — selbst bei plötzlichen Traffic-Spitzen.