Webhooks in Vigoba #
Webhooks ermöglichen die Automatisierung und Integration mit externen Systemen. Vigoba unterstützt sowohl eingehende als auch ausgehende Webhooks.
Incoming Webhooks (IPN) #
Empfangen Sie Daten von externen Systemen wie Ticketing-Plattformen.
Unterstützte Plattformen #
- Eventbrite – Ticket-Verkäufe
- Pretix – Event-Registrierungen
- Stripe – Zahlungen
- PayPal – IPN-Nachrichten
- Digistore24 – Digitale Verkäufe
- Benutzerdefiniert – Eigene Systeme
Konfiguration #
- Webhook-URL erstellen: Jeder Goodie Bag erhält eine eindeutige Webhook-URL
- Format wählen: Automatische Erkennung oder manuell festlegen
- Feld-Mapping: E-Mail-Feld im JSON-Payload definieren
- Aktionen: Automatischer Magic Link Versand aktivieren
Sicherheit #
- IP-Whitelist: Nur bestimmte IPs erlauben
- Signatur-Verifizierung: HMAC-SHA256, Stripe, PayPal
- Produkt-ID Filter: Nur bestimmte Produkte verarbeiten
Logging #
Alle Webhook-Aufrufe werden protokolliert:
- Zeitstempel
- Payload
- Verarbeitungsstatus
- Fehler-Details
Outgoing Webhooks #
Senden Sie Benachrichtigungen bei Ereignissen in Vigoba.
Verfügbare Events #
| Event | Beschreibung |
|---|---|
| bag.opened | Bag wurde geöffnet |
| bag.first_opened | Bag wurde erstmals geöffnet |
| recipient.accessed | Empfänger hat zugegriffen |
| recipient.first_access | Erster Zugriff eines Empfängers |
| goody.clicked | Link-Goody wurde geklickt |
| goody.downloaded | Download-Goody wurde heruntergeladen |
| goody.copied | Code wurde kopiert |
| recipient.added | Empfänger wurde hinzugefügt |
| recipient.removed | Empfänger wurde entfernt |
Konfiguration #
- Ziel-URL: HTTPS-Endpunkt für Benachrichtigungen
- Events: Auswahl der zu sendenden Events
- Header: Benutzerdefinierte HTTP-Header
- Signatur: HMAC-SHA256 Secret für Verifizierung
Retry-Logik #
- Automatische Wiederholungen bei Fehlern
- Exponentieller Backoff
- Konfigurierbare Anzahl Versuche
Test-Funktion #
Senden Sie Test-Webhooks, um Ihre Integration zu validieren.
Best Practices #
- Verwenden Sie HTTPS-Endpunkte
- Verifizieren Sie Signaturen
- Implementieren Sie idempotente Handler
- Überwachen Sie das Webhook-Log