Event & Data Hub
Der Event & Data Hub ist der Teil von LIKE MAGIC, der alles, was in deinen Properties passiert (eine eingehende Buchung, eine auscheckende Reservierung, ein sich änderndes Folio, eine sich öffnende Tür, eine abgeschlossene Aufgabe, eine eingehende Nachricht), in einen Strom von Events verwandelt, auf die externe Systeme reagieren können.
Statt dass eine Integration die API abfragen und „hat sich schon etwas geändert?" fragen muss, kann sie über den Event & Data Hub einmal abonnieren und danach jedes relevante Event erhalten, sobald es eintritt. Er ist das Rückgrat hinter Webhooks & Events und hinter dem Streaming von Property-Aktivität in Analytics- und Reporting-Tools.
Dies ist ein Konzeptartikel für Administratoren und Entwickler, die verstehen möchten, was der Hub ist und was er kann, bevor sie etwas anbinden.
1. Was der Hub ist
Der Event & Data Hub ist ein Plattformdienst, der Events aggregiert, die überall in LIKE MAGIC entstehen, und sie Systemen ausserhalb der Plattform zur Verfügung stellt. Er sitzt zwischen den operativen Teilen von LIKE MAGIC (Reservierungen, Folios, Türen, Aufgaben, Messaging, Konfiguration) und allem, womit du sie verbinden möchtest (einer Partnerplattform, einer Automatisierung, einem Data Warehouse, einem Dashboard).
Betrachte den Event-Katalog in diesem Artikel als aktuelle Momentaufnahme und nicht als festen Vertrag. Prüfe die genauen für dein Konto verfügbaren Events, bevor du dagegen entwickelst.
2. Events, nicht nur Datensätze
Eine klassische Integration liest Datensätze: Sie fragt die API nach dem aktuellen Zustand einer Reservierung, eines Folios oder einer Aufgabe. Der Event & Data Hub ergänzt Events: eine Benachrichtigung, dass etwas passiert ist, eine Reservierung wurde erstellt, ein Folio aktualisiert, eine Türöffnung erfolgreich, eine Aufgabe abgeschlossen.
Events sind nützlich, weil sie Zeitpunkt und Absicht transportieren:
- Du erfährst, wann sich etwas geändert hat, nicht nur, dass es jetzt anders ist.
- Du kannst in dem Moment reagieren, in dem es passiert: eine Nachricht auslösen, ein externes System aktualisieren, einen Workflow starten.
- Du vermeidest ständiges Abfragen nach Änderungen, die vielleicht nie kommen.
3. Was du damit tun kannst
Der Hub unterstützt zwei grundlegende Muster:
- Ausgehende Webhooks: abonniere mit einem externen Endpunkt eine gewählte Menge von Events und lass LIKE MAGIC jedes davon als HTTP-Aufruf an diesen Endpunkt liefern. Das ist die operative Funktion, die in Webhooks & Events beschrieben ist.
- Analytics und Daten-Export: streame Property-Aktivität (Buchungen, Reservierungen, Folios, Aufgaben, Messaging) in Reporting-, Business-Intelligence- oder Data-Warehouse-Tools, damit sie zusammen mit deinen übrigen Daten ausgewertet werden kann.
Beide Muster lesen aus demselben zugrunde liegenden Event-Strom; Webhooks sind lediglich der Liefermechanismus, den du selbst in der Operations Platform konfigurierst.
4. Der Event-Katalog
Events sind nach dem Bereich der Plattform gruppiert, aus dem sie stammen. Die wichtigsten Familien sind:
| Bereich | Beispiel-Events |
|---|---|
| Buchung (IBE) | Buchung erfolgreich / fehlgeschlagen, Buchung erstellt / aktualisiert |
| Reservierung | erstellt, aktualisiert, eingecheckt, ausgecheckt, storniert, No-Show, Zimmer-Upgrade, Pre-Check-in-/Pre-Check-out-Fortschritt |
| Folio & Abrechnung | Folio erstellt, Folio aktualisiert |
| Türen & Schlösser | Türöffnung erfolgreich / fehlgeschlagen, Türzugangs-Sync, Schloss- und Gateway-Verbindung verloren / wiederhergestellt |
| Einheiten & Profile | Einheit erstellt / aktualisiert, Profil erstellt / aktualisiert / zusammengeführt, Profilsprache aktualisiert |
| Aufgaben | Aufgabe erstellt, aktualisiert, abgeschlossen |
| Messaging | Konversation erstellt / aktualisiert / gelöst, Nachricht gesendet / empfangen / fehlgeschlagen |
| Benachrichtigungen | Reservierungs-, Buchungs- und Kontobenachrichtigung gesendet / fehlgeschlagen |
| Konfiguration & Promo | Kontokonfiguration aktualisiert, Promo-Code erstellt / aktualisiert / gelöscht / verwendet |
Du wählst genau aus, welche davon dein Abonnement erhält. Siehe Webhooks & Events dazu, wie du Topics auswählst.
5. Wie der Zugriff gesteuert wird
Ob du den Hub nutzen kannst, hängt von deinem Pricing-Tier, deiner Rolle und, bei einigen Events, vom PMS der Property ab:
- Pricing. Webhook-Abonnements benötigen das Platform Pricing. Auf Core wird die Seite der Webhook-Abonnements gesperrt und mit Upgrade-Hinweis angezeigt. Siehe Pricing-Tiers.
- Rolle. Webhook-Abonnements werden auf Kontoebene verwaltet. Die Rolle Account Administrator (
account-admin) kann sie bearbeiten, Account Viewer (account-viewer) sieht die Seite nur lesend. - PMS. Einige Events existieren nur dort, wo das angebundene Property-Management-System sie ausgibt (siehe nächster Abschnitt).
Da der Hub sensible operative Daten nach aussen tragen kann, behandle den Zugriff darauf (und die Service-Konten und Secrets, die ihn nutzen) als sicherheitsrelevant.
6. PMS und Event-Abdeckung
LIKE MAGIC unterstützt die folgenden PMS:
- Apaleo
- Mews
- Oracle Opera Cloud über OHIP
Reservierungs-, Folio- und Buchungs-Events stammen aus der PMS-Integration, daher hängen die genauen Events, die eine Property ausgibt, und ihr Zeitpunkt, vom PMS dieser Property ab. Events, die intern zu LIKE MAGIC gehören (Aufgaben, Messaging, Türen, Konfiguration, Promo-Codes), sind nicht in gleicher Weise an das PMS gebunden. Prüfe die Event-Abdeckung immer gegen die konkrete Property, die du anbindest.
7. Erste Schritte
- Um einen Endpunkt für Events zu abonnieren, folge Webhooks & Events.
- Um einem externen System die Authentifizierung an der API und das Lesen von Events zu ermöglichen, gib ihm ein eingeschränktes Service-Konto (die Scopes
event_log.readundmetric.readdecken den Event- und Metrik-Zugriff ab).
8. Fazit
Der Event & Data Hub lässt die Aussenwelt in Echtzeit auf das reagieren, was in deinen Properties passiert, statt wiederholt zu fragen, was sich geändert hat. Nutze ihn, um über Webhooks Automatisierungen anzutreiben und Property-Aktivität in deinen Analytics-Stack einzuspeisen, beschränkt auf genau das, was jede Integration benötigt.