Intégrations & Marketplace — Synchroniser vos biens depuis votre PMS / Channel manager

Ce que vous allez faire : connecter votre PMS (Guesty, Hostaway, Lodgify, Biloki…) à Unlocker pour importer automatiquement vos biens, propriétaires et réservations.

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 fournie par votre PMS

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 votre outil.

2. Activer une intégration

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

ℹ️ Où trouver votre Clé d'API?
Chaque PMS expose un espace "API" ou "Intégrations" dans ses paramètres. Générez une clé dédié à Unlocker (ne le partagez avec aucun autre outil). En cas de doute, consultez la documentation de votre PMS ou contactez son support.

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 votre PMS 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é PMS.

🧭 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 du PMS
• 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 PMS (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 apparaissent dans les listes correspondantes dans Unlocker
• Les réservations remontées par votre PMS sont créées automatiquement
• Toute nouvelle donnée dans votre PMS 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'il est actif dans votre PMS et qu'il n'a pas expiré. Certains PMS ont une durée de validité limitée (1 an par défaut pour Guesty).
• Erreur d'authentification à la synchronisation — la clé a probablement expiré. Ouvrez le détail de l'intégration et cliquez sur Renouveler pour en fournir un nouveau.
• 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 votre PMS, puis cliquez sur Forcer une synchronisation.
• Score à 90 ou 95 /100 mais pas 100 — c'est normal : les 10 pts manquants correspondent souvent au critère "Propriétaire" quand le propriétaire PMS n'est pas encore relié à un propriétaire Unlocker existant.

Désactiver une 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 un token valide.

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

Mis à jour le : 21/04/2026