Passer au contenu principal

Intégration Homhero

Configurez l'intégration Homhero avec Touch Stay. Découvrez comment fonctionnent l'importation des logements, la synchronisation des réservations, le mappage des codes de champ, les invitations des invités et la mise à jour des guides une fois 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 étape par étape comment configurer l'intégration.

Table des matières :


Étape 1. Obtenez vos identifiants d'API Homhero

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

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

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

  3. Activez l'interrupteur Active

  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. Connectez Homhero à Touch Stay

Une fois votre Key et votre Password copiés depuis Homhero, revenez dans Touch Stay pour finaliser la connexion.

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

  2. Trouvez Homhero et cliquez sur Connecter (Connect).

  3. Collez votre Key dans Clé d'intégration Homhero (Homhero integration key) et votre Password dans Secret du jeton Homhero (Homhero token secret).

  4. Cliquez sur Enregistrer (Save).


Étape 3. Associez les logements Homhero

Si vous avez déjà des guides dans Touch Stay, vous allez maintenant les associer aux bons logements 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 le temps de vérifier vos associations avant de continuer. Vous vous assurez ainsi que les bonnes informations de logement et les bonnes réservations sont synchronisées avec le bon guide.

Vous n'avez aucun guide à associer ?

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


Étape 4. Importez les logements Homhero

Si certains logements Homhero n'ont pas été associés à un guide Touch Stay existant, vous pouvez les importer en tant que 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 :

  • Le nom du logement

  • L'adresse du logement

  • L'emplacement du logement

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


Étape 5. Finalisez la création de vos guides (nouveaux clients Touch Stay uniquement)

Avant d'activer la synchronisation, prenez le temps de relire vos guides et de vérifier que tout est prêt à être partagé avec les voyageurs. Vérifiez notamment :

  • Le contenu du guide

  • Les informations sur le logement

  • Les instructions d'arrivée

  • Les coordonnées

  • Les images et l'image de marque

💡 Vous débutez avec Touch Stay ?

Regardez notre Vidéo de démarrage rapide pour découvrir des conseils utiles et créer votre livret d'accueil numérique le plus rapidement possible.


É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 configuration supplémentaire. Vous pouvez ainsi personnaliser vos guides et vos messages aux voyageurs avec des informations comme :

  • Le nom des voyageurs

  • Les dates d'arrivée et de départ

  • Les heures d'arrivée et de départ

Champs mis en correspondance automatiquement

Les champs suivants sont prêts à l'emploi 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'adresse e-mail dépend de la plateforme OTA utilisée par le voyageur pour réserver.

💡 Pour en savoir plus, consultez Les codes de champ expliqués

Vous voulez synchroniser plus de données sur vos logements ?

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


Étape 7. Synchronisez 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). Dans l'ancien Hub, il s'appelle Sync reservations.

  3. Choisissez comment importer les réservations :

    • All reservations (toutes les réservations) : recommandé si vous débutez avec Touch Stay. Importe toutes les réservations futures de 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 (Message Hub). N'importe que les réservations créées après l'activation de la synchronisation, ce qui permet d'éviter les invitations en double.

  4. Sélectionnez le ou les guides à synchroniser — Tout sélectionner (Select all) se trouve en haut, à côté de 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 synchronisation initiale peut prendre quelques minutes, selon le nombre de logements et de réservations à importer. 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 que vous le connectez à un logement Homhero, vous devez aussi activer la synchronisation pour ce guide. Sans synchronisation, les réservations ne sont pas importées et aucun lien d'invitation n'est créé pour les voyageurs qui séjournent dans ce logement.


Étape 8. Partagez les liens de 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 (merge fields) de Homhero.

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

Utilisez 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é, propre à sa réservation.

  • Pour créer un nouveau message automatique 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 de l'aide supplémentaire sur la création de messages automatiques dans Homhero, contactez l'assistance Homhero.

Remarque importante sur le moment d'envoi des messages Homhero

Il peut y avoir un léger délai entre la réception d'une réservation dans Homhero et la génération du Touch Stay Guide Link, puis sa synchronisation dans Homhero.

⚠️ Important
N'incluez pas le Touch Stay Guide Link dans les messages envoyés immédiatement après la réception d'une réservation. Envoyez plutôt votre message contenant le guide au moins 1 heure plus tard, voire le lendemain, pour être sûr que le lien de guide personnalisé est prêt.


Bonnes pratiques pour partager votre guide

Nous recommandons le calendrier de messages suivant pour offrir la meilleure expérience à vos voyageurs :

Après la confirmation de la réservation

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

  • Pourquoi : Touch Stay a ainsi le temps de générer le lien de guide personnalisé avant son envoi.

Avant l'arrivée

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

  • Pourquoi : 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 voulez passer du Centre de messages à Homhero pour envoyer les liens de guide :

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

  2. Configurez votre nouveau parcours de messages dans 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. Ce que vous verrez dans le Centre de messages

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

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

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

  • Nom (Name), E-mail (Email) et Téléphone (Phone) du voyageur

  • Date d'arrivée (Arrival Date)

  • Date de création (Created Date) : date de génération de la fiche d'invitation

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

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

Liste des invitations

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)

Une fiche d'invitation est toujours créée pour chaque réservation, mais aucun modèle de message n'y est associé. Le lien du guide est envoyé depuis Homhero : le Centre de messages se contente d'en garder une trace.

Suivre l'engagement des voyageurs

Dès qu'un voyageur ouvre le lien de son guide, la fiche d'invitation est mise à 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, les colonnes les plus courantes s'affichent, mais vous pouvez en ajouter d'autres selon votre façon de travailler. Cliquez sur l'icône ⋮ en haut à droite du tableau des invitations et sélectionnez Choisir les colonnes (Choose Columns).

Choisir les colonnes

Source de réservation

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

Copier le lien du guide d'un voyageur

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

Copier le lien

FAQ

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

Il y a deux raisons fréquentes :

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 que les liens de guide soient partagés automatiquement.
👉 Étape 3. Associez les logements Homhero

Synchronisation non activée
Si le lien de votre 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 est toujours absent, envoyez un e-mail à [email protected] en indiquant :

  • Votre adresse e-mail de connexion

  • Le nom du guide

  • La date d'arrivée du voyageur

  • L'identifiant de la réservation Homhero

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


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