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.

EdellytyksetKopioi ankkurilinkki

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öönottoKopioi ankkurilinkki

1. Avaa Asetukset → Järjestelmä → Integraatiot → Kulku.io
2. Syötä API-osoite, Rakennuksen tunnus, Asiakastunniste ja Salausavain
3. Määritä pääsyajat ja varaohjeet (ks. alla)
4. Vaihda Tila Aktiiviseksi
5. Valitse Tallenna muutokset
6. Listaa kunkin resurssin ovet resurssin asetuksissa ja kunkin jäsenyyden ovet jäsenyyden integraatioasetuksissa
7. (Valinnainen) Varmista määritys kohdasta Toiminnot → Testaa avaamalla lukko

AsetuksetKopioi ankkurilinkki

• 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ääsy ennen varausta ja Pääsy varauksen jälkeen: kuinka monta minuuttia ennen varauksen alkua ja sen päättymisen jälkeen oven avauspainike toimii
• Enimmäisetäisyys toimipisteestä: asiakkaan on oltava tämän etäisyyden sisällä, jotta oven avauspainike toimii. Heikko puhelinsignaali voi estää asiakasta avaamasta ovea, jolloin hän ottaa yhteyttä teihin. Henkilökunta voi avata oven sijainnista riippumatta. Määritä ensin toimipisteen osoitteen koordinaatit.
• 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

OvetKopioi ankkurilinkki

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äsenyydetKopioi ankkurilinkki

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.

Olemassa olevien varausten päivittäminenKopioi ankkurilinkki

Kun olet ottanut integraation käyttöön, valitse Toiminnot → Päivitä tulevat varaukset lisätäksesi oven avauspainikkeen tuleviin varauksiin. Tämä on hyödyllistä, kun yhdistät integraation ensimmäistä kertaa tai lisäät resurssille ovia. Toiminto on käytettävissä, kun integraatio on aktiivinen.

Integraation poistaminenKopioi ankkurilinkki

Valitse Poista integraatio, niin Thril poistaa Kulku.io-asetukset liikuntapaikaltasi. Thril poistaa myös kunkin resurssin ja jäsenyyden Kulku.io-asetukset. Voit ottaa integraation uudelleen käyttöön myöhemmin.

Integraatiota ei voi poistaa, kun tulevilla varauksilla on oven avauspainike tai jäsenyydet antavat pääsyn Kulku.ion kautta. Irrota integraatio näistä jäsenyyksistä ja poista integraatio, kun varaukset ovat päättyneet. Vaihda sillä välin Tila tilaan Poissa käytöstä, jotta oven avauspainike poistuu käytöstä.

VianmääritysKopioi ankkurilinkki

• Toiminnot → 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.