> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.unlocker.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Intégration PMS / Channel manager # 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](https://help.unlocker.io/fr/article/integration-hostaway-synchroniser-vos-biens-1jgarrs/). ## 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) ![Marketplace — liste des intégrations](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2102_191vdab.png) > 💡 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** ![Saisie du token d'intégration](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2102_1sgphl5.png) > ℹ️ **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**. ![Page de détail — onglet Paramètres](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2102_6f0w6f.png) ### 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 de la synchronisation](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2111_1gzvdi3.png) * **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**. ![Décisions d'import — vue détaillée](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2050_el5zkc.png) 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é : ![Détail du score — 60/100](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2110_l4r78o.png) | Critère | Poids | | ---- | | Ville identique | 30 pts | | Adresse similaire (≥ 60 %) | 25 pts | | **Même propriétaire** | **30 pts** | | Même type de bien | 5 pts | | Nom similaire (≥ 50 %) | 10 pts | | **Total maximum** | **100 pts** | > 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é"… ![Décisions groupées par propriétaire](https://storage.crisp.chat/users/helpdesk/website/-/9/6/f/b/96fb39ed4153d80/capture-decran-2026-04-20-2050_pquab.png) 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.*