Evoko-Home-Integration: Einführung und funktionaler Hintergrund

Was ist Evoko Home?

Evoko Home ist die Verwaltungsplattform hinter den Evoko Liso Raumdisplays — den Touchscreens neben einem Besprechungsraum, die anzeigen, ob der Raum frei oder belegt ist, und auf denen man vor Ort buchen kann. i-Reserve verbindet sich mit Evoko Home, um Buchungen bidirektional zu synchronisieren: Buchungen aus i-Reserve erscheinen auf dem richtigen Display, und Buchungen, die jemand auf einem Display vornimmt, fließen als Reservierung zurück nach i-Reserve. Funktional vergleichbar mit der Outlook- und Google-Kalender-Integration, aber für die Raumdisplays vor Ort.

Wie die Integration funktioniert

Die Integration funktioniert in zwei Richtungen, pro Raum verknüpft:

1. Outbound (i-Reserve → Display). Ein i-Reserve-Objekt (Produkt) ist in der Zuordnung mit einem bestimmten Evoko-Raum verknüpft. Sobald eine Buchung einen konfigurierten Status erreicht, sendet i-Reserve die Buchung an diesen Raum (anlegen). Bei einem anderen Status wird die Buchung wieder vom Display entfernt. Aktualisieren und Check-in (Bestätigen) funktionieren genauso.
2. Inbound (Display → i-Reserve). Bucht jemand direkt auf einem Display, erkennt i-Reserve dies über einen Poll: Alle paar Minuten fragt i-Reserve den aktuellen Stand aller Buchungen ab und vergleicht ihn mit dem, was es bereits kennt. Eine Buchung, die auf dem Display vorhanden ist, aber nicht bei uns, wird als Reservierung angelegt; eine Buchung, die vom Display verschwunden ist, wird bei uns storniert.

Technik: DDP über WebSocket

Evoko Home bietet keine REST-API und keine Webhooks. Die Kommunikation läuft über DDP (das JSON-Nachrichtenprotokoll von Meteor) über eine WebSocket-Verbindung (wss://). i-Reserve öffnet eine ausgehende Verbindung zum Evoko-Home-Server, meldet sich an und feuert die erforderlichen Befehle ab. Es läuft keine zusätzliche Laufzeitumgebung und kein Daemon; die Inbound-Seite ist eine kurzlebige Poll-Aufgabe, keine dauerhaft offene Verbindung.

• Outbound-Befehle: createBooking, updateEvent, deleteEvent, confirmMeeting (Check-in).
• Inbound-Abfrage: allBookings (Momentaufnahme aller Buchungen) und allRooms (alle Räume mit ihren roomIds, für die Zuordnung erforderlich).

Authentifizierung

i-Reserve meldet sich mit einem Integrationsbenutzer (Standard defaultDevIntegrationUser) und einem Group-Token an. Dieses Token ist das “Default API Token” unter Global Settings in Evoko Home und dient als Passwort. Die Verbindung ist verschlüsselt (wss); eine Sitzung bleibt lange gültig und i-Reserve meldet sich pro Synchronisierung erneut an.

Raumzuordnung

Das Herzstück der Integration ist die Zuordnung: Jedes i-Reserve-Objekt (Produkt) wird mit einer Evoko roomId verknüpft. Diese Raumliste holt i-Reserve live mit allRooms ab (Schaltfläche “Raumliste aktualisieren”). Nur zugeordnete Räume werden synchronisiert; Buchungen auf nicht verknüpften Räumen werden ignoriert.

Kostenpflichtige Räume

Eine Buchung auf einem Display umgeht den normalen Zahlungsablauf von i-Reserve. Für kostenpflichtige Räume ist daher einstellbar, wie Inbound-Buchungen behandelt werden (die Richtlinie für kostenpflichtige Räume): nur Outbound synchronisieren, Inbound ablehnen oder zulassen. Die sicherste Wahl ist die Standardeinstellung, damit keine unerwünschte kostenlose Buchung auf einem kostenpflichtigen Raum entsteht. Geben Sie Inbound-Reservierungen außerdem einen nicht abrechnenden Status.

Einschränkungen / Hinweise

• Poll-Latenz. Eine Display-Buchung wird bei uns nach höchstens einem Poll-Intervall sichtbar (einstellbar, typisch 1–2 Minuten). Auf dem Display selbst erscheint die Buchung natürlich sofort.
• 7-Tage-Fenster. Die Buchungssammlung von Evoko synchronisiert in der Regel 7 Tage im Voraus; der Inbound-Horizont beträgt daher ebenfalls ~7 Tage.
• Viertelstunden. Evoko akzeptiert Endzeiten nur auf :00/:15/:30/:45; i-Reserve rundet Richtung Evoko nach außen.
• PIN. Ist die PIN-Authentifizierung an den Räumen aktiviert, erfordern Änderungsbefehle eine PIN (sonst PinIsRequired).
• Zertifikat. Port 3002 wird standardmäßig mit einem selbstsignierten Evoko-Zertifikat ausgeliefert; die TLS-Prüfung ist dann aus (Empfehlung: ein gültiges öffentliches Zertifikat installieren).