Intégration Guesty — Synchroniser vos biens, propriétaires et réservations

Ce que vous allez faire : connecter votre compte Guesty à Unlocker pour importer automatiquement vos biens, propriétaires et réservations.

🔎 Vous utilisez Hostaway ? Suivez plutôt le guide Intégration Hostaway.

Prérequis

• Votre compte Unlocker est actif et votre enrôlement est validé
• Vous avez le rôle Gestionnaire ou Administrateur
• Vous disposez d'une clé d'API Guesty

1. Accéder à la Marketplace

1. Ouvrez Paramètres depuis votre menu utilisateur (ou via le lien Marketplace directement dans le menu)
2. Dans la barre latérale, cliquez sur Marketplace

Vous voyez la liste des intégrations disponibles. Chaque vignette indique :

• Le type d'intégration : PMS, Courte durée…
• L'état de connexion : Connecté (pastille verte) ou Non connecté (pastille grise)

💡 Utilisez les filtres Tous / PMS / Courte durée ou la barre de recherche pour retrouver rapidement Guesty.

2. Activer l'intégration Guesty

1. Cliquez sur Activer l'intégration → sur la vignette Guesty
2. Collez votre clé d'API Guesty (le token d'intégration) dans le champ dédié
3. Cliquez sur Activer

ℹ️ Où trouver votre clé d'API Guesty ?
Dans Guesty, ouvrez l'espace API / Intégrations de vos paramètres et générez une clé dédiée à Unlocker (ne la partagez avec aucun autre outil). En cas de doute, consultez la documentation Guesty ou contactez son support.

⚠️ Les clés Guesty ont une durée de validité limitée (1 an par défaut). Notez la date d'expiration : à son échéance, la synchronisation s'arrêtera avec une erreur d'authentification.

Un message de succès s'affiche et l'intégration passe à l'état Connecté.

3. Configurer la synchronisation

Une fois connectée, la page de détail affiche deux onglets : Paramètres et Historique.

Les réglages disponibles

• Token d'intégration — masqué par défaut. Utilisez Modifier le token pour le remplacer (par exemple après expiration).
• Import automatique — si activé, les éléments sans doublon probable sont importés sans validation manuelle. Les cas ambigus restent en attente de décision.
• Synchronisation automatique — si activée, Unlocker récupère les nouveautés de Guesty toutes les 5 minutes en arrière-plan.
• Forcer une synchronisation — déclenche une récupération immédiate. Utile après un changement important côté Guesty.

🧭 Import automatique : ON ou OFF ?

• ON (recommandé pour un portefeuille stable) — laissez Unlocker faire, ne validez que les doublons probables.
• OFF (recommandé pour une première mise en place) — vous validez chaque import pour rester maître des décisions.

4. Suivre la progression d'une synchronisation

Pendant et après l'exécution, la carte Progression de la synchronisation détaille l'opération en cours :

• Progression globale en pourcentage
• Statut : En cours, Terminée, Terminée avec erreurs, Échouée
• Pour chaque type de donnée (Propriétaires, Biens, Réservations…) :
• Récupérés — nombre d'éléments reçus de Guesty
• Traités — nombre analysés par Unlocker
• Erreurs — cas bloquants
• En attente — éléments en attente d'une décision de votre part
• Durée — temps d'exécution

La date et l'heure de fin sont affichées sous le tableau.

5. Prendre vos décisions d'import

Lorsqu'un élément ressemble à un bien déjà présent dans Unlocker, il est marqué "Probable doublon" et remonte dans la section Décisions d'import.

Pour chaque élément, vous voyez :

• Deux cartes côte à côte : Guesty (l'élément à importer) vs Existant (votre bien actuel)
• Un score de similarité sur 100
• Trois actions : Fusionner, Créer nouveau, Exclure

Comprendre le score

Cliquez sur Voir le détail du score pour voir comment il a été calculé :

Un bien n'est remonté comme doublon probable que si son score atteint 40 pts minimum.

Choisir l'action

• Fusionner — le bien Unlocker existant est enrichi avec les données Guesty (référence, identifiant externe). Aucun doublon n'est créé.
• Créer nouveau — un nouveau bien est ajouté dans Unlocker, même si un doublon est probable.
• Exclure — l'élément est ignoré définitivement pour cette synchronisation. Il ne sera plus proposé.

Regroupement par propriétaire

Les décisions sont groupées par propriétaire pour vous donner une vue d'ensemble : résidences, biens enfants, statut "Déjà importé"…

Utilisez Tout importer / Tout exclure au niveau d'un propriétaire pour appliquer la même action à toutes ses dépendances en un clic.

Appliquer les décisions

Une fois toutes les décisions prises, le message "Toutes les décisions sont prises" s'affiche en bas. Cliquez alors sur Appliquer les décisions.

⚠️ Action irréversible — vérifiez vos choix avant d'appliquer. Les éléments exclus ne pourront pas être re-proposés sans désactiver puis réactiver l'intégration.

6. Consulter l'historique

L'onglet Historique liste toutes vos sessions de synchronisation passées, avec pour chacune :

• La date et la durée
• Le statut global (Terminée, Échouée…)
• Le détail de chaque élément synchronisé : type (Bien, Propriétaire, Résidence, Document, Réservation), nom, décision finale (Importé, Fusionné, Créé, Déjà importé, Exclu…)

C'est votre journal d'audit : vous pouvez à tout moment voir ce qui a été importé, par qui et pour quel résultat.

Résultat attendu

• Vos biens, propriétaires et résidences Guesty apparaissent dans les listes correspondantes dans Unlocker
• Les réservations remontées par Guesty sont créées automatiquement
• Toute nouvelle donnée dans Guesty est synchronisée toutes les 5 minutes (si sync auto activée)
• Les doublons sont filtrés intelligemment pour éviter les créations en double

Problèmes fréquents

• Clé d'API refusée à l'activation — vérifiez qu'elle est active dans Guesty et qu'elle n'a pas expiré (1 an de validité par défaut).
• Erreur d'authentification à la synchronisation — la clé a probablement expiré. Ouvrez le détail de l'intégration et cliquez sur Modifier le token pour en fournir une nouvelle.
• Biens bloqués en "attente de décision" — ouvrez le détail de l'intégration et appliquez les décisions dans la section Décisions d'import.
• Un bien n'est pas remonté — vérifiez qu'il est bien actif dans Guesty, puis cliquez sur Forcer une synchronisation.
• Score à 90 ou 95 /100 mais pas 100 — c'est normal : les points manquants correspondent souvent au critère "Propriétaire" quand le propriétaire Guesty n'est pas encore relié à un propriétaire Unlocker existant.

Désactiver l'intégration

1. Ouvrez le détail de l'intégration
2. Cliquez sur le bouton Désactiver en haut à droite
3. Confirmez dans la modale

Les données déjà importées restent en place dans Unlocker — la désactivation coupe uniquement la synchronisation future. Pour réactiver, il suffira de renseigner à nouveau une clé valide.

Besoin d'aide ? Contactez le support via le chat Crisp en bas à droite de l'application.

Mis à jour le : 27/07/2026