Passer au contenu principal

Les codes de champ expliqués

Les codes de champ sont des espaces réservés intelligents qui se remplissent automatiquement avec les bonnes informations pour chaque guide, chaque invité ou chaque message. Ils vous permettent de personnaliser le contenu de votre guide et vos messages…

Dans le nouveau Hub, les codes de champ se trouvent dans la section Bibliothèque du compte (Account library) → Codes de champ (Field Codes) : un emplacement central où tous vos codes dynamiques sont gérés et disponibles dans tous vos guides et messages.

Table des matières :


Comment fonctionnent les codes de champ

Vous ajoutez un code court, comme {{guest_first_name}}, dans le contenu de votre guide ou dans un modèle de message. Lorsque votre voyageur consulte le guide ou reçoit un message, Touch Stay remplace automatiquement le code par les informations réelles.

Exemple :

Vous écrivez :

« Bonjour {{guest_first_name}}, nous avons hâte de vous accueillir à {{guide_name}} le {{arrival_date}} ! »

Votre voyageur voit :

« Bonjour Sarah, nous avons hâte de vous accueillir à Casa del Sol le 10 juillet ! »

⚠️ Vous avez copié un code précédé de # ? Les anciennes versions de cet article montraient les exemples avec des caractères # devant le code. Le # ne fait pas partie du code et n'est jamais remplacé : vos voyageurs le voient donc comme du texte brut (par exemple « ###Sarah »). Modifiez ce contenu, supprimez les caractères # et ne gardez que le code entre accolades.


Où trouver les codes de champ

  1. Ouvrez la Bibliothèque du compte depuis la barre latérale gauche.

  2. Cliquez sur Codes de champ.

Vous y voyez tous vos codes de champ standard et personnalisés, et vous pouvez en créer de nouveaux et définir des valeurs de remplacement.


Utiliser les codes de champ dans le contenu du guide

Vous pouvez utiliser des codes de champ directement dans les sujets de votre guide pour que le contenu paraisse unique pour chaque logement ou voyageur.

Exemple : {{guide_name}} peut transformer un titre de catégorie comme « À propos du logement » en « À propos de Casa del Sol », automatiquement, pour chaque guide.

Comment insérer un code de champ dans votre guide :

  • Pour les titres de section : cliquez sur le bouton Insérer un code de champ (Insert Field code)

  • Pour le contenu des sujets : utilisez l'option Code de champ (Field code) de la barre d'outils de l'éditeur de texte

⚠️ Remarque sur les liens de partage rapide : Si vous partagez votre guide avec un lien de partage rapide (Quick Share link) au lieu d'une invitation personnalisée, certains codes de champ n'auront aucune donnée à afficher, car le lien de partage rapide est le même pour tous ceux qui l'ouvrent et n'est lié à aucune invitation. Dans ce cas, c'est la valeur de remplacement qui s'affiche (voir la section Valeur de remplacement (Substitute value) ci-dessous).


Utiliser les codes de champ dans les modèles de message

Les codes de champ personnalisent vos messages automatiques sans effort supplémentaire. Par exemple, {{guest_first_name}} sera automatiquement remplacé par le prénom réel du voyageur lors de l'envoi du message.

Comment insérer un code de champ dans les messages :

  • Pour le Nom de l’expéditeur (Email from name) ou l'Objet (Subject) de l'e-mail : cliquez sur Insérer un code de champ

  • Pour le corps de l'e-mail ou le contenu du SMS : utilisez l'option Code de champ de la barre d'outils de l'éditeur de texte

💡 Astuce : Vous pouvez aussi utiliser les codes de champ pour définir les critères des modèles de message, afin de déterminer quels messages s'appliquent à quel guide ou voyageur. En savoir plus : Comprendre les critères des modèles de message


Codes de champ standard

Ils sont inclus automatiquement dans votre compte et reposent sur des champs fixes de Touch Stay :

Codes liés au guide :

Code

Ce qu'il insère

guide_name

Le nom du guide

guide_address ¹

L'adresse du guide (numéro et rue)

guide_city

La ville du guide

guide_region_state

La région ou l'État du guide

guide_zipcode

Le code postal du guide

guide_country

Le pays du guide

guide_contact_name ¹

Le nom du contact défini dans le guide ou dans le profil du compte

guide_contact_email ¹

L'adresse e-mail de contact définie dans le guide ou dans le profil du compte

guide_contact_phone ¹

Un lien cliquable pour appeler le numéro de téléphone de contact

guide_contact_sms ¹

Un lien cliquable pour envoyer un SMS au numéro de téléphone de contact

guide_contact_whatsapp ¹

Un lien cliquable vers le numéro WhatsApp de votre compte

organisation_name ¹

Le nom de votre organisation

Codes liés au voyageur :

Code

Ce qu'il insère

guest_first_name ¹

Le prénom du voyageur (issu de l'invitation)

guest_last_name ¹

Le nom de famille du voyageur (issu de l'invitation)

guest_email

L'adresse e-mail du voyageur (issue de l'invitation)

guest_phone

Le numéro de téléphone du voyageur (issu de l'invitation)

arrival_date

La date d'arrivée ou de début (issue de l'invitation)

departure_date

La date de départ ou de fin (issue de l'invitation)

length_of_stay

La durée du séjour en nuits (issue de l'invitation)

days_created_before_arrival

Le nombre de jours entre la création de l'invitation et la date d'arrivée

invitation_creation_date

La date de création de l'invitation

booking_source

La source de réservation définie dans l'invitation

Autres codes :

Code

Ce qu'il insère

host_name ¹

Le prénom défini dans le profil de votre compte

invitation_link ¹

Le lien unique de l'invitation

invitation_view_count

Le nombre de vues de l'invitation

tag ²

Les étiquettes actives du guide

guidebook_pin ¹

Le code PIN du guide, si un PIN est activé pour le guide

checkin_time ¹

L'heure d'arrivée (issue de l'invitation, du guide ou des valeurs par défaut du compte). Comptes de location uniquement

checkout_time ¹

L'heure de départ (issue de l'invitation, du guide ou des valeurs par défaut du compte). Comptes de location uniquement

wifi_network_name ¹

Le nom du réseau Wi-Fi (issu de l'invitation, du guide ou des valeurs par défaut du compte). Comptes de location uniquement

wifi_password ¹

Le mot de passe Wi-Fi (issu de l'invitation, du guide ou des valeurs par défaut du compte). Comptes de location uniquement

quick_share_link ¹

Un lien cliquable vers le lien de partage rapide du guide. Proposé uniquement dans la Collecte de contenu (Content Collection)

owner_first_name ¹

Le prénom du propriétaire du logement associé au guide. Proposé uniquement dans la Collecte de contenu

owner_last_name ¹

Le nom de famille du propriétaire du logement associé au guide. Proposé uniquement dans la Collecte de contenu

content_collection_form_link ¹

Le lien vers le formulaire de Collecte de contenu du propriétaire. Proposé uniquement dans la Collecte de contenu

Remarques :

  • ¹ Ces codes ne sont pas disponibles pour définir les critères des messages.

  • ² Ce code n'est pas disponible dans les modèles de message ni dans le contenu du guide.


Codes de champ personnalisés

Vous pouvez créer vos propres codes de champ pour toute information utile à la personnalisation pour vos voyageurs : codes de serrure, liens d'avis, identifiants de réservation, et plus encore.

Comment créer un code de champ personnalisé :

  1. Ouvrez Bibliothèque du compte → Codes de champ.

  2. Cliquez sur Nouveau code de champ (New Field Code).

  3. Configurez les éléments suivants :

Code de champ (Field code)

Le nom constitue aussi le code court utilisé dans votre contenu. Règles :

  • Lettres, chiffres, traits de soulignement et tirets uniquement

  • Pas d'espaces ni de caractères spéciaux

  • Les doubles accolades sont ajoutées automatiquement : vous n'avez pas besoin de les ajouter vous-même

Type de champ (Field type)

Détermine où les données sont définies :

Type de champ

Quand l'utiliser

Exemple

Champ personnalisé utilisateur/voyageur (User/Guest custom field)

Données définies lors de la création d'une invitation, propres à chaque voyageur

Code de la serrure, numéro de place de stationnement

Champ personnalisé du guide (Guide custom field)

Données définies dans le guide, propres à chaque logement

Lien d'avis, nom du gestionnaire du logement

Type de données (Data type)

Détermine le type de données que contient le code de champ :

Type de données

Ce qu'il accepte

Exemple d'utilisation

Texte (Text)

Texte libre sans mise en forme

Numéro ou ID de réservation

Lien (Link)

Un lien web, affiché sous forme de lien cliquable

La page d'avis de votre site web

Liste (List)

Un ensemble prédéfini de valeurs (saisissez-les en les séparant par une virgule)

Type de voyageur (couple, famille, célébration)

Date

Une date fixe, qui permet d'utiliser des critères temporels (avant, après)

Date d'un événement, changement de saison

Heure (Time)

Une heure de la journée

Heure de départ tardif convenue

Nombre (Number)

Nombres entiers uniquement, qui permettent d'utiliser des critères de valeur (supérieur à, inférieur à)

Nombre de voyageurs, numéro d'étage

Oui ou Non (Yes or No)

Un simple choix oui ou non

Transfert aéroport réservé, panier de bienvenue demandé

💡 Remarque : Les champs personnalisés acceptent jusqu'à 65 000 caractères, mais le contenu ne peut pas être mis en forme : pas de sauts de ligne ni de paragraphes.

Valeur de remplacement (Substitute value)

Une valeur de secours facultative, affichée lorsque les données du code de champ sont manquantes.

Exemple : Vous créez un code de champ personnalisé appelé {{lock_code}} et vous définissez comme valeur de remplacement « Appelez-nous si le code est manquant ». Si vous oubliez un jour d'ajouter le code de la serrure à une invitation, c'est la valeur de remplacement qui s'affiche : votre voyageur n'est jamais laissé sans instructions.

Les valeurs de remplacement sont aussi utilisées pour les codes de champ standard sur votre lien de partage rapide, où les données propres à une invitation ne sont pas disponibles.


Qu'est-ce qui change par rapport à l'ancien Hub ?

Ancien Hub

Nouveau Hub

Codes de champ gérés depuis l'onglet Codes de champ de la page Compte (Account)

Codes de champ gérés depuis Bibliothèque du compte → Codes de champ

Accessibles séparément des autres outils de contenu réutilisable

Regroupés avec Étiquettes (Tags), Éléments personnalisés (Custom Elements) et Centre de contenus (Content Hub) dans la Bibliothèque du compte

Mêmes fonctionnalités

Mêmes fonctionnalités : elles n'ont pas changé, seul leur emplacement est différent


🤝 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 ?