La correspondance des données par guide vous permet de synchroniser automatiquement les données des annonces et des réservations Homhero avec vos guides Touch Stay. Cet article couvre tout ce qu'il faut savoir pour la configurer : des deux types de correspondance à l'ajout de champs, jusqu'à l'utilisation de vos données dans le contenu du guide.
Table des matières :
Comprendre les sources de données dans Homhero
Chaque champ Homhero se situe soit au niveau de la réservation, soit au niveau du guide, et c'est ce qui détermine la façon dont vous pouvez le faire correspondre :
Les champs au niveau de la réservation correspondent directement à un Champ personnalisé utilisateur/voyageur (User/Guest custom field). Pour ces champs, vous ne verrez pas d'étape de choix du type de correspondance.
Les champs au niveau du guide affichent une étape Choisissez le type de correspondance (Choose mapping type), où vous choisissez Champ personnalisé du guide (Guide custom field) ou Personnalisation du sujet (Topic customisation).
Champ personnalisé utilisateur/voyageur
Utilisé pour les informations qui changent à chaque réservation, par exemple :
Code d'accès (s'il est différent pour chaque réservation)
Nombre d'adultes
Notes d'arrivée
Ces données sont liées à la réservation et n'apparaissent que lorsqu'un voyageur ouvre son lien d'invitation personnalisé.
Champ personnalisé du guide
Utilisé pour les informations propres au logement, qui restent les mêmes d'une réservation à l'autre, par exemple :
Numéro de clé
Notes de check-in
Champs personnalisés de vos locations Homhero (par exemple, les informations Wi-Fi)
Ces données sont liées à l'annonce du logement et s'affichent dans le guide lui-même.
Champs que vous pouvez faire correspondre
Le nom du voyageur, les dates d'arrivée et de départ et les coordonnées sont importés automatiquement avec chaque réservation. En plus de ces informations, le sélecteur Champ de données Homhero (Homhero data field) propose les champs suivants :
Champ | Niveau | Type de données |
Adults, Children, Infants, Pets | Réservation | Nombre |
Nights | Réservation | Nombre |
Reservation Note, Arrival Notes, Departure Notes | Réservation | Texte |
Lockbox Code, Access Code | Réservation | Texte |
Bedding Config, Portacot, Agent, Review | Réservation | Texte |
Description, Check-In Notes, Key Number | Guide | Texte |
Listing Notes, Cleaner Notes, Checklist, Lease Agreement | Guide | Texte |
💡 Vos propres champs Homhero figurent aussi dans la liste :
Les champs personnalisés de vos locations et zones Homhero apparaissent comme des champs au niveau du guide.
Les champs de réservation supplémentaires présents sur vos prochaines réservations (Touch Stay en vérifie jusqu'à 50) apparaissent comme des champs texte au niveau de la réservation.
Choisissez comment afficher vos données
Il existe deux façons d'intégrer à vos guides les données Homhero au niveau du guide, selon la quantité de contenu que vous synchronisez et l'endroit où vous souhaitez qu'il apparaisse.
Option 1. Champs personnalisés du guide
Idéal pour de courtes informations à insérer dans un sujet existant, par exemple :
Numéro de clé
Un nom de réseau ou un mot de passe Wi-Fi enregistré dans un champ personnalisé Homhero
Une fois la correspondance établie, vous insérez le champ dans le contenu de votre sujet à l'aide d'un code de champ. Chaque guide affichera automatiquement les bonnes informations issues de son annonce Homhero. Les champs au niveau de la réservation, comme Access Code ou Adults, fonctionnent de la même façon, mais via un champ personnalisé utilisateur/voyageur.
Comment créer une correspondance avec un champ personnalisé
Accédez à Intégrations (Integrations).
Ouvrez l'onglet Mapper les données (Map data).
Cliquez sur Ajouter une correspondance (Add new mapping).
Sélectionnez le champ de données Homhero que vous souhaitez synchroniser.
Pour un champ au niveau du guide, sélectionnez Champ personnalisé du guide sous Choisissez le type de correspondance. (Les champs au niveau de la réservation passent directement cette étape.)
Choisissez un champ personnalisé existant ou cliquez sur + Nouveau champ personnalisé (+ New Custom Field) pour en créer un. Si vous créez un nouveau champ personnalisé :
Saisissez un Code de champ (Field code). Nous vous recommandons d'ajouter
_homheroà la fin (par exemplekey_number_homhero) pour identifier facilement la provenance des données.Facultatif : ajoutez une Valeur de remplacement (Substitute value), affichée lorsque des données manquent (voir ci-dessous).
Cliquez sur Enregistrer (Save).
Pour les champs au niveau du guide, cliquez sur Resynchroniser les données du guide (Resync guide data) pour récupérer les dernières informations de Homhero et remplir le champ associé dans vos guides. Les champs au niveau de la réservation se remplissent au fil de la synchronisation des réservations.
Remarque : vous n'avez besoin de cliquer sur Resynchroniser les données du guide que lorsque vous créez une nouvelle correspondance au niveau du guide, ou lorsque vous avez modifié dans Homhero la valeur d'un champ associé et souhaitez que ces modifications apparaissent immédiatement dans Touch Stay.
Valeur de remplacement
Une valeur de remplacement sert de solution de repli lorsque Homhero ne fournit pas de données pour une réservation ou un logement donné. Au lieu d'afficher un champ vide, Touch Stay affichera votre valeur de remplacement. Par exemple :
Contactez-nous si cette information est manquante
Non renseigné
Veuillez vous adresser à votre hôte
👉 En savoir plus : Les codes de champ expliqués.
Utiliser les données associées à vos champs personnalisés
Une fois la correspondance d'un champ établie, vous pouvez l'utiliser partout dans Touch Stay, notamment :
Contenu des sujets
Dans votre Centre de contenus (Content Hub), ouvrez n'importe quel sujet et cliquez sur le bouton Codes de champ (Field Codes). Vous verrez tous les champs disponibles : ceux de l'intégration Homhero, les informations du voyageur, les dates d'arrivée et de départ, les heures d'arrivée et de départ, ainsi que tous les champs supplémentaires que vous avez associés.
Insérez-les directement dans votre contenu pour personnaliser automatiquement l'expérience de chaque voyageur.
Dans les modèles du Centre de messages (Message Hub)
Les mêmes codes de champ fonctionnent dans vos modèles de messages du Centre de messages : vous pouvez ainsi envoyer des communications personnalisées à vos voyageurs sans aucune mise à jour manuelle pour chaque réservation.
Option 2. Personnalisations du sujet
Idéal pour un contenu plus long qui mérite son propre sujet dans le guide, par exemple :
Notes de check-in
Description du logement
Notes de l'annonce
Champs personnalisés plus longs de vos locations Homhero, comme les instructions des appareils électroménagers
Touch Stay crée une version personnalisée du sujet sélectionné pour chaque guide, à partir du contenu enregistré dans l'annonce Homhero correspondante. Seuls les champs au niveau du guide peuvent être associés à une personnalisation du sujet.
⚠️ Attention : vous devez créer le sujet dans votre Centre de contenus avant de pouvoir le sélectionner ici. Nous vous recommandons de créer d'abord votre sujet principal, puis de revenir pour y associer les données Homhero.
Comment créer une correspondance avec les personnalisations du sujet
Accédez à Intégrations.
Ouvrez l'onglet Mapper les données.
Cliquez sur Ajouter une correspondance.
Sélectionnez le champ de données Homhero au niveau du guide que vous souhaitez synchroniser.
Sous Choisissez le type de correspondance, sélectionnez Personnalisation du sujet.
Choisissez le sujet Touch Stay que vous souhaitez remplir ; vous pouvez le rechercher par son nom.
Choisissez une règle sous Définir une règle de visibilité prioritaire (Set visibility override rule) ; voir ci-dessous.
Cliquez sur Enregistrer.
Cliquez sur Resynchroniser les données du guide pour récupérer les dernières informations de Homhero.
Règles de visibilité prioritaires
Ces règles déterminent si un sujet apparaît dans un guide selon que les annonces Homhero contiennent ou non des données pour ce sujet. La règle est appliquée à chaque guide à chaque synchronisation des données de l'annonce.
Trois options de visibilité sont disponibles, selon que les données existent pour tous les logements et selon la façon dont vous avez configuré vos étiquettes.
Aucun (None)
À chaque synchronisation des données, la visibilité du sujet dans ce guide revient au réglage normal : il apparaît selon ses étiquettes actives. Tout réglage Toujours afficher le sujet (Always show topic) ou Ne jamais afficher le sujet (Never show topic) que vous avez défini manuellement pour ce sujet dans ce guide est remplacé.
Utilisez cette option si :
Les données sont toujours présentes dans Homhero, ou
Vous avez ajouté dans le Centre de contenus une version générique du contenu de ce sujet, que vous souhaitez afficher lorsque Homhero n'a pas de contenu propre à l'annonce.
Masquer le sujet si le contenu est vide (Hide topic if content is blank)
Choisissez cette option si les données associées ne sont pas disponibles pour tous les logements dans Homhero. Lors de la synchronisation, si une annonce Homhero ne contient aucune donnée pour le champ associé, la Règle de visibilité (Visibility Rule) du sujet passe automatiquement à Ne jamais afficher le sujet, afin qu'il n'apparaisse pas dans ce guide. Sinon, la visibilité du sujet dans ce guide revient au réglage normal.
Afficher le sujet si le contenu n’est pas vide (Show topic if content is not blank)
Cette option fonctionne dans le sens inverse. Si une annonce Homhero contient des données pour le champ associé, la Règle de visibilité du sujet passe automatiquement à Toujours afficher le sujet pour ce guide. Sinon, la visibilité du sujet dans ce guide revient au réglage normal.
Cela convient bien aux sujets facultatifs sans étiquette attribuée dans le Centre de contenus : le sujet n'apparaît alors que dans les guides pour lesquels Homhero contient des informations pertinentes.
Mettre en forme le contenu synchronisé depuis Homhero
Si vous synchronisez des champs de texte longs, vous pouvez utiliser de simples balises HTML dans Homhero pour contrôler l'affichage du contenu dans Touch Stay. Cela s'applique aussi bien aux champs personnalisés du guide qu'aux personnalisations du sujet.
Sans mise en forme, un texte long peut arriver sous la forme d'un seul bloc continu. Quelques balises HTML ajoutées dans Homhero règlent ce problème.
Exemple sans mise en forme :
Une place de parking gratuite est réservée aux voyageurs : la place 24. Veillez à ce que le permis de stationnement soit toujours visible sur le tableau de bord de votre véhicule. Du stationnement supplémentaire est disponible dans Oak Street après 18 h.
Exemple mis en forme dans Homhero :
Informations sur le parking<br><br>Une place de parking gratuite est réservée aux voyageurs : la place 24.<br><br>Veillez à ce que le permis de stationnement soit toujours visible sur le tableau de bord de votre véhicule.<br><br>Du stationnement supplémentaire est disponible dans Oak Street après 18 h.
Une fois synchronisé avec Touch Stay, le contenu s'affichera avec un espacement correct et sera beaucoup plus lisible pour les voyageurs.
Balises HTML courantes
Balise HTML | Résultat |
| Commence une nouvelle ligne |
| Ajoute une ligne vide entre les paragraphes |
💡 Si vous avez besoin d'aide pour modifier des champs personnalisés ou ajouter une mise en forme HTML dans Homhero, contactez l'assistance Homhero. Ces champs sont gérés dans votre compte Homhero.
Synchroniser les données du guide
Les données des annonces sont synchronisées automatiquement entre Homhero et Touch Stay toutes les 24 heures. Si vous venez de faire une modification et ne voulez pas attendre, vous pouvez lancer une synchronisation manuelle à tout moment.
Resynchroniser tous les guides
Accédez à Intégrations.
Ouvrez l'onglet Mapper les données.
Cliquez sur Resynchroniser les données du guide (sous le logo Homhero).
Toutes les données associées de chaque guide sont alors synchronisées.
💡 Bon à savoir : si vous avez beaucoup de guides ou de champs associés, la synchronisation peut prendre quelques minutes.
Resynchroniser un seul guide (ancien Hub uniquement)
Le nouveau Hub ne permet pas de resynchroniser un seul guide : utilisez Resynchroniser les données du guide dans l'onglet Mapper les données (ci-dessus), qui met à jour tous les guides. Dans l'ancien Hub, vous pouvez resynchroniser un seul guide :
Accédez à la page Guides.
Ouvrez le guide que vous souhaitez mettre à jour.
Ouvrez l'onglet Détails du guide (Guide Details).
Dans la section Intégration Homhero (Homhero Integration), cliquez sur Modifier (Edit).
Cliquez sur Resynchroniser les données du guide.
FAQ
J'ai mis à jour un champ personnalisé du logement dans Homhero, mais je ne vois pas les modifications dans Touch Stay
Les données des logements sont synchronisées automatiquement de Homhero vers Touch Stay toutes les 24 heures.
Si vous avez besoin que les modifications apparaissent plus tôt, vous pouvez lancer une synchronisation manuelle depuis l'onglet Mapper les données (ou, dans l'ancien Hub, depuis le guide lui-même).
👉 Pour les étapes complètes, consultez Synchroniser les données du guide.
💬 Vous ne voyez toujours pas les données mises à jour ? Si vous avez suivi les étapes ci-dessus et que les modifications n'apparaissent toujours pas dans Touch Stay, contactez [email protected] en indiquant :
L'adresse e-mail que vous utilisez pour vous connecter
Le nom du guide
Le nom du champ personnalisé
La date de mise à jour du champ dans Homhero
Une capture d'écran de la valeur dans Homhero (si possible)
Mon champ personnalisé Homhero n'apparaît pas dans la liste Mapper les données
Lorsque vous ouvrez l'onglet Mapper les données, Touch Stay charge vos champs Homhero en arrière-plan. La liste reste en cours de chargement jusqu'à ce qu'elle soit prête, ce qui peut prendre un peu plus de temps si vous avez beaucoup de logements. Si vous voyez Échec du chargement des correspondances de champs depuis votre PMS (Failed to load field mappings from your PMS), rechargez la page et réessayez.
Vos propres champs proviennent de deux sources :
Champs au niveau du guide : Touch Stay vérifie chaque logement de votre compte Homhero et liste les champs personnalisés qu'il trouve. Un champ apparaît si au moins un logement le possède.
Champs au niveau de la réservation : Touch Stay vérifie les 50 premières réservations renvoyées par Homhero qui ne sont pas encore terminées (départ aujourd'hui ou plus tard). Un champ de réservation apparaît s'il figure sur au moins l'une d'entre elles.
Touch Stay conserve la liste des champs des logements pendant 15 minutes maximum : un champ personnalisé que vous venez d'ajouter dans Homhero peut donc mettre jusqu'à 15 minutes à apparaître.
🤝 Besoin d'aide ?
Notre assistant IA Fin est disponible 24 h/24, 7 j/7 et répond généralement en moins de 10 secondes. Si Fin ne parvient pas à résoudre votre problème, notre équipe d'assistance prendra votre demande en charge.
Vous pouvez aussi contacter notre équipe à [email protected], nous serons ravis de vous aider.