Passer au contenu principal

Mappage des données au niveau du guide avec Hostaway

Découvrez comment mapper les données d'annonce Hostaway sur vos guides Touch Stay à l'aide des champs personnalisés du guide ou des personnalisations de topic. Synchronisez automatiquement les détails du Wi-Fi, le règlement intérieur, les informations de…

Le mappage des données au niveau du guide vous permet de synchroniser automatiquement les données d'annonce et de réservation de Hostaway avec vos guides Touch Stay. Cet article couvre tout ce dont vous avez besoin pour le configurer, de la compréhension des deux types de mappage à l'ajout de champs, jusqu'à l'utilisation de vos données dans le contenu du guide.


Comprendre les sources de données dans Hostaway

Lorsque vous créez un nouveau mappage, vous devrez choisir un type de mappage. Le bon choix dépend du fait que l'information change à chaque réservation ou reste identique pour le logement.

Champ personnalisé utilisateur/invité

Utilisez cette option pour les informations qui changent à chaque réservation, telles que :

  • Numéro de réservation

  • Code de porte (s'il est différent pour chaque réservation)

  • Portail invité Hostaway

Ces données sont liées à la réservation et n'apparaissent que lorsqu'un invité ouvre son lien d'invitation personnalisé.

Champ personnalisé du guide

Utilisez cette option pour les informations qui appartiennent au logement et restent identiques pour toutes les réservations, telles que :

  • Détails du Wi-Fi

  • Informations de stationnement

  • Règlement intérieur

  • Instructions de ménage

Ces données sont liées à l'annonce du logement et s'affichent dans le guide lui-même.


Champs supplémentaires que vous pouvez mapper

En plus des champs mappés automatiquement lors de la configuration, Hostaway propose plusieurs champs supplémentaires que vous pouvez mapper manuellement pour une personnalisation plus avancée :

Champ

Type de mappage

Type de donnée

Code de porte

Champ personnalisé utilisateur/invité

Texte

E-mail Hostaway

Champ personnalisé utilisateur/invité

Texte - lorsqu'il est ajouté comme adresse de réponse dans vos modèles du Message Hub, toute réponse sera envoyée vers votre boîte de réception Hostaway

ID de réservation du canal

Champ personnalisé utilisateur/invité

Nombre

ID de réservation Hostaway

Champ personnalisé utilisateur/invité

Nombre

Nom d'utilisateur WIFI

Champ personnalisé du guide

Texte

Mot de passe WIFI

Champ personnalisé du guide

Texte

💡 Vous pouvez également créer vos propres champs personnalisés directement dans Hostaway et les mapper vers Touch Stay, ce qui vous offre une flexibilité totale sur les données qui apparaissent dans vos guides.


Choisissez comment vous souhaitez afficher vos données

Il existe deux façons d'intégrer les données Hostaway dans vos guides, 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 que vous souhaitez insérer dans un topic existant, telles que :

  • Nom d'utilisateur Wi-Fi

  • Mot de passe Wi-Fi

  • Numéro de place de stationnement

  • Code de porte

  • Nombre d'invités par réservation

Une fois mappé, vous insérez le champ dans le contenu de votre topic à l'aide d'un code de champ. Chaque guide affichera automatiquement les informations correctes issues de son annonce Hostaway.

Comment créer un mappage avec un champ personnalisé

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

  2. Cliquez sur Map Data (Mapper les données).

  3. Cliquez sur + Add new mapping (+ Ajouter un nouveau mappage)

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

  5. Choisissez un champ personnalisé existant, ou cliquez sur + New Custom Field (+ Nouveau champ personnalisé) pour en créer un. Si vous créez un nouveau champ personnalisé :

  6. Saisissez un Field Code (Code de champ). Nous vous recommandons d'ajouter _hostaway à la fin (par ex. door_code_hostaway) afin d'identifier facilement d'où proviennent les données

  7. Facultatif - Ajoutez une Substitute Value (Valeur de substitution) (voir ci-dessous) à afficher lorsque les données sont manquantes.

  8. Cliquez sur Save (Enregistrer).

Substitute Value

Une valeur de substitution est une solution de repli utilisée lorsque Hostaway 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 substitution. Par exemple

  • Contactez-nous si cette information est manquante

  • Non fourni

  • Veuillez demander à votre hôte

👉 En savoir plus : Explication des codes de champ.

Utiliser les données mappées de vos champs personnalisés

Une fois qu'un champ a été mappé, vous pouvez l'utiliser dans tout Touch Stay, notamment :

Contenu du topic

Dans votre Content Hub, ouvrez n'importe quel topic et cliquez sur le bouton Field Codes (codes de champ). Vous verrez tous les champs disponibles issus de l'intégration Hostaway, les coordonnées des invités, 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 mappés.

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

Dans les modèles Touch Stay du Message Hub

Les mêmes codes de champ fonctionnent dans vos modèles de message du Message Hub, ce qui vous permet d'envoyer des communications personnalisées aux invités sans mise à jour manuelle à chaque réservation.


Option 2. Personnalisations de topic

Idéal pour un contenu plus long qui mérite son propre topic dans le guide, tel que :

  • Instructions de stationnement

  • Comment accéder au logement

  • Instructions relatives aux équipements

  • Règlement intérieur

  • Instructions de ménage

  • Équipements spécifiques au logement

Touch Stay crée une version personnalisée du topic sélectionné pour chaque guide, à partir du contenu stocké dans l'annonce Hostaway correspondante.

⚠️ Attention : Vous devrez créer le topic dans votre Content Hub avant de pouvoir le sélectionner ici. Nous vous recommandons de créer d'abord votre topic principal, puis de revenir pour lui mapper les données Hostaway.

Comment créer un mappage avec les personnalisations de topic

  1. Accédez à Integrations.

  2. Ouvrez l'onglet Map Data.

  3. Cliquez sur + Add New Mapping.

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

  5. Sous Mapping Type (Type de mappage), sélectionnez Topic Customisation (Personnalisation de topic).

  6. Choisissez le topic Touch Stay que vous souhaitez alimenter ; vous pouvez effectuer une recherche par nom

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

  8. Cliquez sur Save (Enregistrer)

Règles de remplacement de visibilité

Ces règles déterminent si un topic apparaît sur un guide en fonction de la présence de données pour ce topic dans les annonces Hostaway.


Trois options de visibilité s'offrent à vous, selon que les données sont disponibles pour chaque logement et selon la configuration de vos étiquettes.

None (Aucune)

C'est l'option la plus simple.

Le processus de synchronisation n'apportera aucune modification à la visibilité du topic. Le topic continuera d'apparaître en fonction de ses étiquettes actives.

Utilisez cette option si :

  • Les données sont toujours présentes dans Hostaway, ou

  • Vous disposez d'une version générique du contenu de ce topic ajoutée au Content Hub, que vous souhaitez afficher en l'absence de contenu spécifique à l'annonce dans Hostaway.

Hide topic if content is blank (Masquer le topic si le contenu est vide)

Choisissez cette option si les données mappées ne sont pas disponibles pour chaque logement dans Hostaway

Pendant le processus de synchronisation, si une annonce Hostaway ne contient aucune donnée pour le champ mappé, la règle de visibilité du topic sera automatiquement réglée sur Always Hide (Toujours masquer), afin qu'il n'apparaisse pas sur ce guide.

Show topic if content is not blank (Afficher le topic si le contenu n'est pas vide)

Cette option fonctionne à l'inverse.

Si une annonce Hostaway contient des données pour le champ mappé, la règle de visibilité du topic sera automatiquement réglée sur Always Show (Toujours afficher) pour ce guide.

Cette option fonctionne bien pour les topics facultatifs qui n'ont pas d'étiquette attribuée dans le Content Hub, ce qui permet au topic de n'apparaître que sur les guides pour lesquels Hostaway contient des informations pertinentes.


Mettre en forme le contenu synchronisé depuis Hostaway

Si vous synchronisez des champs de texte plus longs, vous pouvez utiliser des balises HTML simples dans Hostaway pour contrôler l'affichage du contenu dans Touch Stay. Cela s'applique aussi bien aux champs personnalisés du guide qu'aux personnalisations de topic.

Sans mise en forme, un texte long peut arriver sous la forme d'un seul bloc ininterrompu. L'ajout de quelques balises HTML dans Hostaway permet de résoudre ce problème.

Exemple - non mis en forme :

Une place de stationnement gratuite est disponible pour les invités à l'emplacement 24. Veuillez vous assurer que le permis de stationnement est toujours affiché sur le tableau de bord de votre voiture. Un stationnement supplémentaire dans la rue est disponible sur Oak Street après 18h.

Exemple - mis en forme dans Hostaway :

Informations de stationnement<br><br>Une place de stationnement gratuite est disponible pour les invités à l'emplacement 24.<br><br>Veuillez vous assurer que le permis de stationnement est toujours affiché sur le tableau de bord de votre voiture.<br><br>Un stationnement supplémentaire dans la rue est disponible sur Oak Street après 18h.

Lorsqu'il est synchronisé avec Touch Stay, le contenu s'affichera avec un espacement correct et sera beaucoup plus facile à lire pour les invités.

Balises HTML courantes

Balise HTML

Résultat

<br>

Démarre 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 Hostaway, contactez le support Hostaway. Ces champs sont gérés directement dans votre compte Hostaway


Synchronisation des données du guide

Les données d'annonce se synchronisent automatiquement entre Hostaway et Touch Stay toutes les 24 heures. Si vous venez d'effectuer une modification et ne souhaitez pas attendre, vous pouvez déclencher une synchronisation manuelle à tout moment.

Resynchroniser tous les guides

  1. Accédez à Integrations.

  2. Ouvrez l'onglet Map Data.

  3. Cliquez sur Resync Guide Data (Resynchroniser les données du guide) (situé sous le logo Hostaway).

Cela synchronisera toutes les données mappées pour chaque guide.

💡 Bon à savoir

Si vous avez un grand nombre de guides ou de champs mappés, la synchronisation peut prendre quelques minutes.

Resynchroniser un seul guide

  1. Accédez à la page Guides.

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

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

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

  5. Cliquez sur Resync guide data.


FAQ

J'ai mis à jour un champ personnalisé de logement dans Hostaway, mais je ne vois pas les changements dans Touch Stay

Les données du logement sont automatiquement synchronisées de Hostaway vers Touch Stay toutes les 24 heures.

Si vous avez besoin que les changements apparaissent plus rapidement, vous pouvez déclencher une synchronisation manuelle :

Pour mettre à jour tous les guides

Accédez à IntegrationsMap Data puis cliquez sur Resync Guide Data.

Pour mettre à jour un seul guide :

Accédez à GuidesGuide Details (Détails du guide) → Hostaway Integration, cliquez sur Edit (Modifier), puis sélectionnez Resync guide data.

💬 Vous ne voyez toujours pas les données mises à jour ?
Si vous avez suivi les étapes ci-dessus et que les changements n'apparaissent toujours pas dans Touch Stay, veuillez contacter [email protected] et indiquer :

  • Votre adresse e-mail de connexion

  • Le nom du guide

  • Le nom du champ personnalisé

  • La date à laquelle le champ a été mis à jour dans Hostaway

  • Une capture d'écran de la valeur dans Hostaway (si possible)


🤝 Besoin d'aide ?

Si vous avez des questions ou besoin d'aide pour la configuration, n'hésitez pas à nous contacter.

Ou envoyez-nous un ticket d'assistance directement depuis votre compte Touch Stay.


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