Intégration Hostaway — Synchroniser vos biens

Ce que vous allez faire : connecter votre compte Hostaway à Unlocker pour importer vos biens (listings) et les rattacher à leurs propriétaires.

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

Prérequis

• Votre compte Unlocker est actif et votre enrôlement est validé
• Vous avez le rôle Gestionnaire ou Administrateur
• Vous avez accès au tableau de bord Hostaway avec les droits permettant de générer une clé d'API

1. Récupérer vos identifiants API Hostaway

Contrairement à la plupart des PMS, Hostaway demande deux informations :

• un Identifiant de compte (Account ID)
• une Clé API (secret)

Dans Hostaway, Allez dans Marketplace → Recherchez "Unlocker" → "Create API key". La documentation officielle détaille la marche à suivre : API publique Hostaway — Clé de compte et clé secrète.

⚠️ La clé secrète n'est affichée qu'une seule fois. Copiez-la immédiatement et conservez-la en lieu sûr (gestionnaire de mots de passe). Si vous la perdez, il faudra en générer une nouvelle.

💡 Générez une clé dédiée à Unlocker : vous pourrez la révoquer sans impacter vos autres intégrations.

2. Accéder à la Marketplace Unlocker

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
3. Repérez la vignette Hostaway (type PMS)

3. Activer l'intégration Hostaway

1. Cliquez sur Activer l'intégration → sur la vignette Hostaway
2. Renseignez l'Identifiant de compte (Account ID)
3. Renseignez la Clé API (secret)
4. Cliquez sur Activer

Un message « Intégration activée avec succès » s'affiche, l'intégration passe à l'état Connecté et une première synchronisation est déclenchée.

ℹ️ Les deux champs sont obligatoires. Une erreur à l'activation signifie presque toujours que l'Account ID et la clé ne proviennent pas de la même paire — regénérez-les ensemble depuis Hostaway.

4. 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 remplacer l'Account ID et la clé (par exemple après une régénération côté Hostaway).
• Import automatique — importe sans validation manuelle les éléments sans ambiguïté.
• Synchronisation automatique — Unlocker récupère les nouveautés Hostaway 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é Hostaway.

🧭 Import automatique et Hostaway
Hostaway n'expose aucune source fiable de propriétaire (pas de liste de propriétaires dans son API ; l'e-mail de contact d'un listing est un contact voyageur, souvent le gestionnaire). Unlocker ne fabrique donc jamais de propriétaire à partir de ces données.

Conséquence : même avec l'import automatique activé, vos biens Hostaway resteront systématiquement en attente de décision, le temps que vous leur désigniez un propriétaire. C'est volontaire — c'est ce qui garantit qu'aucun bien n'est rattaché au mauvais propriétaire.

5. Suivre la progression d'une synchronisation

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

• Progression globale en pourcentage
• Statut : En cours, Terminée, Terminée avec erreurs, Échouée
• Pour chaque type de donnée :
• Récupérés — nombre d'éléments reçus de Hostaway
• 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 ligne Propriétaires affiche toujours 0 pour Hostaway — voir l'explication ci-dessus. La ligne Biens est celle à surveiller : ses éléments En attente sont ceux à traiter dans Décisions d'import.

6. Prendre vos décisions d'import

Chaque bien remonté par Hostaway apparaît dans la section Décisions d'import, avec son nom, sa ville et son type.

Pour chaque bien, vous devez renseigner :

1) L'association (facultatif) — « Fusionner avec un lot existant »
Recherchez un lot déjà présent dans Unlocker pour éviter un doublon. Laissez vide si le bien est nouveau.

2) Le propriétaire (obligatoire)
Choisissez Propriétaire (personne physique) ou Société, puis recherchez-le dans Unlocker. C'est l'information que Hostaway ne fournit pas : elle est toujours à votre main.

3) L'action

• Associer — rattache le bien Hostaway au lot existant sélectionné. Aucun doublon n'est créé.
• Créer nouveau — crée un nouveau bien dans Unlocker, rattaché au propriétaire choisi.
• Exclure — ignore définitivement cet élément. Il ne sera plus proposé.

Appliquer les décisions

Le compteur en haut (par exemple 3/3) indique combien d'éléments sont traités. Tant qu'un bien n'a ni propriétaire ni exclusion, le bandeau du bas affiche « 1 lot sans propriétaire sélectionné — choisissez-en un ou excluez le lot » et le bouton reste inactif.

Une fois tout renseigné, cliquez 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.

7. 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, 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é et pour quel résultat.

Résultat attendu

• Vos listings Hostaway apparaissent comme biens dans Unlocker, rattachés au propriétaire que vous avez désigné
• Toute nouvelle donnée dans Hostaway est récupérée toutes les 5 minutes (si sync auto activée), et vous êtes invité à trancher les nouveaux biens
• Aucun bien n'est créé en double dès lors que vous utilisez Fusionner avec un lot existant

Problèmes fréquents

• Activation refusée — l'Account ID et la clé secrète doivent provenir de la même génération. Regénérez une paire complète dans Hostaway et utilisez Modifier le token.
• Clé perdue — la clé secrète Hostaway n'est visible qu'une seule fois. Générez-en une nouvelle et mettez-la à jour dans Unlocker via Modifier le token.
• Ligne « Propriétaires » à 0 — c'est normal, Hostaway ne fournit pas de propriétaires. Rien à corriger.
• Mes biens restent « en attente de décision » malgré l'import automatique — c'est le fonctionnement attendu pour Hostaway : un propriétaire doit être désigné manuellement.
• Un bien n'est pas remonté — vérifiez qu'il est actif dans Hostaway, puis cliquez sur Forcer une synchronisation.

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 un Account ID et une clé valides.

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

Mis à jour le : 01/08/2026