Jedným z mnohých spôsobov, ako možno SuperSaaS využiť, je prenajímanie domov, izieb alebo apartmánov. Keďže odovzdať zákazníkovi fyzický kľúč a potom ho získať späť je nepraktické, mnohé z týchto podnikov začali používať elektronické zámky. Inštalácia elektronického zámku už nie je veľká investícia, pretože sa dajú jednoducho namontovať a v prípade Nuki si dokonca nevyžaduje výmenu existujúceho zámku. Ďalšou úrovňou pohodlia môže byť automatické vytvorenie a odoslanie prístupových údajov zákazníkom hneď po dokončení rezervácie.
Elektronický zámok v kombinácii so SuperSaaS sa dá použiť aj na iné účely než prenájom, napríklad na časovo obmedzený prístup do zasadacej miestnosti, počítačovej učebne alebo športového zariadenia.
Tento návod je určený pre zákazníkov, ktorí majú dverový zámok Nuki, pretože Nuki je jedna z najpopulárnejších značiek a viacerí zákazníci sa nás pýtali, či je možné používať ich zámok Nuki so SuperSaaS. Iné značky ponúkajú podobnú funkcionalitu a tento návod môže pomôcť aj s nimi.
Koncept:
Pri každom vytvorení novej schôdzky v rozvrhu SuperSaaS sa vygeneruje kód a uloží sa do konkrétneho Nuki keypad-u, s časovým obdobím, počas ktorého je platný. Kód sa zákazníkovi odošle automaticky v potvrdzovacom e-maile. Ak máte obavy z bezpečnostnej stránky odosielania prístupového kódu k dverám, môžete pred odoslaním kódu nastaviť krok schválenia rezervácie.
Predpoklady:
- Máte zámok Nuki, Nuki Keypad a Nuki Bridge alebo zabudované Wi-Fi (napr. Smart Lock 3.0 Pro alebo novší).
- Máte vytvorený „rozvrh zdrojov“ v SuperSaaS pre dom, apartmán alebo miestnosť, ktorú chcete prenajímať.
- Máte platené predplatné SuperSaaS (vyžaduje sa pre takzvané „custom webhooks“, ktoré sa používajú).
- Máte cez aplikáciu Nuki aktivovaný bezplatný prístup k Nuki Web (v časti Features & Configuration).
Poznámka: fungovať budú aj iné typy rozvrhov než ‚resource‘, ale ‚rozvrh zdrojov‘ je pravdepodobne to, čo budete pre tento konkrétny prípad potrebovať.
Aktuálne obmedzenia:
- Pre Nuki Keypad je maximálne 100 kódov a pre Nuki Keypad 2.0 (s čítačkou odtlačkov prstov) 200 kódov.
- Expirované kódy sa musia mazať manuálne cez aplikáciu alebo webový portál. Ak kód vymažete cez aplikáciu, z portálu zmizne až o deň neskôr. Ak ho vymažete cez portál, okamžite sa odstráni z aplikácie aj z keypad-u.
Prehľad krokov:
- Aktivujte API v Nuki Web Portáli.
- Identifikujte ID zámku.
- Nakonfigurujte webhook v SuperSaaS (aby sa cez API od Nuki uložil do keypad-u náhodný kód s obdobím platnosti).
- Nastavte načasovanie webhooku tak, aby sa keypad aktualizoval krátko pred obdobím prenájmu.
- Pridajte kód do automatického pripomienkového e-mailu zo SuperSaaS.
Poznámka: tieto kroky môžu znieť trochu technicky, ale v skutočnosti je to celkom jednoduché a navyše, nie sú potrebné žiadne programátorské znalosti!
Krok 1: aktivácia API v Nuki Web Portáli
Choďte do Nuki Web Portálu
V časti API zvoľte Activate Nuki Web API, prijmite Terms and Conditions a kliknite na Activate Nuki Web API.
Kliknite na „Generate API token“.
Zadajte ľubovoľný názov pre API token a vyberte všetky zaškrtávacie políčka pre prístupové práva.
Po stlačení „Save“ skopírujte kód, ktorý tam uvidíte (vyberte kód a potom kliknite pravým tlačidlom myši na kopírovanie). Uložte si tento kód niekam na neskôr. Ak by ste ho stratili, môžete si jednoducho vytvoriť nový.
Krok 2: identifikácia ID zámku
Získať ID zámku z Nuki môžete dvoma spôsobmi, a môže to byť trochu mätúce. Možnosť 2 je o niečo rýchlejšia, ale aj trochu technickejšia.
Možnosť 1:
- V aplikácii Nuki prejdite na Features & Configuration a potom na General. Skopírujte Device ID (napr. 34FDAF45)
- Preveďte toto „hexadecimálne“ číslo na desiatkové cez túto stránku, ale najprv pridajte pred číslo „4“ (pozrite si ilustračný obrázok). Desiatkové číslo je smartlockId, ktoré budete potrebovať v ďalšom kroku.
Možnosť 2:
- Spustite nasledujúci príkaz v okne Terminalu (na Macu)
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 72f6740dc9653f287e9368eee30afa142cea5caae3949bafb32' 'https://api.nuki.io/smartlock', pričom kód za Bearer nahradíte kódom, ktorý ste si predtým skopírovali v Nuki Web Portáli. - V odpovedi, ktorú dostanete, je smartlockId uvedené ako prvé číslo.
Krok 3: konfigurácia webhooku v SuperSaaS
Na paneli SuperSaaS kliknite na „Integrations“ a potom zvoľte „Webhooks“. Viac informácií o použití webhookov nájdete tu, hoci to pre tento návod nie je potrebné.
Zadajte nasledujúce informácie:
- Trigger: zvoľte „Reminder“
- Schedule: zvoľte rozvrh, pre ktorý chcete nakonfigurovať keypad
- Target URL:
https://bearer:API-TOKEN@api.nuki.io/smartlock/SMARTLOCK-ID/auth?_method=put
Poznámka: zvoľte ‚Reminder‘ namiesto ‚New appointment‘, aj keď sa rozhodnete odoslať kód ako súčasť potvrdzovacieho e-mailu pri vytvorení novej rezervácie. Výhodou je, že kód sa uloží do keypad-u v čase, keď je minimálna šanca, že sa rezervácia zruší alebo zmení.
Cieľová URL bude potom vyzerať takto: https://bearer:72f6740dc965eea5caae3949bafb31@api.nuki.io/smartlock/18068913969/auth?_method=put
Kliknite na ‚Create Webhook‘.
V časti ‚Payload‘ zvoľte ‚Custom‘. Poznámka: Ak táto možnosť nie je dostupná, najprv si musíte zaobstarať platené predplatné.
Skopírujte a vložte nasledujúce informácie do textového poľa:
{
"name": "$start",
"allowedFromDate": "$start_utc",
"allowedUntilDate": "$finish_utc",
"allowedWeekDays": 0,
"type": 13,
"code": "$doorcode"
}
Kliknite na ‚Update webhook‘
Teraz môžete kliknúť na ‚Test webhook‘ a potom na „Post payload now“.
Dôležité: každý kód sa dá zadať iba raz, takže ak použijete funkciu „Test webhook“ na vytvorenie kódu pre schôdzku, neskoršie spustenie webhooku pre pripomienkový e-mail môže zlyhať, ak sa použije ten istý kód. Aby ste tomu zabránili, pri každom teste webhooku zmeňte kód na iné 6-miestne číslo (bez núl v čísle a bez 12 na začiatku).
Ak je všetko úspešné, po niekoľkých sekundách by sa pre dané zariadenie mal vytvoriť nový záznam s kódom. Nájdete ho v časti „Keypad“ na Nuki portáli aj v aplikácii (možno budete musieť stránku obnoviť, ak ju máte otvorenú).
Použitím $start sa záznamy v keypad-e zobrazia v aplikácii ako názov so začiatočným dátumom (pozrite obrázok).
Vďaka tomu je jednoduché nájsť kód a poskytnúť ho zákazníkovi, ak by si ho zabudol. Zároveň sa ľahšie odstraňujú expirované kódy. Alternatívne môžete $start nahradiť $id. Potom môžete zapnúť zobrazovanie ID rezervácie v rezervácii aj v zozname, aby sa ID dalo ľahko nájsť.
Poznámka: neodporúča sa používať meno zákazníka, pretože keypad má limit 30 znakov pre názov. Ak je meno zákazníka dlhšie, uloženie kódu zlyhá.
Krok 4: konfigurácia načasovania webhooku a e-mailu
Na karte ‘Process’ v možnosti ‘Should we send a reminder or follow-up for the reservation?’ zvoľte ‘Trigger a webhook an hour in advance’. Tým sa kód zámerne odošle do keypad-u čo najneskôr, čím sa predchádza problémom so zrušenými rezerváciami alebo zmenenými dátumami rezervácie.
Ak chcete spustiť odoslanie pripomienkového e-mailu, zvoľte ‘Send a follow-up email’ a zmeňte hodnotu na ‘-1 days’.
Krok 5: pridajte kód do automatického e-mailu zákazníkovi
Jednoducho pridajte $doorcode do pripomienkového e-mailu, ktorý sa zákazníkovi odošle (na karte ‘Layout’) krátko pred obdobím prenájmu. Voliteľne môžete kód zahrnúť aj do potvrdzovacieho e-mailu.
A je to!
Záverečné poznámky
Pri viacerých miestnostiach a zámkoch zopakujte tieto kroky s iným rozvrhom a iným ID zámku (API token z Web Portálu je prepojený s vaším účtom Nuki a bude rovnaký pre každý zámok).
Dôvod, prečo je tento návod určený pre zámok v kombinácii s keypad-om, je ten, že zákazník môže zámok používať cez kód zaslaný e-mailom bez potreby inštalovať aplikáciu Nuki do telefónu. S niekoľkými úpravami možno rovnaký princíp použiť aj na automatické vytváranie prístupu do aplikácie Nuki pre zámok namiesto toho.
Ako bolo uvedené vyššie, ak máte obavy zo stránky bezpečnosti, môžete pred odoslaním kódu nastaviť krok schválenia alebo jednoducho vopred požadovať platbu.
Tento návod pokrýva základnú potrebu používania zámku Nuki v kombinácii so SuperSaaS. Pokročilejšie potreby možno riešiť pomocou služby ako Make, ktorá má integráciu so SuperSaaS. Predstavte si scenáre ako umožniť otvorenie zámku hodinu pred obdobím prenájmu. Je tiež možné automaticky odstraňovať expirované kódy, pretože to Nuki API umožňuje, ale vyžaduje si to výrazne viac úsilia.
Tento návod vychádza z nasledujúcich informácií od Nuki: https://developer.nuki.io/t/web-api-example-manage-pin-codes-for-your-nuki-keypad/54