Evoko-Home-Integration einrichten: Schritte auf der Evoko- und i-Reserve-Seite
Die Evoko-Home-Integration erfordert Konfiguration auf zwei Seiten: zuerst einige Angaben aus Evoko Home (Server-URL und API-Token), dann die Integration in i-Reserve — Authentifizierung, Verhalten (Status, Poll, kostenpflichtige Räume) und die Raumzuordnung.
1. Auf der Evoko-Home-Seite
- Notieren Sie die WebSocket-URL des Evoko-Home-Servers, z. B.
wss://rooms.example.com:3002/websocket. - Holen Sie unter Global Settings das “Default API Token” — dies ist das Group-Token, das als Passwort dient.
- Stellen Sie sicher, dass die zu verknüpfenden Räume (Liso-Displays) in Evoko Home konfiguriert und online sind.
- Prüfen Sie, ob an den Räumen die PIN-Authentifizierung aktiviert ist; falls ja, notieren Sie die PIN.
2. Auf der i-Reserve-Seite — Registerkarte Authentifizierung
Fügen Sie unter Verwaltung > Integrationen eine neue Integration vom Typ Evoko Home hinzu und füllen Sie die Authentifizierung aus.
| Feld | Was einzugeben ist |
|---|---|
| WebSocket-URL | Vollständiger DDP-Endpunkt des Servers (z. B. wss://rooms.example.com:3002/websocket). Erforderlich. |
| Integrationsbenutzer | Leer lassen für den Standard defaultDevIntegrationUser. |
| Group-Token | Das “Default API Token” aus Evoko Home (Global Settings). Erforderlich. |
| TLS-Zertifikat prüfen | Port 3002 hat standardmäßig ein selbstsigniertes Zertifikat; aus lassen, es sei denn, dort ist ein gültiges öffentliches Zertifikat installiert. |
Klicken Sie auf Verbindung testen: i-Reserve stellt die Verbindung her, meldet sich an und meldet, ob es gelingt.
3. Registerkarte Konfiguration
| Feld | Was es tut |
|---|---|
| Evoko-Event bei Status anlegen | Der/die Buchungsstatus, bei dem/denen die Buchung an den zugeordneten Evoko-Raum gesendet wird. Mehrfachauswahl. |
| Evoko-Event bei Status entfernen | Der/die Status, bei dem/denen die Buchung wieder vom Display entfernt wird. Mehrfachauswahl. |
| Vorlage Display-Betreff | Die einzelne Zeile, die auf dem Display erscheint (Evoko-Buchungen haben nur einen Betreff, keinen Textkörper). Verwendet die Standard-Buchungsvariablen wie {PROD_DESC}, {BOOKING_NUMBER}, {FROMDATE}. Standard: {PROD_DESC} - {BOOKING_NUMBER}. |
| PIN | PIN, die bei Buchungsänderungen mitgesendet wird. Nur erforderlich, wenn an den Räumen die PIN-Authentifizierung aktiviert ist (sonst PinIsRequired). Leer lassen, wenn keine PIN erforderlich ist. |
| Poll-Intervall (Minuten) | Wie oft der Inbound-Poll eine Momentaufnahme macht, um Display-Buchungen zu erkennen (1–60). |
| Richtlinie kostenpflichtige Räume | Wie Display-Buchungen auf kostenpflichtigen Räumen behandelt werden (Buchen auf dem Display umgeht den Zahlungsablauf). |
| Inbound-Sync (Display-Buchungen) | Wenn aktiviert, holt ein Poll Buchungen ab, die auf den Displays vorgenommen wurden, und legt sie in i-Reserve an. Wenn aus, ist die Integration nur Outbound. |
| Status Inbound-Buchung | Der Status, den Reservierungen erhalten, die aus einer Display-Buchung angelegt wurden. Verwenden Sie einen nicht abrechnenden Status, damit Display-Buchungen die Zahlung nicht umgehen. |
3.1 Zuordnung: Objekt → Evoko-Raum
Auf der Registerkarte Zuordnung verknüpfen Sie jedes i-Reserve-Objekt (Produkt) mit einem Evoko-Raum. Klicken Sie zuerst auf Raumliste aktualisieren, um die Räume live aus Evoko abzurufen (allRooms); wählen Sie dann links das Produkt und rechts den passenden Raum. Nur zugeordnete Räume werden synchronisiert.
4. Aktivieren
Speichern Sie und setzen Sie die Integration auf aktiv. Testen Sie Outbound, indem Sie eine Buchung auf den “Anlegen”-Status setzen und prüfen, ob sie auf dem Display erscheint; testen Sie Inbound (falls aktiviert), indem Sie auf einem Display buchen und warten, bis der Poll die Reservierung in i-Reserve anlegt.
