Použití elektronického dveřního zámku Nuki se SuperSaaS

Jedním z mnoha způsobů, jak lze SuperSaaS používat, je pronajímání domů, pokojů nebo bytů. Protože předávání fyzického klíče zákazníkovi a jeho následné převzetí zpět je nepohodlné, začalo mnoho těchto podniků používat elektronické zámky. Instalace elektronického zámku už není velkou investicí, protože je lze snadno nainstalovat, a v případě Nuki ani není nutné měnit stávající zámek. Další úroveň pohodlí pak spočívá v tom, že se přístupové informace automaticky vytvoří a odešlou zákazníkům hned po dokončení rezervace.

Použití elektronického zámku v kombinaci se SuperSaaS lze využít i k jiným účelům než k pronájmu, například pro časově omezený přístup do zasedací místnosti, počítačové učebny nebo sportoviště.

Tento návod je určen zákazníkům, kteří mají zámek Nuki, protože Nuki je jednou z nejpopulárnějších značek a několik zákazníků se nás ptalo, zda je možné jejich zámek Nuki používat se SuperSaaS. Podobnou funkcionalitu nabízejí i jiné značky a tento návod může pomoci i s jejich zámky.

Princip:

Pokaždé, když se v rozvrhu SuperSaaS vytvoří nová schůzka, vygeneruje se kód a uloží se do konkrétního klávesnice Nuki, se stanoveným časovým rozmezím, po které je platný. Kód se zákazníkovi automaticky odešle v potvrzovacím emailu. Pokud vám z bezpečnostního hlediska nevyhovuje posílání přístupového kódu ke dveřím, můžete před jeho odesláním nastavit krok schválení schůzky.

Předpoklady:

• Máte zámek Nuki, klávesnici Nuki Keypad a Nuki Bridge nebo vestavěné Wi-Fi (např. Smart Lock 3.0 Pro nebo vyšší).
• Máte v SuperSaaS vytvořený „rozvrh zdrojů“ pro dům, byt nebo pokoj, který chcete pronajímat.
• Máte placené předplatné SuperSaaS (vyžadováno pro tzv. „custom webhooks“, které se používají).
• Máte v aplikaci Nuki aktivovaný bezplatný přístup k Nuki Web (v části Features & Configuration).

Poznámka: i jiné typy rozvrhů než „resource“ budou fungovat, ale pro tento konkrétní případ použití budete pravděpodobně potřebovat právě „resource schedule“.

Současná omezení:

• Pro Nuki Keypad je maximum 100 kódů a pro Nuki Keypad 2.0 (s čtečkou otisků prstů) 200 kódů.
• Propadlé kódy je nutné ručně smazat přes aplikaci nebo webový portál. Pokud kód smažete přes aplikaci, zmizí z portálu až o den později. Pokud ho smažete přes portál, bude okamžitě odstraněn z aplikace i z klávesnice.

Přehled kroků:

1. Aktivujte API v portálu Nuki Web.
2. Zjistěte ID zámku.
3. Nakonfigurujte webhook v SuperSaaS (aby se v klávesnici přes API od Nuki uložil náhodný kód s dobou platnosti).
4. Nastavte načasování webhooku tak, aby klávesnici aktualizoval krátce před dobou pronájmu.
5. Přidejte kód do automatického připomínkového emailu ze SuperSaaS.

Poznámka: tyto kroky mohou znít trochu technicky, ale ve skutečnosti je to docela jednoduché a znovu platí, že nejsou potřeba žádné programátorské znalosti!

Krok 1: aktivace API v portálu Nuki Web

Přejděte na Nuki Web Portal

V části API vyberte Activate Nuki Web API, přijměte Terms and Conditions a klikněte na Activate Nuki Web API.

Klikněte na „Generate API token“.

Zadejte libovolný název pro API token a zaškrtněte všechna políčka s přístupovými právy.

Po stisknutí „Save“ zkopírujte kód, který se tam zobrazí (označte kód a poté klikněte pravým tlačítkem na kopírování). Uložte si tento kód někam pro pozdější použití. Pokud byste ho ztratili, můžete si snadno vytvořit nový.

Krok 2: identifikace ID zámku

Získat ID zámku z Nuki lze dvěma způsoby a může to být trochu matoucí. Možnost 2 je o něco rychlejší, ale také o něco techničtější.

Možnost 1:

• V aplikaci Nuki přejděte do Features & Configuration a poté do General. Zkopírujte Device ID (např. 34FDAF45)
• Převeďte toto „hexadecimální“ číslo na desítkové pomocí této webové stránky, ale nejprve před číslo přidejte „4“ (viz ukázkový obrázek). Desetinné číslo je smartlockId, které budete potřebovat v dalším kroku.

Možnost 2:

• Proveďte následující příkaz v okně Terminálu (na Macu) curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 72f6740dc9653f287e9368eee30afa142cea5caae3949bafb32' 'https://api.nuki.io/smartlock', přičemž kód za Bearer nahraďte kódem, který jste si dříve zkopírovali z portálu Nuki Web.
• V odpovědi, kterou dostanete, je smartlockId uvedeno jako první číslo.

Krok 3: konfigurace webhooku v SuperSaaS

Na svém panelu SuperSaaS klikněte na „Integrations“ a poté zvolte „Webhooks“. Více informací o použití webhooků zde najdete, i když pro tento návod nejsou potřeba.

Zadejte následující informace:

• Trigger: zvolte „Reminder“
• Schedule: vyberte rozvrh, pro který chcete nakonfigurovat klávesnici
• Target URL: https://bearer:API-TOKEN@api.nuki.io/smartlock/SMARTLOCK-ID/auth?_method=put

Poznámka: Zvolte ‚Reminder‘ místo ‚New appointment‘, i když se rozhodnete poslat kód jako součást potvrzovacího emailu při vytvoření nové schůzky. Výhodou je, že kód bude uložen do klávesnice až v okamžiku, kdy je minimální šance, že rezervace bude zrušena nebo změněna.

Cílová URL pak bude vypadat takto: https://bearer:72f6740dc965eea5caae3949bafb31@api.nuki.io/smartlock/18068913969/auth?_method=put

Klikněte na ‚Create Webhook‘.

V části ‚Payload‘ vyberte ‚Custom‘. Poznámka: Pokud tato možnost není k dispozici, musíte nejprve získat placené předplatné.

Zkopírujte a vložte následující informace do textového pole:

{
"name": "$start",
"allowedFromDate": "$start_utc",
"allowedUntilDate": "$finish_utc",
"allowedWeekDays": 0,
"type": 13,
"code": "$doorcode"
}

Klikněte na ‚Update webhook‘

Nyní můžete kliknout na ‚Test webhook‘ a poté na ‚Post payload now‘.

Důležité: každý kód lze zadat pouze jednou, takže pokud použijete funkci „Test webhook“ k vytvoření kódu pro schůzku, může pozdější spuštění webhooku pro připomínkový email selhat, pokud se použije stejný kód. Abyste tomu zabránili, pokaždé při testování webhooku změňte kód na jiné šestimístné číslo (a bez nul v čísle nebo s 12 na začátku).

Pokud vše proběhlo úspěšně, měla by se po několika sekundách pro zařízení vytvořit nová položka s kódem. Najdete ji v části „Keypad“ na portálu Nuki i v aplikaci (možná budete muset stránku obnovit, pokud jste ji právě měli otevřenou).

Použitím $start se položky v klávesnici zobrazí s datem začátku jako názvem v aplikaci (viz obrázek).

Tím se kód snadno najde, pokud byste ho zákazníkovi museli poskytnout znovu. Také se tím snáz odstraňují propadlé kódy. Alternativně můžete $start nahradit $id. Pak můžete na rezervaci i v seznamovém zobrazení povolit zobrazení ID rezervace, abyste ID snadno našli.

Poznámka: Nedoporučuje se používat jméno zákazníka, protože klávesnice má omezení 30 znaků pro název. Pokud je jméno zákazníka delší, uložení kódu selže.

Krok 4: nastavení načasování webhooku a emailu

Na kartě „Process“ pod volbou „Should we send a reminder or follow-up for the reservation?“ vyberte „Trigger a webhook an hour in advance“. Tím se kód zámku odešle do klávesnice záměrně co nejpozději, což pomáhá předejít problémům se zrušenými rezervacemi nebo změněnými daty.

Chcete-li spustit odeslání připomínkového emailu, vyberte „Send a follow-up email“ a změňte hodnotu na „-1 days“.

Krok 5: přidání kódu do automatického emailu zákazníkovi

Jednoduše přidejte $doorcode do připomínkového emailu, který je zákazníkovi odeslán (na kartě „Layout“) krátce před dobou pronájmu. Volitelně můžete kód přidat i do potvrzovacího emailu.

To je vše!

Závěrečné poznámky

U více místností a zámků tento postup opakujte s jiným rozvrhem a jiným ID zámku (API token z webového portálu je propojen s vaším účtem Nuki a bude stejný pro každý zámek).

Důvod, proč je tento návod určen pro zámek v kombinaci s klávesnicí, je ten, že zákazníkovi umožní používat zámek pomocí kódu sdíleného emailem, aniž by si musel do telefonu instalovat aplikaci Nuki. S několika úpravami lze stejný princip použít i k automatickému vytvoření přístupu do aplikace Nuki pro zámek.

Jak už bylo zmíněno výše, pokud máte obavy o bezpečnostní stránku, můžete před odesláním tohoto kódu nastavit krok schválení nebo jednoduše vyžadovat platbu předem.

Tento návod pokrývá základní potřebu použití zámku Nuki v kombinaci se SuperSaaS. Pokročilejší potřeby lze řešit pomocí služby jako je Make, která má se SuperSaaS integraci. Představte si scénáře, kdy je třeba umožnit otevření zámku hodinu před začátkem pronájmu. Je také možné automaticky odstraňovat propadlé kódy, protože to API Nuki umožňuje, ale vyžaduje to výrazně více práce.

Tento návod vychází z následujících informací od Nuki: https://developer.nuki.io/t/web-api-example-manage-pin-codes-for-your-nuki-keypad/54