> ## 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 Hostaway — Synchroniser vos biens # 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](https://help.unlocker.io/fr/article/integration-pms-channel-manager-u2vl3/). ## 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](https://support.hostaway.com/hc/fr/articles/360002576293-API-publique-Hostaway-Cl%C3%A9-de-compte-et-cl%C3%A9-secr%C3%A8te). ![Hostaway — clé secrète API générée](https://storage.crisp.chat/users/upload-1/plugin/-/5/a/7/0/5a701e783a179400/hostaway-cle-generee_14oz367.png) > ⚠️ **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`) ![Marketplace Unlocker — Guesty et Hostaway](https://storage.crisp.chat/users/upload-1/plugin/-/5/a/7/0/5a701e783a179400/marketplace-liste_5cresm.png) --- ## 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** ![Activer Hostaway — Account ID et clé API](https://storage.crisp.chat/users/upload-1/plugin/-/5/a/7/0/5a701e783a179400/hostaway-form-vide_gsgbfo.png) ![Activer Hostaway — champs renseignés](https://storage.crisp.chat/users/upload-1/plugin/-/5/a/7/0/5a701e783a179400/hostaway-form-rempli_nonl5i.png) 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**. ![Hostaway connecté — paramètres et progression de la synchronisation](https://storage.crisp.chat/users/upload-1/plugin/-/5/a/7/0/5a701e783a179400/hostaway-connecte-sync_1d2hzb6.png) ### 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. ![Décisions d'import — association et propriétaire](https://storage.crisp.chat/users/upload-1/plugin/-/5/a/7/0/5a701e783a179400/hostaway-decisions-import_4t5tvr.png) 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.*