Webhook-Integration

Webhooks ermöglichen es Ihren Systemen, Echtzeit-Benachrichtigungen zu erhalten, wenn Ereignisse in Ihrem Wink-Konto stattfinden — neue Buchungen, Stornierungen, Zahlungsaktualisierungen und mehr. Diese Anleitung führt Sie durch die Einrichtung und Best Practices.

Zielgruppe

Diese Anleitung richtet sich an Entwickler, die Wink mit externen Systemen wie Property-Management-Systemen (PMS), Channel Managern, CRMs oder benutzerdefinierten Dashboards integrieren.

Funktionsweise von Webhooks

1. Sie registrieren eine Webhook-URL bei Wink.
2. Wenn ein Ereignis eintritt (z. B. eine neue Buchung), sendet Wink eine HTTP POST-Anfrage an Ihre URL.
3. Ihr Server verarbeitet die Nutzlast und antwortet mit 200 OK.

Einrichtung eines Webhooks

1. Melden Sie sich in Ihrem Konto an (Extranet, Studio oder TripPay — alle unterstützen Webhooks).
2. Navigieren Sie zu Applications und dann zu Webhooks. Siehe Webhooks.
3. Klicken Sie auf Create webhook.
4. Geben Sie einen Namen ein (z. B. “PMS Booking Sync”).
5. Geben Sie Ihre Webhook-URL ein — den HTTPS-Endpunkt auf Ihrem Server.
6. Wählen Sie Ereignisse aus — Wählen Sie bestimmte Ereignisse zum Abonnieren aus oder lassen Sie das Feld leer, um alle Ereignisse zu erhalten.
7. Schalten Sie Enabled ein.
8. Klicken Sie auf Save.

Ereignistypen

Wink unterstützt über 64 Webhook-Ereignistypen in Kategorien wie Kontoverwaltung, Buchungsverträge, Zahlungen, Channel-Manager-Updates und Verwaltung von Entitäten. Häufige Ereignisse sind:

Kategorie	Beispiele
Buchung	booking.create, booking.cancelled
Buchungsvertrag	booking.contract.created, booking.contract.processing, booking.contract.cancelled
Zahlung	internal.payment.succeeded, internal.payment.failed
Rückerstattungen	booking.contract.refund.partial, booking.contract.refund.full
Channel Manager	channel-manager.update.rate, channel-manager.update.availability
Konto	account.create, account.status.updated

Für eine vollständige Liste aller Ereignistypen mit Beschreibungen siehe den Webhook Events Catalog.

Alle 64+ Ereignistypen anzeigen

Tipp

Abonnieren Sie während der Entwicklung zunächst alle Ereignisse. Sobald Sie die Nutzlasten verstehen, beschränken Sie sich auf die Ereignisse, die Ihr System benötigt.

Best Practices

• Verwenden Sie HTTPS — Wink sendet Nutzlasten nur an HTTPS-Endpunkte.
• Schnelle Antwort — Geben Sie so schnell wie möglich ein 200 OK zurück, sobald Sie die Nutzlast erhalten. Führen Sie aufwändige Verarbeitung asynchron durch.
• Idempotenz — Ihr Handler sollte idempotent sein. Wink kann die Zustellung erneut versuchen, wenn keine 200-Antwort empfangen wird.
• Quelle validieren — Verifizieren Sie, dass eingehende Anfragen von Wink stammen, bevor Sie sie verarbeiten.
• Protokollierung — Protokollieren Sie jede empfangene Webhook-Nutzlast. Das erleichtert die Fehlersuche bei Integrationsproblemen erheblich.

Pausieren und Löschen

Sie können einen Webhook deaktivieren, ohne ihn zu löschen. Dadurch wird die Zustellung pausiert, sodass Sie Fehler beheben können, ohne Ihre Konfiguration zu verlieren. Wenn Sie bereit sind, schalten Sie ihn wieder ein.

Das Löschen eines Webhooks entfernt ihn dauerhaft. Jede Integration, die auf diesen Webhook angewiesen ist, erhält keine Benachrichtigungen mehr.

Weiterführende Informationen

• Webhook Events Catalog — Vollständige Liste aller 64+ Ereignistypen.
• Webhooks — Vollständige Referenz zur Webhook-Verwaltung.
• Applications — Verwalten Sie Ihre API-Zugangsdaten.
• Developers > APIs — Vollständige API-Dokumentation.