Webhooks (Pro)
Vorschau – noch nicht für alle Kunden freigeschaltet. Was hier beschrieben ist, kann sich bis zur allgemeinen Freigabe noch ändern.
Ein Webhook meldet Buchungen an ein System, das du selbst betreibst, zum Beispiel deine Buchhaltung oder Hausverwaltung. Destar sendet eine Meldung, sobald eine Buchung entsteht, sich ändert oder storniert wird.
Öffnen: Destar Channel → Synchronisation (Verbindungen) → Abschnitt Webhooks.
Einrichten
- Webhook hinzufügen und die Adresse deines Systems eintragen (öffentlich erreichbar,
https://). - Destar zeigt dir einen Schlüssel. Damit prüft dein System, dass die Meldung wirklich von Destar kommt (Signatur). Den Schlüssel kannst du später erneuern.
- Testmeldung senden, um die Verbindung zu prüfen.
Höchstens drei Webhooks je Betrieb.
Meldungen
| Art | Wann |
|---|---|
booking.created | neue Buchung |
booking.changed | geänderte Buchung |
booking.cancelled | Storno |
webhook.test | Testmeldung |
Eine Meldung enthält Kennungen der Buchung, Unterkunft und des Zimmers, Zeitraum, Gästezahl und Status, keine Gastdaten.
Protokoll und Fehler
Im Protokoll siehst du, ob dein System jede Meldung angenommen hat. Lehnt es Meldungen ab, wiederholt Destar den Versand. Scheitert eine Meldung endgültig, oder bleibt ein Webhook drei Tage ohne Erfolg und wird ausgeschaltet, bekommst du eine Benachrichtigung.