Een van de vele manieren waarop SuperSaaS kan worden gebruikt, is voor het verhuren van huizen, kamers of appartementen. Omdat het lastig is om een fysieke sleutel aan een klant te geven en weer terug te krijgen, zijn veel van deze bedrijven elektronische sloten gaan gebruiken. Het installeren van een elektronisch slot is geen grote investering meer omdat ze eenvoudig te installeren zijn en, in het geval van Nuki, hoeft het bestaande slot zelfs niet te worden vervangen. Het volgende niveau van gemak is om de toegangsinformatie automatisch aan te maken en naar uw klanten te sturen zodra een reservering is voltooid.
Het gebruik van een elektronisch slot in combinatie met SuperSaaS kan ook voor andere doeleinden dan verhuur worden ingezet, zoals tijdgebonden toegang tot een vergaderruimte, computerlokaal of sportfaciliteit.
Deze tutorial is voor klanten die een Nuki-deurslot hebben, omdat Nuki een van de populairste merken is en meerdere klanten ons hebben gevraagd of het mogelijk is hun Nuki-slot met SuperSaaS te gebruiken. Andere merken bieden vergelijkbare functionaliteit en deze tutorial kan ook voor die sloten van pas komen.
Het concept
Telkens wanneer er een nieuwe afspraak op een SuperSaaS-planning wordt aangemaakt, wordt er een code gegenereerd en opgeslagen in een specifiek Nuki-keypad, met een tijdsbestek waarvoor deze geldig is. De code wordt automatisch in de bevestigingsmail naar de klant gestuurd. Als u zich zorgen maakt over de beveiliging van het versturen van de toegangscode, kunt u een goedkeuringsstap voor afspraken instellen voordat deze code wordt verstuurd.
Vereisten
- U heeft een Nuki-slot, een Nuki Keypad en een Nuki Bridge of ingebouwde Wi-Fi (bijv. Smart Lock 3.0 Pro of hoger).
- U heeft een resourceplanning in SuperSaaS aangemaakt voor het huis, appartement of de kamer die u wilt verhuren.
- U heeft een betaald SuperSaaS-abonnement (vereist voor de zogenoemde custom webhooks die worden gebruikt).
- U heeft gratis toegang tot Nuki Web geactiveerd via de Nuki-app (onder Features & Configuration).
Let op: andere planningstypes dan resource werken ook, maar een resourceplanning is waarschijnlijk wat u voor deze specifieke toepassing nodig heeft.
Huidige beperkingen
- Er geldt een maximum van 100 codes voor het Nuki Keypad en 200 codes voor het Nuki Keypad 2.0 (met vingerafdruklezer).
- Verlopen codes moeten handmatig worden verwijderd via de app of het webportaal. Als u een code via de app verwijdert, verdwijnt deze pas een dag later uit het portaal. Als u deze via het portaal verwijdert, wordt deze direct uit de app en het keypad verwijderd.
Overzicht van de stappen
- De API activeren in het Nuki Web Portal.
- De lock-ID identificeren.
- Een webhook in SuperSaaS configureren (om via de Nuki API een willekeurige code met een geldigheidsperiode in het keypad op te slaan).
- De timing van de webhook instellen zodat het keypad kort vóór de huurperiode wordt bijgewerkt.
- De code toevoegen aan de automatische herinneringsmail vanuit SuperSaaS.
Let op: deze stappen klinken misschien wat technisch, maar het is eigenlijk vrij eenvoudig en nogmaals, er is geen programmeerkennis vereist!
Stap 1: de API activeren in het Nuki Web Portal
Ga naar het Nuki Web Portal
Kies onder API voor Activate Nuki Web API, accepteer de algemene voorwaarden en klik op Activate Nuki Web API.
Klik op Generate API token.
Voer een willekeurige naam in voor de API-tokennaam en selecteer alle vinkjes voor de toegangsrechten.
Druk op Save en kopieer de code die u daar ziet (door de code te selecteren en vervolgens met de rechtermuisknop op kopiëren te klikken). Bewaar deze code ergens voor later. Als u het vergeten bent, kunt u eenvoudig een nieuwe aanmaken.
Stap 2: de lock-ID achterhalen
Het verkrijgen van de lock-ID van Nuki kan op twee manieren, en dat kan wat verwarrend zijn. Optie 2 is iets sneller, maar wat technischer.
Optie 1:
- Ga in de Nuki-app naar Features & Configuration, vervolgens General. Kopieer de Device ID (bijv. 34FDAF45)
- Reken dit hexadecimale getal om naar een decimaal getal via deze website, maar voeg eerst een 4 vóór het getal toe (zie voorbeeldafbeelding). Het decimale getal is de smartlockId die u in de volgende stap nodig heeft.
Optie 2:
- Voer het volgende commando uit in een terminalvenster (op een Mac)
curl -X GET --header 'Accept: application/json' --header 'Authorization: Bearer 72f6740dc9653f287e9368eee30afa142cea5caae3949bafb32' 'https://api.nuki.io/smartlock'waarbij u de code na Bearer vervangt door de code die u eerder in het Nuki Web Portal heeft gekopieerd. - In het antwoord dat u krijgt, wordt het smartlockId als eerste getal genoemd.
Stap 3: de webhook in SuperSaaS configureren
Klik op uw SuperSaaS-dashboard op Integraties en kies vervolgens Webhooks. Meer informatie over het gebruik van webhooks vindt u hier, al is dit voor deze tutorial niet nodig.
Voer de volgende informatie in:
- Trigger: kies Herinnering
- Planning: kies de planning waarvoor u een keypad wilt configureren
- Doel-URL:
https://bearer:API-TOKEN@api.nuki.io/smartlock/SMARTLOCK-ID/auth?_method=put
Let op: kies Herinnering in plaats van Nieuwe afspraak, zelfs als u ervoor kiest de code mee te sturen in de bevestigingsmail bij het aanmaken van de nieuwe afspraak. Dit heeft als voordeel dat de code in het keypad wordt opgeslagen op een moment dat er minimale kans is dat de reservering wordt geannuleerd of gewijzigd.
De doel-URL zal er dan zo uitzien: https://bearer:72f6740dc965eea5caae3949bafb31@api.nuki.io/smartlock/18068913969/auth?_method=put
Druk op Webhook aanmaken.
Selecteer achter Payload de optie Custom. Let op: als deze optie niet beschikbaar is, moet u eerst een betaald abonnement nemen.
Kopieer en plak de volgende informatie in het tekstveld:
{
"name": "$start",
"allowedFromDate": "$start_utc",
"allowedUntilDate": "$finish_utc",
"allowedWeekDays": 0,
"type": 13,
"code": "$doorcode"
}
Druk op Webhook bijwerken.
U kunt nu op Webhook testen en op Post payload now drukken.
Belangrijk: elke code kan slechts één keer worden ingevoerd. Dus als u de functie Webhook testen gebruikt om een code voor een afspraak aan te maken, kan het uitvoeren van de webhook voor de herinneringsmail later mislukken als dezelfde code wordt gebruikt. Om dit te voorkomen, werkt u de code elke keer dat u de webhook test bij naar een ander getal van 6 cijfers (zonder nullen in het getal of een 12 aan het begin).
Als het lukt, wordt er na enkele seconden een nieuw item met een code voor het apparaat aangemaakt. U vindt het onder Keypad op het Nuki-portaal en in de app (mogelijk moet u de pagina vernieuwen als u erop staat).
Door $start te gebruiken, worden de items in het keypad in de app weergegeven met de startdatum als naam (zie afbeelding).
Dit maakt het eenvoudig om de code terug te vinden om deze aan de klant te geven mocht die hem vergeten zijn. Het maakt het ook eenvoudiger om verlopen codes te verwijderen. U kunt ook $start vervangen door $id. U kunt dan instellen dat het reservering-ID op de reservering en in de lijstweergave wordt getoond, zodat u het ID eenvoudig kunt terugvinden.
Let op: het is niet aan te raden de naam van de klant te gebruiken, omdat het keypad een limiet van 30 tekens voor de naam heeft. Als de naam van de klant langer is, mislukt het opslaan van de code.
Stap 4: de timing van de webhook en de e-mail configureren
Selecteer op het tabblad Proces onder de optie Moeten we een herinnering of opvolging voor de reservering versturen? de optie Trigger een webhook één uur van tevoren. Hierdoor wordt de code bewust zo laat mogelijk naar het keypad gestuurd, wat problemen met geannuleerde reserveringen of gewijzigde reserveringsdata voorkomt.
Om het versturen van de herinneringsmail te activeren, selecteert u Stuur een opvolg-e-mail en wijzigt u de waarde in -1 dagen.
Stap 5: voeg de code toe aan de automatische e-mail naar de klant
Voeg eenvoudig $doorcode toe aan de herinneringsmail die kort voor de huurperiode naar de klant wordt gestuurd (op het tabblad Layout). Optioneel kunt u de code ook in de bevestigingsmail opnemen.
Dat is alles!
Tot slot
Voor meerdere kamers en sloten herhaalt u deze stappen met een andere planning en een andere lock-ID (het API-token uit het Web Portal is gekoppeld aan uw Nuki-account en is voor elk slot hetzelfde).
De reden dat deze tutorial uitgaat van een slot in combinatie met een keypad is omdat uw klant zo het slot kan gebruiken met een per e-mail gedeelde code, zonder de Nuki-app op de telefoon te hoeven installeren. Met enkele aanpassingen kan hetzelfde principe worden gebruikt om in plaats daarvan automatisch toegang voor een slot via de Nuki-app aan te maken.
Zoals hierboven vermeld, kunt u als u zich zorgen maakt over de beveiliging een goedkeuringsstap configureren voordat deze code wordt verstuurd of simpelweg vooraf betaling vereisen.
Deze tutorial voorziet in de basisbehoefte om het Nuki-slot in combinatie met SuperSaaS te gebruiken. Voor meer geavanceerde behoeften kunt u een dienst als Make gebruiken, die een integratie met SuperSaaS heeft. Denk aan scenario’s zoals het slot een uur voor de huurperiode al kunnen openen. Het is ook mogelijk om verlopen codes automatisch te verwijderen, aangezien de Nuki API dit toelaat, maar dit vraagt aanzienlijk meer werk.
Deze tutorial is gebaseerd op de volgende informatie van Nuki.