> 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/etapes.md).

# Les étapes de la Smart Journey

Les étapes de la Smart Journey : déclencheur, conditions, activation par défaut, contenus à inclure et consignes de chaque message.

La Smart Journey d'un logement compte **29 étapes**, plus **2 étapes d'assurance annulation**, soit **31 étapes**. Elles s'affichent dans l'ordre du séjour, sous la ligne **Mode Live** de l'onglet **Smart Journey**.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-2c65ada936af0996cc72da3d5a5692d7627af7c7%2Flogement-smart-journey-etapes-repliees-1280.png?alt=media" alt="Liste complète des 31 étapes repliées de la Villa Les Pins, de Bienvenue à Différence d&#x27;assurance remboursée puis, en dernier, Relancer le voyageur sur une commande en attente (Quand une commande attend le paiement ou la carte du voyageur), chacune avec son icône, son déclencheur, ses badges de conditions et son interrupteur ; Empreinte programmée, Échec de l&#x27;enregistrement de la carte, Échec de la reconduction et Caution prélevée sont désactivées"><figcaption><p>Les 31 étapes, repliées</p></figcaption></figure>

### Lire une étape repliée

Chaque carte montre :

* le **nom** de l'étape ;
* son **déclencheur** : un moment du séjour (*« 1 jour avant le check-in à 10:00 »*, *« Au check-out à 08:00 »*) ou un événement (*« Caution autorisée »*, *« Commande payée »*) ;
* ses **badges de conditions**, quand l'étape n'est envoyée que dans certains cas ;
* son **interrupteur** : une étape désactivée ne part jamais. Message : *« Étape activée »* ou *« Étape désactivée »*.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-e495292741d886b8d188a916d9737558e3dd21ef%2Fzoom-logement-smart-journey-badges.png?alt=media" alt="Étapes Instructions d&#x27;accès (Au check-in, Heure non configurée, badge Accès débloqué), Première nuit (Séjour min. ≥ 2n, Satisfaction non négative), Départ multi-nuits (Séjour min. ≥ 2n), Départ 1 nuit (Séjour max.), Fin de séjour, Demande d&#x27;avis (Satisfaction positive uniquement, Aucun incident en cours)" width="530"><figcaption><p>Déclencheurs et badges de conditions</p></figcaption></figure>

| Badge                                  | L'étape n'est envoyée que si…                                                                                        |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Caution activée**                    | la caution est activée sur le logement.                                                                              |
| **Profil non classé**                  | le profil du voyageur n'a pas encore été identifié.                                                                  |
| **Recommandations disponibles**        | le logement a de quoi recommander : un service actif, une recommandation publiée dans la Guest App ou une publicité. |
| **Satisfaction non négative**          | le voyageur n'a pas exprimé de mécontentement.                                                                       |
| **Satisfaction positive uniquement**   | le voyageur s'est montré satisfait.                                                                                  |
| **Aucun incident en cours**            | aucun problème signalé n'est en cours.                                                                               |
| **Séjour min. ≥ 2n** / **Séjour max.** | le séjour compte au moins deux nuits / une seule nuit.                                                               |
| **Accès débloqué**                     | le voyageur peut recevoir ses accès (voir **Instructions d'accès**, plus bas).                                       |
| **Étape précédente envoyée**           | les instructions d'accès ont déjà été envoyées.                                                                      |

### Régler une étape

Cliquez sur une étape pour la déplier.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-bebb92a5d76f3b67168ec72eedba17647330587e%2Flogement-smart-journey-etape-pre-arrivee-1280.png?alt=media" alt="Étape Pré-arrivée dépliée : Heure d&#x27;exécution 10:00, Ignorer les heures silencieuses désactivé, Contenu à inclure avec Heure de check-in, Informations parking, Date/heure d&#x27;envoi des codes et Lien vers la Guest App cochés, Instructions personnalisées sur le portail et le transfert depuis la gare, bouton Variable, boutons Générer avec l&#x27;IA et Enregistrer"><figcaption><p>L'étape Pré-arrivée dépliée</p></figcaption></figure>

* **Heure d'exécution** : l'heure d'envoi, pour les étapes liées à un moment du séjour.
* **Jour d'envoi** : pour la seule étape **Recommandation de services**, de **J-1** à **J-7** avant l'arrivée.
* **Ignorer les heures silencieuses** : par défaut, aucun message ne part entre 22h et 7h. Activez cette option si le message doit partir à l'heure prévue, même la nuit.
* **Contenu à inclure** : les informations que Sherlock doit glisser dans le message. Les cases proposées dépendent de l'étape.
* **Instructions personnalisées** : vos consignes pour ce message (2 000 caractères au plus). Le bouton **Variable** insère une information du séjour ou du logement.
* **Générer avec l'IA** : décrivez ce que doit faire l'étape, Sherlock rédige les consignes. **Appliquer** les reprend, **Affiner** permet de les ajuster, **Réessayer** relance la rédaction.
* **Enregistrer** : message *« Étape mise à jour »*.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-3813235210b53b523b7cca263dcba05ec2de435a%2Fzoom-logement-smart-journey-recommandations.png?alt=media" alt="Étape Recommandation de services dépliée : déclencheur 3 jours avant le check-in à 14:00, badges Recommandations disponibles et Satisfaction non négative, Jour d&#x27;envoi de J-1 à J-7 avec J-3 sélectionné, Heure d&#x27;exécution 14:00, Ignorer les heures silencieuses, Contenu à inclure Lien vers la Guest App, Instructions personnalisées vides" width="530"><figcaption><p>Recommandation de services, envoyée à J-3</p></figcaption></figure>

{% hint style="info" %}
Changer le jour ou l'heure d'une étape recale les messages déjà programmés et pas encore partis. Vos consignes peuvent citer des heures : si elles reprennent l'heure habituelle d'arrivée ou de départ (« dès 16h »), Sherlock annonce à la place l'heure prévue pour le séjour, arrivée anticipée ou départ tardif compris.
{% endhint %}

### Contenus à inclure

| Case                             | Proposée pour                                                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Adresse du logement**          | Bienvenue, Pré-arrivée                                                                                                         |
| **Heure de check-in**            | Bienvenue, Pré-arrivée, Instructions d'accès                                                                                   |
| **Heure de check-out**           | Bienvenue, Départ (multi-nuits), Départ (1 nuit)                                                                               |
| **Informations parking**         | Bienvenue, Pré-arrivée, Instructions d'accès                                                                                   |
| **Identifiants WiFi**            | Bienvenue, Première nuit                                                                                                       |
| **Transports à proximité**       | Bienvenue, Pré-arrivée                                                                                                         |
| **Règlement intérieur**          | Bienvenue, Pré-arrivée, Première nuit, Départ (multi-nuits), Départ (1 nuit)                                                   |
| **Lien vers la Guest App**       | Bienvenue, Pré-arrivée, Recommandation de services, Instructions d'accès, Première nuit, Départ (multi-nuits), Départ (1 nuit) |
| **Assurance annulation**         | Bienvenue : l'offre n'est mentionnée que si elle est ouverte pour ce séjour.                                                   |
| **Date/heure d'envoi des codes** | Pré-arrivée                                                                                                                    |
| **Lien de paiement caution**     | Pré-arrivée                                                                                                                    |
| **Équipements du logement**      | Première nuit                                                                                                                  |
| **Proposition late checkout**    | Départ (multi-nuits), Départ (1 nuit)                                                                                          |

Les autres étapes n'ont pas de cases : Sherlock y met ce que l'événement demande (lien de caution, détail de la commande, nouveaux codes…), et vous pouvez toujours ajouter des consignes.

{% hint style="warning" %}
**Voyageurs Booking.com** : autorisez les domaines de Mr Sherlock dans l'Extranet Booking.com, sinon Booking.com supprime des messages de la Smart Journey les liens de la Guest App, de caution, de paiement et des vidéos. Voir [Autoriser les liens de Mr Sherlock sur Booking.com](https://docs.mrsherlock.ai/booking.com/autoriser-les-liens-de-mr-sherlock.md).
{% endhint %}

## Avant l'arrivée

| Étape                          | Déclencheur par défaut            | Rôle                                                                                                                                                                            |
| ------------------------------ | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bienvenue**                  | À la réservation                  | Remercie le voyageur, confirme l'essentiel et pose quelques questions pour connaître son séjour (motif, enfants, besoins particuliers). Part dès la confirmation, même la nuit. |
| **Classification du profil**   | Message du voyageur reçu          | Étape technique, sans message : identifie le profil du voyageur pour adapter la suite. Badge **Profil non classé**.                                                             |
| **Évaluation continue**        | Message du voyageur reçu          | Étape technique, sans message : suit la satisfaction du voyageur à chaque message.                                                                                              |
| **Pré-arrivée**                | 1 jour avant le check-in à 10:00  | Prépare l'arrivée : heure d'arrivée, parking, envoi des codes, lien de la Guest App.                                                                                            |
| **Recommandation de services** | 2 jours avant le check-in à 14:00 | Propose vos services (arrivée anticipée, ménage…), vos recommandations locales et vos partenaires, selon le profil du voyageur. Jour réglable de J-1 à J-7.                     |

### Instructions d'accès

**Instructions d'accès** part **au check-in** : codes, points d'accès dans l'ordre, consignes et lien de la Guest App. Badge **Accès débloqué**.

* Si le voyageur n'a pas encore fini son **check-in en ligne** ou déposé sa **caution**, l'étape **attend** au lieu d'être sautée. Elle part dès que le voyageur a fait sa part, pas avant l'heure prévue. Si rien n'est fait avant la fin du séjour, elle est abandonnée, sans autre message.
* L'étape suit l'heure d'arrivée du séjour, arrivée anticipée comprise. Par défaut, elle n'a pas d'heure fixe : la carte affiche alors *« Heure non configurée »*. Pour enregistrer un réglage de cette étape, l'application demande de choisir une heure : l'étape partira alors à cette heure, le jour de l'arrivée.
* Si une consigne demande les liens des vidéos d'accès, Sherlock insère les liens des vidéos de la Guest App.

**Mise à jour des codes d'accès** (déclencheur *« Codes d'accès mis à jour »*) prévient le voyageur d'un changement de code. Elle ne part qu'après l'envoi des instructions d'accès (badge **Étape précédente envoyée**).

## Pendant et après le séjour

| Étape                    | Déclencheur par défaut            | Rôle                                                                                                                 |
| ------------------------ | --------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Première nuit**        | 1 jour après le check-in à 09:00  | Prend des nouvelles après la première nuit. Séjours de 2 nuits ou plus, voyageur non mécontent.                      |
| **Départ (multi-nuits)** | 1 jour avant le check-out à 10:00 | Prépare le départ : heure, consignes, clés, proposition de départ tardif. Séjours de 2 nuits ou plus.                |
| **Départ (1 nuit)**      | Au check-out à 08:00              | La même chose, en plus court, pour un séjour d'une nuit.                                                             |
| **Fin de séjour**        | Au check-out à 08:00              | Remercie le voyageur et clôt le séjour, sur un ton adapté à sa satisfaction.                                         |
| **Demande d'avis**       | Au check-out à 12:00              | Demande un avis, adapté à la plateforme. Seulement si le voyageur est satisfait et qu'aucun incident n'est en cours. |

## Caution

Toutes les étapes de caution portent le badge **Caution activée**. Leur déclencheur est l'événement de caution du même nom. Voir [Caution](https://docs.mrsherlock.ai/logements/details-dun-logement/parametres/caution.md) pour les parcours de caution.

| Étape                                         | Envoyée quand…                                                     | Par défaut     |
| --------------------------------------------- | ------------------------------------------------------------------ | -------------- |
| **Lien de caution**                           | le lien de caution est généré                                      | activée        |
| **Caution confirmée**                         | l'empreinte est posée                                              | activée        |
| **Carte enregistrée**                         | la carte du voyageur est enregistrée, sans empreinte immédiate     | activée        |
| **Empreinte programmée**                      | l'empreinte différée est posée, sans action du voyageur ce jour-là | **désactivée** |
| **Échec de l'enregistrement de la carte**     | l'enregistrement de la carte échoue                                | **désactivée** |
| **Échec de la reconduction**                  | le renouvellement de l'empreinte échoue pendant le séjour          | **désactivée** |
| **Validation bancaire requise**               | la banque demande une authentification au voyageur                 | activée        |
| **Échec caution**                             | le voyageur n'a pas pu déposer sa caution                          | activée        |
| **Dispense de caution payée par le voyageur** | le voyageur a payé la dispense                                     | activée        |
| **Échec du paiement des frais**               | le paiement de la dispense échoue                                  | activée        |
| **Caution restituée**                         | la caution est libérée                                             | activée        |
| **Caution prélevée**                          | vous prélevez tout ou partie de la caution, avec un motif          | **désactivée** |

Les deux étapes de dispense ne partent que si la dispense de caution est proposée sur le logement.

## Commandes de services

| Étape                                                | Envoyée quand…                                                                                                                                                                       |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Commande en attente de validation**                | le paiement d'une commande est autorisé et la commande attend votre validation                                                                                                       |
| **Commande payée**                                   | une commande est payée et confirmée                                                                                                                                                  |
| **Échec commande**                                   | le paiement d'une commande échoue                                                                                                                                                    |
| **Commande refusée**                                 | vous refusez une commande                                                                                                                                                            |
| **Relancer le voyageur sur une commande en attente** | une commande attend le paiement ou la carte du voyageur : relances, puis « Expirée » (voir [Relances et expiration](https://docs.mrsherlock.ai/commandes/relances-et-expiration.md)) |

L'étape **Relancer le voyageur sur une commande en attente** est activée par défaut : 2 relances, à 24 h d'intervalle. Elle ne se règle pas comme un message : dépliée, elle propose **Nombre de relances** (de 1 à 5), **Intervalle entre deux relances** (6 h, 12 h, 24 h, 48 h ou 72 h) et **Consignes pour l'IA (facultatif)**. Elle vaut pour toutes les plateformes. Sans paiement après la dernière relance, la commande passe **Expirée** un intervalle plus tard. Si l'étape ou la Smart Journey est désactivée, **ou si la Smart Journey n'est pas en mode Live**, personne ne relance le voyageur et ses commandes restent payables, sans expiration.

<figure><img src="https://2797821012-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEMOCc9qpZQSNmTaZnIY9%2Fuploads%2Fgit-blob-e5388343f7be8d610b0f80f058a2357941e5034f%2Fzoom-logement-smart-journey-etape-relance.png?alt=media" alt="Étape Relancer le voyageur sur une commande en attente dépliée : Nombre de relances avec 2 sélectionné, Intervalle entre deux relances avec 24 h sélectionné, Consignes pour l&#x27;IA (facultatif), la note sur l&#x27;expiration et les heures calmes, bouton Enregistrer" width="530"><figcaption><p>L'étape de relance dépliée</p></figcaption></figure>

## Assurance annulation

Ces deux étapes n'apparaissent que sur les espaces où l'[assurance annulation](https://docs.mrsherlock.ai/logements/details-dun-logement/guest-app/assurance-annulation.md) est proposée. Elles sont activées par défaut.

| Étape                                 | Envoyée quand…                                                      |
| ------------------------------------- | ------------------------------------------------------------------- |
| **Supplément d'assurance à payer**    | le prix du séjour a augmenté et le voyageur doit compléter sa prime |
| **Différence d'assurance remboursée** | le prix du séjour a baissé et la différence de prime est remboursée |

{% hint style="warning" %}
*« Seule annonce au voyageur : si cette étape est désactivée, il n'en sera informé que sur sa page assurance. »*
{% endhint %}

### Et après ?

{% content-ref url="/pages/Qz8OmRVNFI5WY1vVZXnl" %}
[Tester avec la Sandbox](https://docs.mrsherlock.ai/logements/details-dun-logement/smart-journey/tester-avec-la-sandbox.md)
{% endcontent-ref %}

{% content-ref url="/pages/gE2Z0OlIjk2RmN2HBJ0S" %}
[Timeline Smart Journey](https://docs.mrsherlock.ai/reservations/details-dune-reservation/smart-journey-timeline.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mrsherlock.ai/logements/details-dun-logement/smart-journey/etapes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
