Passer au contenu principal

Intégration Homhero

Configurez l'intégration Homhero avec Touch Stay : importation des logements, synchronisation des réservations, correspondance des codes de champ, invitations des voyageurs et mise à jour des guides une fois Homhero connecté.

Connectez Touch Stay à Homhero pour automatiser la communication avec vos voyageurs. Importez vos logements, synchronisez vos réservations, personnalisez vos guides avec les données Homhero et partagez automatiquement des liens de guide personnalisés avec vos voyageurs.

Cet article explique pas à pas comment configurer l'intégration.

Table des matières :


Étape 1. Obtenir vos identifiants API Homhero

Avant de connecter Homhero à Touch Stay, vous devez activer l'intégration Touch Stay dans Homhero et copier vos identifiants API.

  1. Dans Homhero, cliquez sur Marketplace dans le menu de gauche

  2. Repérez et sélectionnez l'icône Touch Stay

  3. Activez l'interrupteur Active (actif)

  4. Copiez votre Key (clé)

  5. Sous Password (mot de passe), cliquez sur l'icône en forme d'œil pour afficher le mot de passe, puis copiez-le.

  6. Property Fields (champs du logement) - le champ « Touchstay Guide Link » est généré automatiquement dans Property Management / Properties / Booking Fields

  7. Cliquez sur Save (enregistrer)


Étape 2. Connecter Homhero à Touch Stay

Une fois votre clé et votre mot de passe copiés depuis Homhero, retournez dans Touch Stay pour finaliser la connexion.

  1. Accédez à Intégrations (Integrations) dans la barre latérale de gauche et ouvrez l'onglet Partenaires (Partners).

  2. Repérez Homhero et cliquez sur Connecter (Connect).

  3. Collez votre clé dans Clé d'intégration Homhero (Homhero integration key) et votre mot de passe dans Secret du jeton Homhero (Homhero token secret).

  4. Cliquez sur Enregistrer.


Étape 3. Associer les logements Homhero

Si vous avez déjà des guides dans Touch Stay, vous allez maintenant les associer aux logements correspondants dans Homhero.

  1. Accédez à Intégrations

  2. Cliquez sur l'onglet Associer (Match)

  3. Utilisez le menu déroulant à côté de chaque guide Touch Stay pour sélectionner le logement Homhero correspondant

  4. Cliquez sur Associer la sélection (Match Selected)

💡 Prenez un instant pour vérifier vos associations avant de continuer. Cela permet de s'assurer que les bonnes informations de logement et les bonnes réservations se synchronisent avec le bon guide.

Vous n'avez aucun guide à associer ?

Pas de souci. Si vous créez de nouveaux guides à partir de vos logements Homhero, ignorez cette étape et passez à l'onglet Importer (Import).


Étape 4. Importer les logements Homhero

Si certains logements Homhero n'ont pas été associés à un guide Touch Stay existant, vous pouvez les importer sous forme de nouveaux guides.

  1. Accédez à Intégrations

  2. Cliquez sur l'onglet Importer.

  3. Sélectionnez les logements Homhero que vous souhaitez importer.

  4. Cliquez sur Importer la sélection (Import Selected).

💡 Bon à savoir

Seuls les logements Homhero non associés apparaissent dans l'onglet Importer. Une fois l'importation effectuée, un nouveau guide Touch Stay est créé pour chaque logement sélectionné.

Touch Stay importe automatiquement :

  • Nom du logement

  • Adresse du logement

  • Localisation du logement

Vous démarrez ainsi plus vite, avec les informations de base du logement déjà ajoutées à votre guide.


Étape 5. Finaliser la création des guides (nouveaux clients Touch Stay uniquement)

Avant d'activer la synchronisation, prenez un moment pour passer vos guides en revue et vérifier que tout est prêt à être partagé avec vos voyageurs. Vérifiez notamment :

  • Contenu du guide

  • Informations sur le logement

  • Instructions d'arrivée

  • Coordonnées

  • Images et identité visuelle

💡 Vous débutez avec Touch Stay ?

Regardez notre Vidéo de démarrage rapide : vous y trouverez des conseils utiles pour créer le plus rapidement possible votre guide d'accueil numérique.


Étape 6. Paramètres de personnalisation

Une fois l'intégration connectée, Homhero envoie automatiquement les données de réservation à Touch Stay, sans aucune configuration supplémentaire. Vous pouvez ainsi personnaliser vos guides et les messages à vos voyageurs avec des informations comme :

  • Noms des voyageurs

  • Dates d'arrivée et de départ

  • Heures d'arrivée et de départ

Champs mis en correspondance automatiquement

Les champs suivants sont utilisables immédiatement :

Champ

Type de correspondance

Type de données

{{guest_first_name}}

Champ personnalisé utilisateur/voyageur

Texte

{{guest_last_name}}

Champ personnalisé utilisateur/voyageur

Texte

{{arrival_date}}

Champ personnalisé utilisateur/voyageur

Nombre

{{checkin_time}}

Champ personnalisé utilisateur/voyageur

Heure

{{checkout_time}}

Champ personnalisé utilisateur/voyageur

Heure

{{departure_date}}

Champ personnalisé utilisateur/voyageur

Nombre

{{guest_phone}} ⚠️

Champ personnalisé utilisateur/voyageur

Nombre

{{guest_email}} ⚠️

Champ personnalisé utilisateur/voyageur

Texte

⚠️ La disponibilité du numéro de téléphone et de l'e-mail dépend de la plateforme OTA utilisée par le voyageur pour réserver.

💡 En savoir plus dans Tout savoir sur les codes de champ

Vous souhaitez synchroniser davantage de données du logement ?

Vous pouvez aussi mettre en correspondance d'autres champs Homhero, comme les informations Wi-Fi, les codes d'accès, les informations de stationnement et le règlement intérieur, afin que chaque guide récupère automatiquement les bonnes informations sur le logement.


Étape 7. Synchroniser les réservations

Synchronisez les réservations Homhero avec votre compte Touch Stay pour finaliser l'intégration.

  1. Accédez à Intégrations

  2. Ouvrez l'onglet Synchroniser les réservations (Sync Reservations ; ancien Hub : Synchroniser les réservations).

  3. Choisissez comment vous souhaitez importer les réservations :

    • Toutes les réservations (All reservations ; recommandé si vous débutez avec Touch Stay) — importe toutes les réservations à venir depuis Homhero et crée des invitations pour celles-ci.

    • Nouvelles réservations uniquement (New reservations only ; recommandé si vous utilisez déjà les invitations du Centre de messages) — importe uniquement les réservations créées après l'activation de la synchronisation, ce qui évite les invitations en double.

  4. Sélectionnez le ou les guides à synchroniser — la case Tout sélectionner (Select all) se trouve en haut, à côté du bouton Synchroniser la sélection (Sync Selected) — puis cliquez sur Synchroniser la sélection.

Une fois la synchronisation active, les nouvelles réservations confirmées dans Homhero sont automatiquement importées dans Touch Stay pour les guides sélectionnés.

💡 Bon à savoir

La première synchronisation peut prendre quelques minutes, selon le nombre de logements et de réservations importés. Vous pouvez continuer à utiliser Touch Stay pendant que la synchronisation s'exécute en arrière-plan.

⚠️ Attention

Chaque fois que vous ajoutez un nouveau guide et le connectez à un logement Homhero, vous devez aussi activer la synchronisation pour ce guide. Si elle n'est pas activée, les réservations ne seront pas importées et aucun lien d'invitation ne sera créé pour les voyageurs qui séjournent dans ce logement.


Étape 8. Partager les liens du guide via Homhero

Une fois la synchronisation des réservations activée, Touch Stay crée dans Homhero un champ de réservation appelé Touchstay Guide Link. Ajoutez-le à vos messages depuis la liste des champs de fusion de Homhero.

Ce champ contient un lien de guide unique et traçable pour chaque réservation.

Utiliser le lien du guide dans vos messages Homhero aux voyageurs

Une fois l'intégration configurée, vous pouvez ajouter le champ de fusion Touch Stay Guide Link à vos modèles de messages Homhero. Chaque voyageur reçoit ainsi automatiquement son propre lien de guide personnalisé, unique pour sa réservation.

  • Pour créer un nouveau message automatisé dans Homhero, consultez l'article d'aide de Homhero « Adding a New Correspondence Template ».

  • Pour savoir comment ajouter des champs de fusion à vos messages, consultez l'article d'aide de Homhero « Merge Fields ».

  • Pour obtenir une aide supplémentaire sur la création d'automatisations de messages dans Homhero, contactez l'assistance Homhero.

À propos du délai d'envoi des messages Homhero - Important

Un court délai peut s'écouler entre la réception d'une réservation dans Homhero et la génération du lien du guide Touch Stay, puis sa synchronisation vers Homhero.

⚠️ Important
N'insérez pas le lien du guide Touch Stay dans les messages envoyés immédiatement après la réception d'une réservation. Envoyez plutôt votre message avec le guide au moins 1 heure plus tard, voire le lendemain, afin que le lien de guide personnalisé soit prêt.


Bonnes pratiques pour partager votre guide

Pour offrir la meilleure expérience à vos voyageurs, nous recommandons le calendrier d'envoi suivant :

Après la confirmation de la réservation

  • Quand : environ 1 heure après la confirmation de la réservation.

  • Pourquoi : cela laisse à Touch Stay le temps de générer le lien de guide personnalisé avant son envoi.

Avant l'arrivée

  • Quand : quelques jours ou quelques semaines avant l'arrivée.

  • Pourquoi : cela rappelle aux voyageurs de consulter les informations importantes et de préparer leur séjour.

La veille de l'arrivée

  • Quand : 1 jour avant l'arrivée.

  • Pourquoi : un dernier rappel avec les instructions d'arrivée, les informations d'accès et tout ce dont les voyageurs ont besoin avant d'arriver.

Que se passe-t-il si j'utilise déjà le Centre de messages ?

Si vous souhaitez passer du Centre de messages à Homhero pour envoyer les liens du guide :

  1. Archivez vos modèles de messages existants du Centre de messages ; ils ne seront ainsi plus ajoutés aux nouvelles réservations.

  2. Configurez votre nouveau flux de messages Homhero.

  3. L'archivage n'a aucun effet sur les invitations existantes. Pour annuler les messages déjà programmés, supprimez plutôt le modèle du Centre de messages.


Étape 9. À quoi s'attendre dans le Centre de messages

Une fois vos réservations synchronisées depuis Homhero, accédez à Messagerie et chat → Invitations (Messaging & Chat → Invitations ; ancien Hub : Centre de messages → Invitations) pour tout voir au même endroit.

Chaque réservation confirmée dans Homhero crée automatiquement ici une fiche d'invitation. Pour chacune, vous voyez :

  • Guide : le logement concerné par la réservation

  • Nom, e-mail et téléphone du voyageur

  • Date d'arrivée

  • Date de création : date à laquelle la fiche d'invitation a été générée

  • Vues : nombre de fois où le voyageur a ouvert le guide

  • Dernière consultation : date à laquelle le voyageur a ouvert le guide pour la dernière fois

Invitations list

Si vous utilisez des modèles du Centre de messages

Tous les modèles de messages actifs sont automatiquement associés à la fiche d'invitation. Vous voyez d'un coup d'œil quels messages sont programmés et quand ils partiront.

Si vous partagez le lien du guide via Homhero (Étape 8)

Vous voyez quand même une fiche d'invitation créée pour chaque réservation, mais aucun modèle de message n'y est associé. Le lien du guide est envoyé depuis Homhero à la place : le Centre de messages se contente donc d'en garder une trace.

Suivre l'engagement des voyageurs

Dès qu'un voyageur ouvre son lien de guide, la fiche d'invitation se met à jour et affiche :

  • Dernière consultation : date à laquelle le voyageur a ouvert le guide pour la dernière fois

  • Vues : nombre de fois où le voyageur a ouvert le guide

C'est un bon moyen de vérifier si les voyageurs ont réellement consulté le guide avant leur arrivée.

Personnaliser vos colonnes

Par défaut, vous voyez les colonnes les plus courantes, mais vous pouvez en ajouter d'autres selon votre façon de travailler. Cliquez sur l'icône ⋮ dans le coin supérieur droit du tableau Invitations, puis sélectionnez Choisir les colonnes.

Choose Columns

Source de réservation

Si vous ajoutez la colonne Source de réservation, vous voyez d'un coup d'œil d'où vient chaque réservation : Airbnb, Booking.com, direct, etc.

Copier le lien du guide d'un voyageur

Besoin de partager un lien de guide directement avec un voyageur ? Cliquez sur l'icône ⋮ sur une ligne d'invitation et sélectionnez Copier le lien. Vous pouvez ensuite le coller dans n'importe quel message ou e-mail.

Copy link

FAQ

Pourquoi mon nouveau logement ne partage-t-il pas le lien du guide avec les réservations ?

Il y a quelques raisons courantes à cela :

Association non effectuée

Chaque fois que vous ajoutez une nouvelle annonce à votre compte Homhero, vous devez effectuer les étapes d'association et de synchronisation dans Touch Stay pour qu'elle partage automatiquement les liens du guide.
👉 Étape 3. Associer les logements Homhero

Synchronisation non activée
Si le lien du guide n'est pas renvoyé vers Homhero, vérifiez d'abord que la synchronisation est activée pour le logement.

  1. Accédez à Intégrations.

  2. Ouvrez l'onglet Synchroniser les réservations.

  3. Vérifiez que le logement est sélectionné pour la synchronisation.

💬 Le lien n'apparaît toujours pas ?

Si vous avez suivi les étapes ci-dessus et que le lien reste introuvable, écrivez à [email protected] en indiquant :

  • Votre adresse e-mail de connexion

  • Nom du guide

  • Date d'arrivée du voyageur

  • ID de réservation Homhero

Ces informations aident notre équipe à analyser rapidement le problème.


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