Im Bereich „Booking & Payments“ können Benutzer eigene Webhooks einrichten, um Events zu erhalten, sobald Änderungen an der Plattform vorgenommen werden. Ein Webhook ermöglicht es einem System, ein anderes System automatisch in Echtzeit zu benachrichtigen, wenn etwas passiert, indem Daten an eine von Ihnen kontrollierte URL gesendet werden.
Unterstützte Events
Derzeit unterstützen wir die folgenden Webhook-Events:
- Purchase Update – Wird ausgelöst, wenn ein Kauf erstellt oder geändert wird. Die Payload enthält das aktualisierte Kaufobjekt. In YGB kann ein Kauf mehrere Positionen enthalten, einschließlich Buchungen.
- Purchase Paid – VA-spezifische Variante des Purchase Update; wird nur ausgelöst, wenn sich der Status eines Kaufs auf "paid" ändert.
- Booking Update – Wird ausgelöst, wenn eine Buchung erstellt oder geändert wird. Die Payload enthält das aktualisierte Buchungsobjekt. Sie können je nach Fokus dieses Event oder das Event "Purchase Update" verwenden, je nachdem, ob Sie sich ausschließlich auf Buchungen oder auf den umfassenderen Kaufkontext (der Buchungen umfasst) konzentrieren.
- User Update – Wird ausgelöst, wenn ein User erstellt oder aktualisiert wird. Die Payload enthält das aktualisierte User-Objekt.
So richten Sie einen Webhook ein
- Wenden Sie sich an das Trackman Support-Team, damit die Webhook-Integration für Sie aktiviert wird.
- Sobald ein Support-Mitarbeiter bestätigt, dass sie aktiviert ist, schließen Sie die Einrichtung bitte ab.
- Um einen Webhook einzurichten, gehen Sie zu Ihrem „Admin Panel“ > „Settings“ > „Manage Integrations“.
- Wenn Sie nicht auf diese Seite zugreifen können, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen. Wenden Sie sich in diesem Fall bitte an das Support-Team.
- Nachdem die Integration erstellt wurde, können Sie den Endpunkt definieren, an den Ihre Event-Daten gesendet werden sollen, und aus den oben aufgeführten Optionen die Events auswählen, die Sie verfolgen möchten.
- Ihr Webhook sendet erst Events, wenn der oben gezeigte Statusregler auf "Active" gesetzt ist.