Webhooks

Webhooks sind eine Möglichkeit für Sie, Echtzeit-Ereignisse von Wink und TripPay bezüglich Ihres Kontos zu empfangen und darauf zu reagieren.

Beispiel

1. Eine Buchung erfolgt auf Wink.
2. Das Wink-Ereignis booking.created wird ausgelöst.
3. Ihr System hört aktiv auf dieses Ereignis.
4. Ihr System verfolgt eigene Analysen und verwendet dieses Ereignis, um seine Zeitreihendatenbank zu aktualisieren.

Beispiel für einen Webhook-Eintrag

Hinweis

Ein Wink-Webhook unterscheidet sich von einem TripPay-Webhook.

• Wenn Sie Wink-Ereignisse hören möchten, können Sie einen Webhook über das Extranet oder Studio erstellen.
• Wenn Sie TripPay-Ereignisse hören möchten, können Sie einen Webhook über Payment erstellen.

Für dieses Beispiel authentifizieren wir uns über Studio.

1. Nach der Authentifizierung klicken Sie auf Ihr Profil-Symbol oben rechts, und ein Menü erscheint.
2. Klicken Sie auf den Link Webhooks.
3. Sie werden auf Ihre Webhooks-Seite weitergeleitet.

Webhook erstellen

Achtung

Sie müssen ein Partnerkonto bei Wink oder ein Konto bei TripPay erstellen, bevor Sie einen Webhook anlegen, da Sie Ihren Webhook an ein bestimmtes Konto binden.

Hier sind die Schritte zum Erstellen eines Webhooks:

1. Klicken Sie auf der Webhooks-Seite auf die Schaltfläche Create new webhook.
2. Name Geben Sie Ihrem Webhook einen Namen. z. B. Wink Stalker
3. Enable Belassen Sie es aktiviert.
4. Entity name Verknüpfen Sie Ihren Webhook mit einem Ihrer bestehenden Konten. z. B. Cool Account
5. Events Wählen Sie die Ereignisse aus, die Sie interessieren. z. B. booking.created
6. Webhook URL Geben Sie die URL ein, unter der Sie Ereignisse von uns empfangen möchten. z. B. https://my.system.com/webhook/wink
7. Klicken Sie auf die Schaltfläche Save, um fortzufahren.

Sie werden zurück zu Ihrer Webhook-Liste geleitet und Ihr neuer Webhook ist einsatzbereit.

Webhook aktualisieren

Sie müssen Ihre App aktualisieren, wenn Sie:

• Ihren Webhook deaktivieren möchten.
• Mehr oder weniger Ereignisse hören möchten.
• Die URL Ihres Webhooks ändern möchten.

Um einen bestehenden Webhook zu aktualisieren, gehen Sie wie folgt vor:

1. Klicken Sie auf den Link Actions für den Webhook, den Sie aktualisieren möchten.
2. Klicken Sie unter Aktionen auf die Schaltfläche Update.
3. Nehmen Sie Ihre Änderungen am Webhook vor.
4. Klicken Sie auf die Schaltfläche Save, um fortzufahren.

Sie werden zurück zu Ihrer Webhook-Liste geleitet.

Webhook entfernen

Wenn Sie den Webhook nicht mehr benötigen, können Sie ihn entfernen.

Um einen Webhook zu entfernen, gehen Sie wie folgt vor:

1. Klicken Sie auf den Link Actions für den Webhook, den Sie entfernen möchten.
2. Klicken Sie unter Aktionen auf die Schaltfläche Remove.
3. Klicken Sie auf die Schaltfläche OK, um die Löschung zu bestätigen.

Sie werden zurück zu Ihrer Webhook-Liste geleitet.