Passer au contenu principal

Correspondance des données par guide avec Homhero

Mettez en correspondance les données des annonces Homhero avec vos guides via les champs personnalisés du guide ou les personnalisations du sujet. Synchronisez le Wi-Fi, le règlement intérieur, le stationnement, les champs personnalisés et plus.

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 mettre en correspondance :

  • Les champs au niveau de la réservation se mettent en correspondance directement avec un Champ personnalisé utilisateur/voyageur (user/guest custom field). Aucune étape de choix du type de correspondance ne s'affiche pour eux.

  • 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

  • Remarques sur l'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 qui appartiennent au logement et restent les mêmes d'une réservation à l'autre, par exemple :

  • Numéro de clé

  • Notes d'arrivée

  • Champs personnalisés de vos locations Homhero (par exemple, les identifiants 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 mettre en correspondance

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 (adultes, enfants, bébés, animaux)

Réservation

Nombre

Nights (nuits)

Réservation

Nombre

Reservation Note, Arrival Notes, Departure Notes (note de réservation, notes d'arrivée, notes de départ)

Réservation

Texte

Lockbox Code, Access Code (code du boîtier à clé, code d'accès)

Réservation

Texte

Bedding Config, Portacot, Agent, Review (configuration du couchage, lit parapluie, agent, avis)

Réservation

Texte

Description, Check-In Notes, Key Number (description, notes d'arrivée, numéro de clé)

Guide

Texte

Listing Notes, Cleaner Notes, Checklist, Lease Agreement (notes sur l'annonce, notes pour le ménage, liste de contrôle, contrat de location)

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.


Choisir 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 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é

  1. Accédez à Intégrations (Integrations).

  2. Ouvrez l'onglet Mapper les données (Map data).

  3. Cliquez sur Ajouter une correspondance (Add new mapping).

  4. Sélectionnez le champ de données Homhero que vous souhaitez synchroniser.

  5. Pour un champ au niveau du guide, sélectionnez Champ personnalisé du guide sous Choisissez le type de correspondance. (Cette étape n'apparaît pas pour les champs au niveau de la réservation.)

  6. 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é :

  7. Saisissez un code de champ (Field Code). Nous vous recommandons d'ajouter _homhero à la fin (par exemple key_number_homhero) pour identifier facilement la provenance des données.

    Facultatif : ajoutez une Valeur de remplacement (Substitute Value), décrite ci-dessous, à afficher lorsque des données sont manquantes.

  8. Cliquez sur Enregistrer (Save).

  9. 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 mis en correspondance 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 mis en correspondance et que vous 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 : Tout savoir sur les codes de champ.

Utiliser les données de vos champs personnalisés mis en correspondance

Une fois la correspondance d'un champ établie, vous pouvez l'utiliser partout dans Touch Stay, notamment :

Contenu du sujet (Topic content)

Dans votre Centre de contenus, ouvrez n'importe quel sujet et cliquez sur le bouton Codes de champ. 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 les champs supplémentaires que vous avez mis en correspondance.

Insérez-les directement dans votre contenu pour personnaliser automatiquement l'expérience de chaque voyageur.

Dans les modèles du Centre de messages

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 d'arrivée

  • Description du logement

  • Notes sur 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 mis en correspondance avec 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 y mettre en correspondance les données Homhero.

Comment créer une correspondance avec les personnalisations du sujet

  1. Accédez à Intégrations.

  2. Ouvrez l'onglet Mapper les données.

  3. Cliquez sur Ajouter une correspondance.

  4. Sélectionnez le champ de données Homhero au niveau du guide que vous souhaitez synchroniser.

  5. Sous Choisissez le type de correspondance, sélectionnez Personnalisation du sujet.

  6. Choisissez le sujet Touch Stay que vous souhaitez remplir ; vous pouvez le rechercher par son nom.

  7. Choisissez une règle de visibilité prioritaire (voir ci-dessous).

  8. Cliquez sur Enregistrer.

  9. 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 sur 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 sur ce guide revient au réglage normal : il apparaît selon ses étiquettes actives. Tout réglage Toujours afficher le sujet ou Ne jamais afficher le sujet que vous avez défini à la main pour ce sujet sur ce guide est remplacé.

Utilisez cette option si :

  • les données sont toujours présentes dans Homhero, ou

  • vous avez ajouté au 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 mises en correspondance 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 concerné, la Règle de visibilité du sujet est automatiquement réglée sur Ne jamais afficher le sujet (Never show topic), de sorte qu'il n'apparaît pas sur ce guide. Sinon, la visibilité du sujet sur 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 à l'inverse. Si une annonce Homhero contient des données pour le champ concerné, la Règle de visibilité du sujet est automatiquement réglée sur Toujours afficher le sujet (Always show topic) pour ce guide. Sinon, la visibilité du sujet sur ce guide revient au réglage normal.

Cela convient bien aux sujets facultatifs auxquels aucune étiquette n'est attribuée dans le Centre de contenus : le sujet n'apparaît alors que sur 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 facile à lire pour les voyageurs.

Balises HTML courantes

Balise HTML

Résultat

<br>

Commence une nouvelle ligne

<br><br>

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

  1. Accédez à Intégrations.

  2. Ouvrez l'onglet Mapper les données.

  3. Cliquez sur Resynchroniser les données du guide (situé sous le logo Homhero).

Toutes les données mises en correspondance de chaque guide sont alors synchronisées.

💡 Bon à savoir : si vous avez beaucoup de guides ou de champs mis en correspondance, la synchronisation peut prendre quelques minutes.

Resynchroniser un seul guide

Nouveau Hub : ouvrez le guide, allez dans son onglet Paramètres (Settings) et cliquez sur Resynchroniser les données du guide sur la carte Intégration Homhero (Homhero integration). La carte n'apparaît que sur les guides associés à un logement Homhero.

Ancien Hub : resynchronisez un seul guide comme suit :

  1. Accédez à la page Guides.

  2. Ouvrez le guide que vous souhaitez mettre à jour.

  3. Ouvrez l'onglet Détails du guide (Guide Details).

  4. Dans la section Intégration Homhero (Homhero Integration), cliquez sur Modifier (Edit).

  5. 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 s'affiche comme 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, 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'à ce délai à 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.

Avez-vous trouvé la réponse à votre question ?