Webhooks benachrichtigen Ihr System in dem Moment, in dem die Gäste einer Buchung ihre Registrierung abschließen – um Ihr PMS zu aktualisieren, Nachrichten auszulösen oder Zugang zu gewähren, ohne abzufragen. Zum Erstellen von Buchungen aus Ihrer Software siehe die Anleitung zur Buchungs-API.
Verfügbare Benachrichtigungen
Sie erhalten Benachrichtigungen zur Registrierung Ihrer Buchungen, etwa wenn die Registrierung einer Buchung abgeschlossen ist. So sieht eine Benachrichtigung aus:
{
"id": "0192f3a4-…",
"type": "guest_registration.completed",
"version": 1,
"data": {
"property_id": "prop_…",
"property_name": "Casa Sol",
"booking": { "reference": "HMABC123", "check_in": "2026-11-10", "check_out": "2026-11-12" },
"guests": { "registered": 3, "expected": 4 },
"complete": true,
"completed_at": "2026-10-15T09:59:00.000Z"
}
}
Die Benachrichtigung enthält keine Ausweisdokumente, Geburtsdaten, Unterschriften, Namen, E-Mails oder Telefonnummern.
Einrichtung
- Öffnen Sie Integrationen → API → Webhooks.
- Wählen Sie die Unterkunft (jede Unterkunft hat ihr eigenes Ziel).
- Fügen Sie im Webhook-Panel die URL Ihres Servers hinzu und wählen Sie die gewünschten Ereignisse.
- Kopieren Sie das Signaturgeheimnis, um Benachrichtigungen auf Ihrem Server zu verifizieren.
Verwaltung im Dashboard
Im Panel können Sie:
- Zieladressen hinzufügen, bearbeiten, pausieren und löschen.
- Die Ereignisse wählen, die jede Adresse abonniert.
- Den Zustellungsverlauf einsehen: Status, Antwortcode, Versuche und Inhalt jeder Benachrichtigung.
- Eine einzelne Benachrichtigung manuell erneut senden.
- Fehlgeschlagene Benachrichtigungen erneut senden: alles auf einmal nachholen, was Ihren Server während eines Ausfalls nicht erreicht hat.
- Testereignisse senden, um Ihre Integration zu prüfen (sie tragen
"test": trueund Beispieldaten). - Das Signaturgeheimnis einsehen und rotieren. Nach der Rotation bleibt das alte 24 Stunden gültig, damit Sie Ihren Server ohne Verluste aktualisieren können.
Automatische Wiederholungen
Antwortet Ihr Server nicht mit einem 2xx-Code, wird die Benachrichtigung automatisch mit steigenden Wartezeiten wiederholt. Schlägt eine Adresse mehrere Tage in Folge fehl, wird sie deaktiviert; Sie können sie im Panel wieder aktivieren und Ausstehendes erneut senden.
Signatur prüfen
Jede Benachrichtigung enthält Header mit der Kennung der Benachrichtigung, dem Zeitstempel und der Signatur. Prüfen Sie die Signatur immer mit dem Geheimnis Ihres Webhooks und dem unveränderten Body. Wenn Sie Hilfe bei der Umsetzung brauchen, schreiben Sie uns über Kontakt.
Lehnen Sie Benachrichtigungen mit altem Zeitstempel ab, um böswillige Wiederholungen zu verhindern.
Bewährte Vorgehensweisen
- Antworten Sie schnell mit einem 2xx und verarbeiten Sie die Benachrichtigung danach.
- Behandeln Sie Duplikate: Die Zustellung kann sich wiederholen. Nutzen Sie das Feld
iddes Ereignisses, um bereits verarbeitete zu ignorieren. - Verlassen Sie sich nicht auf die Reihenfolge des Eintreffens.
- Ignorieren Sie Testereignisse (
"test": true) in der Produktion. - Verwenden Sie für Ihre Zieladresse immer HTTPS.