Instructie
Moeilijkheidsgraad:
Evoko Home-koppeling implementeren: checklist test en productie
Praktische implementatiegids voor de Evoko Home-koppeling (bidirectionele boekingssync met Liso room-displays), met een checklist voor test en productie. De stappen beschrijven de volgorde; gebruik daarna de checklists per omgeving.
Aandachtspunten
- De ruimtes (Liso-displays) moeten in Evoko Home geconfigureerd en online zijn.
- Het group token (Default API Token) is het wachtwoord; TLS-verificatie doorgaans uit op poort 3002 (self-signed).
- Inbound is een poll (geen realtime); stel een reëel poll-interval in en een niet-afrekenende inbound-status.
- Bepaal het beleid betaalde ruimtes bewust; vul een PIN in als de ruimtes dat vereisen.
Checklist — testomgeving
- ☐ WebSocket-URL van de Evoko Home-server genoteerd.
- ☐ Group token (Default API Token, Global Settings) opgehaald.
- ☐ Ruimtes (Liso-displays) geconfigureerd en online; PIN genoteerd indien vereist.
- ☐ i-Reserve: koppeling type "Evoko Home" aangemaakt; Auth-tab ingevuld (URL, group token, TLS-verificatie uit); "Verbinding testen" geslaagd.
- ☐ Configuratie-tab: aanmaak- en verwijder-status, sjabloon display-onderwerp, PIN (indien nodig), poll-interval, beleid betaalde ruimtes, inbound-sync en inbound-status ingesteld.
- ☐ Mapping: "Ruimtelijst verversen" uitgevoerd; producten gekoppeld aan de juiste Evoko-ruimtes.
- ☐ Koppeling op actief gezet.
- ☐ Outbound getest: reservering → aanmaak-status → verschijnt op het display; bijwerken/verwijderen gecontroleerd.
- ☐ Inbound getest (indien aan): boeking op display → na poll aangemaakt in i-Reserve met de inbound-status.
Checklist — productieomgeving
- ☐ Productie-server-URL en productie-group-token gebruikt.
- ☐ Echte ruimtes correct gemapt aan de productie-producten (Ruimtelijst verversen).
- ☐ Statussen (aanmaken/verwijderen + inbound) afgestemd op de echte boekingsflow.
- ☐ Beleid betaalde ruimtes en inbound-status zo dat de betaalflow niet wordt omzeild.
- ☐ Eerste live sync geverifieerd in beide richtingen.
- ☐ Rollback bekend: koppeling op inactief zetten stopt outbound; inbound-sync uit stopt het oppikken van display-boekingen.
Noteer de WebSocket-URL van de server en haal het group token (Default API Token) op onder Global Settings; zorg dat de ruimtes (Liso-displays) geconfigureerd en online zijn.
Voeg in Beheer > Integraties een koppeling type "Evoko Home" toe; vul de WebSocket-URL, integratie-gebruiker en group token in, zet TLS-verificatie uit (self-signed poort 3002) en klik Verbinding testen.
Stel op de Configuratie-tab de aanmaak- en verwijder-status, het sjabloon display-onderwerp, een eventuele PIN, het poll-interval, het beleid betaalde ruimtes en (voor tweerichtings) inbound-sync + inbound-status in.
Klik op de Mapping-tab op "Ruimtelijst verversen" om de Evoko-ruimtes op te halen (allRooms) en koppel elk i-Reserve-object (product) aan de juiste ruimte.
Zet de koppeling actief; test outbound (reservering naar aanmaak-status → verschijnt op display) en, indien ingeschakeld, inbound (boeking op display → na poll aangemaakt in i-Reserve).
