> For the complete documentation index, see [llms.txt](https://docs.mrsherlock.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mrsherlock.ai/logements/details-dun-logement/smart-journey.md). # Smart Journey La **Smart Journey** est le **parcours de communication intelligent** de Mr Sherlock. Elle accompagne automatiquement le voyageur à chaque étape de sa réservation et de son séjour - de la confirmation au post-séjour - en remplaçant les messages automatiques rigides des channel managers par des messages générés par IA, naturels, contextualisés et adaptés à la situation réelle du voyageur. ### Pourquoi la Smart Journey ? Les messages automatiques traditionnels sont statiques, identiques pour tous les voyageurs, et incapables de tenir compte d'événements de réservation ni du contexte. La Smart Journey, elle, prend en compte avant chaque envoi : * la **temporalité du séjour** (réservation, pré-arrivée, arrivée, première nuit, départ, post-séjour) ; * les **événements** liés à la réservation (caution, paiement de service, mise à jour des accès, commande validée ou refusée) ; * le **profil du voyageur** (composition du groupe, présence d'enfants, motif du séjour, besoins particuliers) ; * le **niveau de satisfaction** détecté dans les échanges ; * les **informations** disponibles sur le logement, la Guest App, les services additionnels et les instructions du gestionnaire ; * l'**historique de conversation**, pour éviter les répétitions et les messages inutiles. L'objectif : **envoyer le bon message, au bon moment, avec le bon niveau d'information**, sans donner l'impression d'un message automatique. ### Activer la Smart Journey sur un logement L'onglet **Smart Journey** affiche un bandeau en haut de page : * **Si la Smart Journey est inactive** - une carte avec une icône fusée et le bouton **« Activer la Smart Journey »**. * **Si elle est active** - un indicateur *Actif / Inactif* et un interrupteur ON/OFF. {% hint style="warning" %} **L'IA messagerie doit être activée au préalable.** Si ce n'est pas le cas, un message bloque l'activation :\ \&#xNAN;*« Veuillez d'abord activer l'IA messagerie sur ce logement avant d'activer la Smart Journey. »* {% endhint %} À l'activation, un toast confirme : *« Smart Journey activé »*. ### Modes d'exécution La Smart Journey fonctionne dans **deux modes** : #### Mode Sandbox *(par défaut à l'activation)* Le **mode Sandbox** permet de **tester** la Smart Journey sur des **réservations de test** uniquement, accessibles depuis le bouton **Sandbox** du panneau d'actions rapides. Le gestionnaire peut y vérifier : * les messages générés, * le ton utilisé, * les informations incluses, * le comportement des actions, * l'application des instructions personnalisées. C'est l'étape recommandée avant de passer en production. #### Mode Live Le **mode Live** active la Smart Journey sur les **réservations réelles**. Un interrupteur dédié **« Mode Live »** est affiché en dessous de l'activation principale. * Bandeau d'aide affiché à proximité :\ \&#xNAN;*« Activez le mode Live lorsque vous êtes prêt à envoyer des messages aux vraies réservations via la Smart Journey. Tant que le mode Live est désactivé, seules les réservations de la sandbox déclenchent la Smart Journey. »* * À l'activation : confirmation **« Activer le mode Live ? »** → **Annuler / Activer**. * À la désactivation : confirmation **« Désactiver le mode Live ? »** + avertissement *« Les messages programmés pour les réservations réelles en cours seront annulés. Ils reprendront si vous réactivez le mode Live. »* → **Annuler / Désactiver**. {% hint style="info" %} **Articulation avec l'Autopilote/Copilote** - Le bandeau d'information rappelle :\ \&#xNAN;*« L'envoi des messages de la Smart Journey suit le mode Autopilote/Copilote de la messagerie. Le passage en mode Live est recommandé lorsque votre messagerie est réglée en Autopilote. »* {% endhint %} ### Types d'actions Les actions de la Smart Journey se répartissent en deux familles : * **Actions temporelles** - déclenchées à un **moment précis** du parcours (confirmation de réservation, X jours/heures avant le check-in, au check-in, après la première nuit, avant le check-out, après le séjour). * **Actions événementielles** - déclenchées par un **événement** (caution générée/confirmée/échouée/libérée, commande payée/refusée, codes d'accès mis à jour, message du voyageur reçu, etc.). ### Configurer une étape La liste des **18 étapes** s'affiche sous forme de cartes pliables. Chaque carte présente : * une **icône** correspondant au type d'action ; * le **nom de l'étape** ; * la **description du déclencheur** (ex. *« 2 jours avant le check-in »*, *« Réservation confirmée »*, *« Au check-in à 08:00 »*) ; * des **badges de conditions** *(si conditions existantes)* - ex. *« Caution activée »*, *« Guest App activée »*, *« Séjour min. ≥ 3n »*, *« Services actifs »*, *« Profil non classé »*, *« Canal spécifique »* ; * un **interrupteur** d'activation ; * une **flèche de dépliage**. Le détail complet de chaque étape (déclencheur, contenus inclus, instructions, conditions) est documenté dans la page dédiée : {% content-ref url="/pages/2mKR8uvzlQhVe8fpMJAT" %} [Les étapes de la Smart Journey](/logements/details-dun-logement/smart-journey/etapes.md) {% endcontent-ref %} ### Heures calmes Par défaut, **aucun message planifié n'est envoyé entre 22 h et 7 h** (heure locale du logement). Sur chaque étape, vous pouvez activer l'option **« Ignorer les heures silencieuses »** si un message doit absolument partir immédiatement, quelle que soit l'heure. ### Déduplication et résilience Avant chaque envoi, l'IA **analyse l'historique de la conversation** et peut **renoncer à envoyer** un message si : * l'information a déjà été transmise, * le voyageur a déjà répondu au sujet, * l'action n'apporte aucune valeur supplémentaire, * le contenu a déjà été couvert par l'hôte, l'IA ou un message précédent. La Smart Journey est par ailleurs **résiliente** : elle gère les erreurs temporaires, les relances, les réservations créées avant son activation, les étapes déjà passées et les événements arrivant dans un ordre non standard selon les outils connectés. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mrsherlock.ai/logements/details-dun-logement/smart-journey.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.