Connecter une serrure et donner l'accès aux voyageurs

Une serrure connectée change l'arrivée : plus de clé à remettre en main propre, plus de code unique partagé par tous les séjours. YStay génère un code par réservation, valable seulement autour du séjour, et l'envoie au voyageur. Une fois la serrure rattachée, vous n'avez plus rien à faire.

Deux réglages, à deux endroits différents. Le prestataire se connecte une seule fois pour tout le compte, depuis API & intégrations. La serrure, elle, se rattache à un logement — une serrure, une porte : toutes les annonces posées sur ce logement partagent la même. C'est ce second réglage qui commande l'émission des codes.

Le parcours, écran par écran

1. Voir les prestataires disponibles

   Dans le groupe Compte du menu, ouvrez API & intégrations. La carte Serrures connectées y annonce son rôle : « Connectez votre prestataire de serrures pour générer automatiquement les codes d'accès voyageur à la confirmation. »

   Quatre lignes, toujours les mêmes. Serrure virtuelle porte le badge Active par défaut et un bouton Tester la connexion. Nuki propose Connecter, qui ouvre un champ Jeton d'API Nuki — le jeton est vérifié auprès de Nuki avant d'être enregistré, et « Le jeton est chiffré et ne sera jamais réaffiché. » Yale Home et SwitchBot portent le badge Bientôt disponible : leur bouton est inactif, ces prestataires ne sont pas connectables aujourd'hui.

   

2. Ouvrir la carte Serrure connectée de l'annonce

   Ouvrez la fiche de l'annonce et descendez jusqu'à la carte Serrure connectée. Elle résume l'engagement : « Rattachez la serrure de ce logement : les codes d'accès voyageur seront émis automatiquement à la confirmation de chaque réservation. »

   Tant qu'aucune serrure n'est rattachée, la carte affiche Aucune serrure rattachée. et sa conséquence : « Sans serrure, aucun code d'accès automatique n'est émis pour ce logement. » Le lien Gérer les prestataires renvoie à l'écran précédent.

   

3. Remplir le formulaire d'ajout

   Ajouter une serrure déploie deux champs. Nom de la serrure est libre — la suggestion Ex. Porte d'entrée dit bien ce qu'on attend : le nom de la porte, pas celui du logement. Prestataire ne liste que les prestataires connectés et non gatés ; sur un compte neuf, la seule option est donc Serrure virtuelle.

   Pour un prestataire réel, YStay interroge votre compte et affiche Serrures de votre compte Nuki : chaque serrure y porte Libre, ou Attribuée à suivi du logement qui l'occupe déjà — auquel cas elle n'est pas sélectionnable. Si le prestataire ne répond pas ou n'a rien à lister, un champ de saisie manuelle de l'identifiant prend le relais. Rattacher valide.

   

4. Vérifier la serrure rattachée

   La serrure apparaît en liste avec son nom, son prestataire et un badge d'état : Active, Inactive ou Injoignable. Trois boutons l'accompagnent : Tester — qui appelle réellement le prestataire et répond Connexion OK ou Serrure injoignable —, Modifier et Détacher.

   

5. Laisser la confirmation faire le travail

   Rien à déclencher : à la confirmation d'une réservation, YStay émet le code en tâche de fond et le grave sur la serrure. La carte Accès logement de la fiche du séjour — ou de la réservation — montre le résultat. Avant toute émission, elle affiche Aucun code d'accès actif.

   Une réservation encore non confirmée n'a pas de séjour : l'écran le dit, « Confirmez la réservation pour matérialiser le séjour et accéder aux opérations (accès, check-in/out, preuve). »

   

6. Lire, régénérer ou révoquer le code

   Une fois le code émis, la carte affiche le bandeau Code généré : suivi du code et de la mention (affiché une seule fois). La ligne du code, elle, reste : un badge d'état — Actif, Émis · envoi à J-2, Émis · voyageur notifié, Révoqué, Expiré, Échec de révocation — et sa fenêtre, Valable du … au ….

   Sur un code actif, Voir le code le réaffiche en clair, avec l'avertissement (consultation tracée) : chaque consultation est journalisée. Révoquer demande un motif, puis fait retirer le code par le prestataire — c'est lui qui le supprime de la serrure, pas YStay. Quand il répond, la ligne passe Révoqué et le voyageur ne peut plus ouvrir avec ce code. Générer un code d'accès en émet un à la demande, par exemple après une révocation.

   Sous la liste des codes, juste avant les boutons de la carte, la section Journal d'accès liste les 20 derniers événements du séjour, du plus récent au plus ancien — le même journal que « (consultation tracée) » désigne plus haut. Chaque ligne cite sa source, Système, Espace hôte ou Application voyageur, et une ligne Code consulté venue de l'Application voyageur porte en plus Code consulté par le voyageur. — c'est là, et nulle part ailleurs, que vous le voyez. Les erreurs du prestataire y remontent aussi. Sans historique, la section affiche « Aucun événement d'accès enregistré pour le moment. »

   Si le prestataire refuse ou ne répond pas, la révocation n'est pas acquise : la ligne passe Échec de révocation et affiche « La révocation chez le prestataire a échoué : nouvel essai automatique en cours, le code peut rester fonctionnel sur la porte. » Un nouvel essai part tout seul et vous êtes prévenu par notification, mais tant que la ligne n'affiche pas Révoqué, considérez que le code ouvre encore.

   Un dernier badge, en haut de la carte, résume l'état de la session d'accès. Il n'est pas traduit : il s'affiche en anglais brut, « active ». C'est un défaut d'interface connu, sans conséquence sur les codes.

   

La fenêtre de validité

Un code n'est jamais valable en permanence. Sa fenêtre commence 3 heures avant l'heure d'arrivée et se termine au départ, à l'heure de fin de check-out. À défaut de règles de la maison sur l'annonce, YStay retient 16 h 00 pour l'arrivée et 11 h 00 pour le départ, dans le fuseau horaire du bien. C'est cette fenêtre que la ligne du code résume avec Valable du … au ….

Ce que reçoit le voyageur

L'e-mail est le canal de référence : il part automatiquement, sans le moindre geste du voyageur. Le message a pour objet « Votre code d'accès au logement » ; le code y est mis en avant dans un encadré « Code d'accès », suivi de sa date limite, « Valable jusqu'au …. » Il part dans la langue du voyageur.

En parallèle, si le voyageur utilise l'application, une notification Votre accès est prêt l'avertit — mais elle ne contient pas le code : elle indique seulement où le retrouver, sans se limiter à renvoyer vers l'e-mail. Elle ouvre la fiche de cette réservation, où le code se consulte. YStay n'envoie aucun SMS.

Le code est aussi consultable dans l'application, à deux endroits — l'onglet Mon séjour, et la fiche de cette réservation elle-même — un second canal, pas un remplacement de l'e-mail. Il y apparaît à partir de 48 heures avant l'arrivée et reste visible jusqu'à la fin de sa fenêtre de validité, ou jusqu'à sa révocation. Masqué par défaut, il ne se révèle qu'après un geste explicite sur le bouton Afficher le code — un second bouton, Masquer le code, le recache ensuite ; la consultation est alors journalisée, une fois par jour et par code au plus — visible de vous dans le Journal d'accès du séjour, la ligne prouve qu'il a consulté son code ce jour-là, pas combien de fois.

Tant qu'il n'y a rien à montrer, l'écran le dit sans détour :

• Pas encore disponible. La fenêtre des 48 heures avant l'arrivée n'est pas encore ouverte — l'écran indique la date à partir de laquelle revenir.
• Pas encore émis. Aucun code n'a encore été généré pour ce séjour.
• Logement sans serrure connectée. Aucune émission automatique n'est possible pour ce séjour.
• Ce code n'est plus disponible ici. Trois causes produisent ce même message : la fenêtre de validité est passée, le code a été révoqué, ou sa révocation — demandée par vous — n'a pas encore abouti chez le prestataire (badge de la ligne, plus haut) : tant qu'il n'affiche pas Révoqué, le code peut encore fonctionner sur la porte.
• Attestation d'assurance requise. L'annonce l'exige et aucune n'a encore été acceptée pour ce séjour : l'écran le dit au voyageur, qui attend vos instructions — voir Attestations d'assurance.

Quand l'arrivée est encore lointaine, le code est émis mais l'envoi attend : la ligne annonce « Envoi automatique au voyageur 48 h avant l'arrivée. » et le badge passe à Émis · envoi à J-2. Le jour venu, l'e-mail part et une notification Votre arrivée approche rappelle où le trouver.

Si aucun code n'apparaît

• Aucune serrure active sur le logement. L'écran répond « Aucune serrure active : rattachez une serrure d'abord. » — c'est le message affiché quelle que soit la cause de l'échec, commencez donc toujours par vérifier ce point.
• La réservation n'est pas confirmée. Sans séjour, pas d'accès : confirmez d'abord.
• Le séjour est annulé. Aucun code ne peut plus être émis sur un séjour annulé. La révocation des codes existants, elle, est demandée à l'annulation — elle peut encore être en cours chez le prestataire (badge de la ligne, plus haut) : Révoqué ou Échec de révocation.
• Un code actif existe déjà. L'émission automatique ne double jamais un code en cours.
• L'annonce exige une attestation d'assurance et aucune n'a été acceptée pour la période d'arrivée : l'émission reste suspendue jusqu'à l'acceptation.
• Le prestataire n'a pas répondu. YStay vous prévient par notification et l'émission manuelle reste disponible depuis la fiche du séjour.

Et ensuite

• Recevoir sa première réservation et gérer son calendrier — le parcours qui amène une réservation jusqu'à la confirmation.
• Créer et publier son premier livret — les informations pratiques que le voyageur lira en arrivant.
• Annonces — les autres cartes de la fiche annonce.
• Attestations d'assurance : accepter, refuser, débloquer l'accès — la décision qui suspend, ou libère, l'émission du code de porte.
• L'état des lieux : politique, lien voyageur, gabarits — constater l'état du logement de part et d'autre de cet accès.