Evoko Home-koppeling instellen: stappen aan de Evoko- en i-Reserve-kant
De Evoko Home-koppeling vereist configuratie aan twee kanten: eerst een paar gegevens uit Evoko Home (server-URL en API-token), daarna de koppeling in i-Reserve — authenticatie, gedrag (statussen, poll, betaalde ruimtes) en de ruimte-mapping.
1. Aan de Evoko Home-kant
- Noteer de WebSocket-URL van de Evoko Home-server, bijv.
wss://rooms.example.com:3002/websocket. - Haal onder Global Settings het “Default API Token” op — dit is het group token dat als wachtwoord dient.
- Zorg dat de te koppelen ruimtes (Liso-displays) in Evoko Home geconfigureerd en online zijn.
- Controleer of de ruimtes PIN-authenticatie aan hebben staan; zo ja, noteer de PIN.
2. Aan de i-Reserve-kant — Authenticatie-tab
Voeg in Beheer > Integraties een nieuwe koppeling toe van het type Evoko Home en vul de authenticatie in.
| Veld | Wat in te vullen |
|---|---|
| WebSocket-URL | Volledige DDP-endpoint van de server (bijv. wss://rooms.example.com:3002/websocket). Verplicht. |
| Integratie-gebruiker | Laat leeg voor de standaard defaultDevIntegrationUser. |
| Group token | Het “Default API Token” uit Evoko Home (Global Settings). Verplicht. |
| TLS-certificaat verifiëren | Poort 3002 heeft standaard een self-signed certificaat; zet uit tenzij daar een geldig publiek certificaat is geïnstalleerd. |
Klik op Verbinding testen: i-Reserve maakt verbinding, logt in en meldt of het lukt.
3. Configuratie-tab
| Veld | Wat het doet |
|---|---|
| Maak Evoko-event aan bij status | De reserveringsstatus(sen) waarbij de boeking naar de gekoppelde Evoko-ruimte wordt gestuurd. Meervoudige selectie. |
| Verwijder Evoko-event bij status | De status(sen) waarbij de boeking weer van het display wordt verwijderd. Meervoudige selectie. |
| Sjabloon display-onderwerp | De enkele regel die op het display verschijnt (Evoko-boekingen hebben alleen een onderwerp, geen body). Gebruikt de standaard boekingsvariabelen zoals {PROD_DESC}, {BOOKING_NUMBER}, {FROMDATE}. Standaard: {PROD_DESC} - {BOOKING_NUMBER}. |
| PIN | PIN die wordt meegestuurd bij boekingswijzigingen. Alleen nodig als de ruimtes PIN-authenticatie aan hebben (anders PinIsRequired). Laat leeg als geen PIN vereist is. |
| Poll-interval (minuten) | Hoe vaak de inbound-poll een momentopname neemt om display-boekingen te detecteren (1–60). |
| Beleid betaalde ruimtes | Hoe display-boekingen op betaalde ruimtes worden afgehandeld (boeken op het display omzeilt de betaalflow). |
| Inbound-sync (display-boekingen) | Indien aan haalt een poll boekingen op die op de displays zijn gemaakt en maakt ze aan in i-Reserve. Staat dit uit, dan is de koppeling alleen outbound. |
| Status inbound-boeking | De status die reserveringen krijgen die uit een display-boeking zijn aangemaakt. Gebruik een niet-afrekenende status zodat display-boekingen de betaling niet omzeilen. |
3.1 Mapping: object → Evoko-ruimte
Op het Mapping-tabblad koppel je per i-Reserve-object (product) een Evoko-ruimte. Klik eerst op Ruimtelijst verversen om de ruimtes live uit Evoko op te halen (allRooms); kies daarna links het product en rechts de bijbehorende ruimte. Alleen gemapte ruimtes worden gesynchroniseerd.
4. Activeren
Sla op en zet de koppeling op actief. Test outbound door een reservering naar de “aanmaken”-status te brengen en te controleren dat hij op het display verschijnt; test inbound (indien aan) door op een display te boeken en te wachten tot de poll de reservering in i-Reserve aanmaakt.
