Kulku.io

Kulku.io on Thrilin kumppani kulunvalvonnassa. Toisin kuin Thrilin muut kulunvalvontaintegraatiot, Kulku.io ei luo PIN-koodeja eikä kulkutunnisteita Thrilin kautta. Sen sijaan asiakas saa Thril-sovellukseen oven avauspainikkeen, ja Thril päättää milloin painike toimii — varauksen aikana tai jäsenyyden sallittuina kulkuaikoina.

Edellytykset

Tarvitset Kulku.io-laitteiston, joka on määritetty liikuntapaikallesi. Kulkutech toimittaa sinulle API-osoitteen, rakennuksen tunnuksen, asiakastunnisteen ja salausavaimen suoraan; syötät ne itse Thriliin. Apua saat Kulkutech-yhteyshenkilöltäsi tai Thrilin tuesta.

Käyttöönotto

1. Avaa Asetukset → Järjestelmä → Integraatiot → Kulku.io
2. Syötä API-osoite, Rakennuksen tunnus, Asiakastunniste ja Salausavain
3. Määritä siirtymäajat ja varaohjeet (ks. alla)
4. Vaihda integraation tila Aktiiviseksi
5. Valitse Luo integraatio (tai Päivitä integraatio) tallentaaksesi
6. Listaa kunkin resurssin ovet resurssin asetuksissa ja kunkin jäsenyyden ovet jäsenyyden integraatioasetuksissa
7. (Valinnainen) Varmista määritys painamalla Testaa avaamalla lukko

Asetukset

• API-osoite: Kulkutechin antama osoite, esimerkiksi https://liikuntapaikkasi.kulku.io
• Rakennuksen tunnus: Kulkutechin antama rakennuksen tunniste
• Asiakastunniste: asiakastunnisteesi Kulku.iossa
• Salausavain: allekirjoittaa jokaisen avauspyynnön. Thril ei koskaan lähetä itse avainta Kulku.iolle.
• Laitetunniste: valinnainen, täytä vain jos Kulkutech niin ohjeistaa
• Pääsyn siirtymäajat: kuinka monta minuuttia ennen ja jälkeen varauksen oven avauspainike toimii
• Varaohjeet: viesti, joka näytetään asiakkaille, jos Thril havaitsee ongelman Kulku.iossa (esimerkiksi "Jos ovi ei aukea, ota yhteyttä liikuntapaikan henkilökuntaan."). Ota käyttöön Näytä varaohjeet aina, niin viesti näkyy kaikille asiakkaille Kulku.ion tilasta riippumatta. Voit myös määrittää resurssikohtaiset varaohjeet kunkin resurssin asetuksista.
• Ovet (resurssi- ja jäsenyyskohtaisesti): lukkojen nimet, jotka tämä resurssi tai jäsenyys avaa

Ovet

Kulku.io ei tarjoa tapaa hakea lukkojen listaa, joten ovien nimet kirjoitetaan käsin ja niiden on vastattava täsmälleen Kulku.iossa määritettyjä lukkojen nimiä — esimerkiksi Etuovi. Resurssilla tai jäsenyydellä voi olla useita ovia; jokainen näkyy asiakkaalle omana painikkeenaan. Näyttönimi on se, minkä asiakas näkee, joten se voi poiketa lukon nimestä.

Jos resurssille ei ole listattu yhtään ovea, sen asiakkaat eivät saa painiketta lainkaan.

Jäsenyydet

Jäsenet saavat oven avauspainikkeen jäsenyyden integraatiomäärityksessä asetettuina sallittuina kulkuaikoina. Näiden aikojen ulkopuolella painike ei toimi — kuten ei myöskään jäsenillä, joiden jäsenyys on tauolla, joilla on maksamattomia jaksoja tai joiden jäsenyys ei ole vielä (tai enää) voimassa.

Vianmääritys

• Testaa avaamalla lukko tarkistaa API-osoitteen, rakennuksen tunnuksen, asiakastunnisteen ja salausavaimen kerralla. Huomaa, että se avaa oikean oven. Kulku.ion testiympäristössä pyyntö onnistuu mutta ovi ei aukea, koska testipalvelin ei ole yhteydessä laitteistoon.
• "Cannot find lock by name" tarkoittaa, ettei oven nimi Thrilissä vastaa lukon nimeä Kulku.iossa.
• "Access denied: wrong digest" tarkoittaa, että salausavain, rakennuksen tunnus tai asiakastunniste on väärin.
• Integraation poistaminen käytöstä poistaa oven avauspainikkeen heti kaikilta varauksilta ja jäsenyyksiltä. Kulku.ion puolella ei tarvitse siivota mitään, koska Thril ei luo sinne mitään tietueita.
• Jos tarvitset apua Kulku.io-laitteiston tai -ohjelmiston määrityksessä Thrilin ulkopuolella, ota yhteyttä Kulkutech-yhteyshenkilöösi. Integraatioon Thrilissä liittyvissä asioissa ota yhteyttä Thrilin tukeen.