Brug den elektroniske Nuki-dørlås sammen med SuperSaaS

En af de mange måder, SuperSaaS kan bruges på, er til udlejning af huse, værelser eller lejligheder. Fordi det er besværligt at aflevere en fysisk nøgle til en kunde og få den tilbage igen, er mange af disse virksomheder begyndt at bruge elektroniske låse. At installere en elektronisk lås er ikke længere en stor investering, da de let kan monteres, og i Nuki’s tilfælde kræver det ikke engang, at den eksisterende lås udskiftes. Næste niveau af bekvemmelighed er nu automatisk at oprette og sende adgangsoplysningerne til dine kunder, så snart en reservation er gennemført.

At bruge en elektronisk lås sammen med SuperSaaS kan også bruges til andre formål end udlejning, såsom tidsbaseret adgang til et mødelokale, et computerrum eller en sportsfacilitet.

Denne vejledning er til kunder, der har en Nuki-dørlås, fordi Nuki er et af de mest populære mærker, og flere kunder har spurgt os, om det var muligt at bruge deres Nuki-lås sammen med SuperSaaS. Andre mærker tilbyder lignende funktionalitet, og denne vejledning kan måske også hjælpe med de låse.

Konceptet:

Hver gang der oprettes en ny aftale i en SuperSaaS-kalender, genereres en kode og gemmes i et bestemt Nuki-keypad med en tidsramme, som koden er gyldig for. Koden sendes automatisk til kunden i bekræftelsesmailen. Hvis du er bekymret for sikkerheden ved at sende dørlåskoden, kan du konfigurere et trin med aftalegodkendelse, før koden sendes.

Forudsætninger:

• Du har en Nuki-lås, et Nuki Keypad og en Nuki Bridge eller indbygget Wi-Fi (f.eks. Smart Lock 3.0 Pro eller nyere).
• Du har oprettet en ‘ressourcetidsplan’ i SuperSaaS til det hus, den lejlighed eller det rum, du vil udleje.
• Du har et betalt SuperSaaS-abonnement (krævet for de såkaldte ‘brugerdefinerede webhooks’, som bruges).
• Du har aktiveret gratis adgang til Nuki Web via Nuki-appen (under Features & Configuration).

Bemærk: andre kalender-typer end ‘resource’ vil også virke, men en ‘ressourcetidsplan’ er nok det, du får brug for i dette særlige tilfælde.

Aktuelle begrænsninger:

• Der er maksimalt 100 koder til Nuki Keypad og 200 koder til Nuki Keypad 2.0 (med fingeraftrykslæser).
• Udløbne koder skal slettes manuelt via appen eller webportalen. Hvis du sletter en kode via appen, forsvinder den først fra portalen en dag senere. Hvis du sletter den via portalen, fjernes den straks fra appen og keypad’et.

Oversigt over trin:

1. Aktivér API’et i Nuki Web Portal.
2. Identificér lock ID’et.
3. Konfigurér en webhook i SuperSaaS (for at gemme en tilfældig kode med en gyldighedsperiode i keypad’et via Nuki’s API).
4. Sæt tidspunktet for webhooeken, så keypad’et opdateres kort før lejeperioden.
5. Tilføj koden til den automatiske påmindelsesmail fra SuperSaaS.

Bemærk: disse trin kan lyde lidt tekniske, men det er faktisk ganske enkelt, og igen, ingen programmeringsviden er påkrævet!

Trin 1: aktivering af API’et i Nuki Web Portal

Gå til Nuki Web Portal

Under API vælger du Activate Nuki Web API, accepterer Terms and Conditions og klikker Activate Nuki Web API.

Klik ‘Generate API token’.

Indtast et tilfældigt navn som API token name og vælg alle checkboxes for adgangsrettighederne.

Når du har trykket ‘Save’, kopierer du koden, du ser der (ved at markere koden og derefter højreklikke for at kopiere). Gem koden et sted til senere. Hvis du glemmer den, kan du nemt oprette en ny.

Trin 2: identificering af lock ID

Du kan få lock ID’et fra Nuki på to måder, og det kan være lidt forvirrende. Mulighed 2 er lidt hurtigere, men også lidt mere teknisk.

Mulighed 1:

• I Nuki-appen går du til Features & Configuration og derefter General. Kopiér Device ID (f.eks. 34FDAF45)
• Konvertér dette ‘hexadecimal’-nummer til et decimaltal via denne hjemmeside, men tilføj først et ‘4’ foran nummeret (se eksempelbilledet). Decimaltallet er det smartlockId, du skal bruge i næste trin.

Mulighed 2:

• Kør følgende kommando i et Terminal-vindue (på en Mac) curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer API-TOKEN' 'https://api.nuki.io/smartlock' og erstat koden efter Bearer med den kode, du kopierede i Nuki Web Portal tidligere.
• I svaret, du får, er smartlockId nævnt som det første tal.

Trin 3: konfigurér webhooken i SuperSaaS

På dit SuperSaaS Dashboard klikker du ‘Integrations’ og vælger derefter ‘Webhooks’. Find mere information om brug af webhooks her, selvom det ikke er nødvendigt for denne vejledning.

Indtast følgende oplysninger:

• Trigger: vælg ‘Reminder’
• Tidsplan: vælg den kalender, som du vil konfigurere et keypad til
• Mål-URL: https://bearer:API-TOKEN@api.nuki.io/smartlock/SMARTLOCK-ID/auth?_method=put

Bemærk: Vælg ‘Reminder’ i stedet for ‘New appointment’, selv hvis du vælger at sende koden som en del af bekræftelsesmailen ved oprettelsen af den nye aftale. Fordelen er, at koden bliver gemt i keypad’et, når der er minimal risiko for, at reservationen bliver aflyst eller ændret.

Target URL vil så se sådan ud: https://bearer:72f6740dc965eea5caae3949bafb31@api.nuki.io/smartlock/18068913969/auth?_method=put

Tryk ‘Create Webhook’.

Bag ‘Nyttelast’ vælger du ‘Brugerdefineret’. Bemærk: Hvis denne mulighed ikke er tilgængelig, skal du først have et betalt abonnement.

Kopiér og indsæt følgende oplysninger i tekstfeltet:

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

Tryk ‘Update webhook’

Du kan nu trykke ‘Test webhook’ og trykke ‘Send nyttelast nu’.

Vigtigt: hver kode kan kun indtastes én gang, så hvis du bruger “Test webhook”-funktionen til at oprette en kode til en aftale, kan det mislykkes senere at køre webhooken til påmindelsesmailen, hvis den samme kode bruges. For at forhindre dette skal du ændre koden, hver gang du tester webhooken, til et andet tal med 6 cifre (og uden nuller i tallet eller 12 i begyndelsen).

Hvis det lykkes, bør en ny post med en kode blive oprettet for enheden efter et par sekunder. Find den under ‘Keypad’ i Nuki-portalen og i appen (du skal måske opdatere siden, hvis du har den åben).

Ved at bruge $start vil posterne i keypad’et blive vist med startdatoen som navn i appen (se billedet).

Det gør det let at finde koden, så du kan give den til kunden, hvis de har glemt den. Det gør det også lettere at fjerne udløbne koder. Alternativt kan du erstatte $start med $id. Så kan du aktivere visning af reservations-ID’et på reservationen og listevisningen, så ID’et er nemt at finde.

Bemærk: Det er ikke tilrådeligt at bruge kundens navn, da keypad’et har en begrænsning på 30 tegn for navnet. Hvis kundens navn er længere, vil lagring af koden mislykkes.

Trin 4: konfigurér tidspunktet for webhooken og mailen

På fanen ‘Process’ under indstillingen ‘Should we send a reminder or follow-up for the reservation?’ vælger du ‘Trigger a webhook an hour in advance’. Ved at gøre dette sendes koden bevidst til keypad’et så sent som muligt, hvilket forebygger problemer med aflyste reservationer eller ændrede reservationsdatoer.

For at udløse afsendelsen af påmindelsesmailen vælger du ‘Send a follow-up email’ og ændrer værdien til ‘−1 days’.

Trin 5: tilføj koden til den automatiske mail til kunden

Tilføj blot $doorcode til påmindelsesmailen, der sendes til kunden (på fanen ‘Layout’) kort før lejeperioden. Valgfrit kan du også inkludere koden i bekræftelsesmailen.

Det var det!

Afsluttende bemærkninger

For flere værelser og låse skal du gentage disse trin med en anden kalender og et andet lock ID (API token fra Web Portal er knyttet til din Nuki-konto og vil være det samme for hver lås).

Grunden til, at denne vejledning er til en lås i kombination med et keypad, er, at det gør det muligt for din kunde at bruge låsen via en kode, der deles via mail, uden at skulle installere Nuki-appen på deres telefon. Med nogle ændringer kan det samme princip bruges til automatisk at oprette adgang til Nuki-appen for en lås i stedet.

Som nævnt ovenfor kan du, hvis du er bekymret for sikkerheden, konfigurere et godkendelsestrin før koden sendes, eller blot kræve betaling på forhånd.

Denne vejledning opfylder det grundlæggende behov for at bruge Nuki-låsen sammen med SuperSaaS. Mere avancerede behov kan dækkes ved at bruge en tjeneste som Make, som har en integration med SuperSaaS. Tænk på scenarier som at lade låsen åbne en time før lejeperioden. Det er også muligt automatisk at fjerne udløbne koder, da Nuki API’et tillader det, men det kræver betydeligt mere arbejde.

Denne vejledning er baseret på følgende information fra Nuki: https://developer.nuki.io/t/web-api-example-manage-pin-codes-for-your-nuki-keypad/54