L’une des nombreuses façons d’utiliser SuperSaaS est la location de maisons, de chambres ou d’appartements. Parce qu’il est difficile de remettre une clé physique à un client et de la récupérer, beaucoup de ces entreprises ont commencé à utiliser des serrures électroniques. L’installation d’une serrure électronique n’est plus un investissement majeur, car elle peut être facilement installée et, dans le cas de Nuki, il n’est même pas nécessaire de remplacer la serrure existante. Désormais, le prochain niveau de commodité peut consister à créer et envoyer automatiquement les informations d’accès à vos clients dès qu’une réservation est terminée.
L’utilisation d’une serrure électronique en combinaison avec SuperSaaS peut également être utilisée à des fins autres que la location, comme l’accès temporaire à une salle de réunion, à un laboratoire informatique ou à une installation sportive.
Ce tutoriel s’adresse aux clients qui possèdent une serrure de porte Nuki, car Nuki est l’une des marques les plus populaires et plusieurs clients nous ont demandé s’il était possible d’utiliser leur serrure Nuki avec SuperSaaS. D’autres marques offrent des fonctionnalités similaires et ce didacticiel peut également vous aider avec ces verrous.
Le principe :
Chaque fois qu’un nouveau rendez-vous est créé sur un planning SuperSaaS, un code est généré et stocké dans un clavier Nuki spécifique, avec une période de validité pour laquelle il est valable. Le code est envoyé automatiquement au client dans l’email de confirmation. Si vous êtes préoccupé par l’aspect sécurité de l’envoi du code d’accès à la porte, vous pouvez configurer une étape d’approbation de rendez-vous avant l’envoi de ce code.
Prérequis :
- Vous disposez d’une serrure Nuki, d’un Nuki Keypad et d’un Nuki Bridge ou d’une connexion Wi-Fi intégrée (par exemple Smart Lock 3.0 Pro ou supérieur).
- Vous disposez de créé un « planning de ressources » dans SuperSaaS pour la maison, l’appartement ou la chambre que vous souhaitez louer.
- Vous disposez d’un abonnement SuperSaaS payant (obligatoire pour les « webhooks personnalisés » utilisés).
- Vous disposez de activé l’accès gratuit à Nuki Web via l’application Nuki (sous Fonctionnalités et configuration).
Note : d’autres types de planification que « ressource » fonctionneront également, mais une « planification de ressources » est probablement ce dont vous aurez besoin pour ce cas d’utilisation particulier.
Limitations actuelles :
- Il existe un maximum de 100 codes pour le Nuki Keypad et de 200 codes pour le Nuki Keypad 2.0 (avec lecteur d’empreintes digitales).
- Les codes expirés doivent être supprimés manuellement via l’application ou le portail Web. Si vous supprimez un code via l’application, il ne disparaîtra du portail qu’un jour plus tard. Si vous le supprimez via le portail, il sera immédiatement supprimé de l’application et du clavier.
Aperçu des étapes :
- Activez l’API sur le portail Web de Nuki.
- Identifiez l’ID du verrou.
- Configurez un webhook dans SuperSaaS (pour stocker un code aléatoire avec une période de validité dans le clavier via l’API de Nuki).
- Définissez le timing du webhook pour mettre à jour le clavier peu avant la période de location.
- Ajoutez le code à l’e-mail de rappel automatique de SuperSaaS.
Note : ces étapes peuvent sembler un peu techniques, mais elles sont en fait assez simples et encore une fois, aucune connaissance en programmation n’est requise !
Étape 1 : activer l’API sur le portail Web de Nuki
Accédez au Portail Web Nuki
Sous API, choisissez Activer Nuki Web API, acceptez les conditions générales et cliquez sur Activer Nuki Web API.
Cliquez sur « Générer un jeton API ».
Entrez un nom aléatoire pour le nom du jeton API et cochez toutes les cases pour les droits d’accès.
Après avoir appuyé sur « Enregistrer », copiez le code que vous voyez ici (en sélectionnant le code puis en faisant un clic droit pour copier). Enregistrez ce code quelque part pour plus tard. Si vous avez oublié, vous pouvez facilement en créer un nouveau.
Étape 2 : identification de l’ID du verrou
Obtenir l’identifiant de verrouillage de Nuki peut se faire de deux manières, et cela peut être un peu déroutant. L’option 2 est un peu plus rapide mais un peu plus technique.
Option 1 :
- Dans l’application Nuki, allez dans Fonctionnalités et configuration, puis Général. Copiez l’ID de l’appareil (par exemple 34FDAF45)
- Convertissez ce nombre « hexadécimal » en nombre décimal via ce site Web mais ajoutez d’abord un « 4 » devant le nombre (voir exemple d’image). Le nombre décimal est le smartlockId dont vous avez besoin à l’étape suivante.
Option 2 :
- Exécutez la commande suivante dans une fenêtre de terminal (sur un Mac)
curl -X GET --header "Accept: application/json' --header 'Autorisation : Bearer 72f6740dc9653f287e9368eee30afa142cea5caae3949bafb32' 'https://api.nuki.io/smartlock'où vous remplacez le code après Bearer par le code que vous avez copié précédemment sur le portail Web de Nuki. - Dans la réponse que vous recevez, smartlockId est mentionné comme premier numéro.
Étape 3 : configurer le webhook chez SuperSaaS
Sur votre tableau de bord SuperSaaS, cliquez sur « Intégrations », puis choisissez « Webhooks ». Trouvez plus d’informations sur utilisation des webhooks ici, bien que cela ne soit pas nécessaire pour ce didacticiel.
Saisissez les informations suivantes :
- Déclencheur : choisissez « Rappel »
- Planning : choisissez le planning pour lequel vous souhaitez configurer un clavier
- URL cible :
https://bearer:API-TOKEN@api.nuki.io/smartlock/SMARTLOCK-ID/auth?_method=put
Note : Choisissez « Rappel » au lieu de « Nouveau rendez-vous » même si vous choisissez d’envoyer le code dans le cadre de l’e-mail de confirmation lors de la création du nouveau rendez-vous. Cela présente l’avantage que le code sera stocké dans le clavier lorsqu’il y a peu de chances que la réservation soit annulée ou modifiée.
L’URL cible ressemblera alors à ceci : https://bearer:72f6740dc965eea5caae3949bafb31@api.nuki.io/smartlock/18068913969/auth?_method=put
Appuyez sur « Créer un Webhook ».
Derrière « Charge utile », sélectionnez « Personnalisé ». Note : Si cette option n’est pas disponible, vous devez d’abord souscrire un abonnement payant.
Copiez et collez les informations suivantes dans le champ de texte :
{
"nom": "$start",
"allowedFromDate": "$start_utc",
"allowedUntilDate": "$finish_utc",
"allowedWeekDays": 0,
"type": 13,
"code": "$codeporte"
}
Appuyez sur « Mettre à jour le webhook »
Vous pouvez maintenant appuyer sur « Tester le webhook » et appuyer sur « Publier la charge utile maintenant ».
Important : chaque code ne peut être saisi qu’une seule fois, donc si vous utilisez la fonction “Test webhook” pour créer un code pour un rendez-vous, l’exécution ultérieure du webhook pour l’e-mail de rappel peut échouer si le même code est utilisé. Pour éviter que cela ne se produise, mettez à jour le code chaque fois que vous testez le webhook avec un numéro différent à 6 chiffres (et sans zéros dans le numéro ni 12 au début).
En cas de succès, une nouvelle entrée avec un code doit être créée pour l’appareil après quelques secondes. Trouvez-le sous « Clavier » sur le portail Nuki et dans l’application (vous devrez peut-être actualiser la page si vous y êtes).
En utilisant $start, les entrées du clavier seront affichées avec la date de début comme nom dans l’application (voir image).
Cela permet de retrouver facilement le code afin de le fournir au client en cas d’oubli. Cela facilite également la suppression des codes expirés. Vous pouvez également remplacer $start par $id. Vous pouvez ensuite activer l’affichage de l’identifiant de réservation sur la réservation et la vue liste pour retrouver facilement l’identifiant.
Note : Il n’est pas conseillé d’utiliser le nom du client, car le clavier a une limitation de 30 caractères pour le nom. Si le nom du client est plus long, le stockage du code échouera.
Étape 4 : configurer le timing du webhook et de l’email
Dans l’onglet « Processus », sous l’option « Devrions-nous envoyer un rappel ou un suivi pour la réservation ? », sélectionnez « Déclencher un webhook une heure à l’avance ». Ce faisant, le code est délibérément envoyé au clavier le plus tard possible, ce qui évite les problèmes de réservation annulée ou de modification des dates de réservation.
Afin de déclencher l’envoi de l’e-mail de rappel, sélectionnez « Envoyer un e-mail de suivi » et modifiez la valeur à « -1 jours ».
Étape 5 : ajouter le code à l’email automatique au client
Ajoutez simplement $doorcode à l’email de rappel envoyé au client (sur l’onglet « Mise en page ») peu avant la période de location. En option, vous pouvez également inclure le code dans l’e-mail de confirmation.
C’est ça!
Remarques finales
Pour plusieurs pièces et serrures, répétez ces étapes avec un calendrier différent et un ID de serrure différent (le jeton API du portail Web est connecté à votre compte Nuki et sera le même pour chaque serrure).
La raison pour laquelle ce tutoriel concerne une serrure combinée à un clavier est que cela permet à votre client d’utiliser la serrure via un code partagé par e-mail, sans avoir besoin d’installer l’application Nuki sur son téléphone. Avec quelques modifications, le même principe peut être utilisé pour créer automatiquement un accès à l’application Nuki pour une serrure.
Comme mentionné ci-dessus, si vous êtes préoccupé par l’aspect sécurité, vous pouvez configurer une étape d’approbation avant l’envoi de ce code ou simplement exiger un paiement dès le départ.
Ce tutoriel répond au besoin de base lié à l’utilisation de la serrure Nuki en combinaison avec SuperSaaS. Des besoins plus avancés peuvent être satisfaits en utilisant un service tel que Faire, qui a une intégration avec SuperSaaS. Pensez à des scénarios tels que permettre l’ouverture de la serrure une heure avant la période de location. Il est également possible de supprimer automatiquement les codes expirés si l’API Nuki le permet, mais cela nécessite beaucoup plus d’efforts.
Ce tutoriel est basé sur les informations suivantes de Nuki : https://developer.nuki.io/t/web-api-example-manage-pin-codes-for-your-nuki-keypad/54