# Connecter Hostaway

Une fois Hostaway connecté, chaque réservation (Airbnb, Booking.com, Vrbo, en direct …) est importée automatiquement dans votre portail voyageurs : dates, nombre de voyageurs, nom et coordonnées du voyageur. Les annulations et les changements de dates suivent. Vos données de check-in, paiements et notes ne sont jamais écrasés par l'import.

## 1. Créer une clé API Hostaway

1. Connectez-vous à votre tableau de bord Hostaway.
2. Ouvrez **Settings → Hostaway API**.
3. Cliquez sur **Create** pour ajouter une nouvelle clé API, donnez-lui un nom (par exemple *Guest portal*) et enregistrez.
4. Copiez l'**Account ID** et l'**API key** (Hostaway l'appelle le client secret). La clé ne s'affiche qu'une seule fois.

## 2. Connecter Hostaway dans votre tableau de bord

1. Ouvrez **Settings → Channels → Hostaway**.
2. Collez l'**Account ID** et l'**API key (client secret)**.
3. Laissez **API base URL** vide — `https://api.hostaway.com/v1` est alors utilisé. Ne le remplissez que pour utiliser un point de terminaison compatible Hostaway (par exemple un point de terminaison CodeB) ; il doit s'agir d'une adresse https publique.
4. Cochez **Enabled** et cliquez sur **Test** (l'enregistrement se fait d'abord). Vous devriez voir *Hostaway: connected*.

![Settings → Channels](/site/img/docs/d-settings-channels.webp "Settings → Channels")

## 3. Lier vos logements

1. Cliquez sur **Show listings** dans la carte Hostaway. Vous voyez chaque annonce avec son identifiant et si elle est déjà liée.
2. **Nouveau sur le portail voyageurs ?** Laissez les annonces cochées et cliquez sur **Add selected as properties**. Chaque annonce devient un logement avec son nom, son adresse, sa ville, son pays, son fuseau horaire et ses heures d'arrivée / de départ issus de Hostaway ; elle est liée et ses réservations sont importées immédiatement.
3. **Vous avez déjà créé un logement à la main ?** Décochez cette annonce (elle est décochée automatiquement lorsqu'un logement porte le même nom) et collez plutôt l'identifiant de l'annonce dans **Settings → Properties → Settings → Hostaway listing ID**, pour éviter un doublon.

![Show listings : cochez les annonces à ajouter — les annonces liées et les logements de même nom sont reconnus](/site/img/docs/d-channels-listings.webp "Show listings : cochez les annonces à ajouter — les annonces liées et les logements de même nom sont reconnus")

La carte affiche la progression et le tableau de bord s'actualise de lui-même lorsque les réservations sont arrivées. Les **photos** des annonces sont aussi importées (jusqu'à 12 par logement, stockées sur le serveur propre du portail voyageurs) ; la première devient la photo de couverture. Choisissez une autre couverture dans **Guide editor → Property & welcome → Photos from Hostaway**. Pour les logements liés auparavant, cliquez sur **Import photos** dans la carte Hostaway — seules les photos manquantes sont récupérées, vous pouvez donc cliquer à nouveau sans risque (par exemple après un redémarrage du serveur).

![Pendant l'import des réservations, la carte affiche la progression et actualise le tableau de bord une fois terminé](/site/img/docs/d-channels-progress.webp "Pendant l'import des réservations, la carte affiche la progression et actualise le tableau de bord une fois terminé")

Complétez ensuite chaque logement : Wi-Fi, codes d'accès, licence MTA, taxe de séjour et paiements.

## 4. Importer

Cliquez sur **Import now** pour récupérer immédiatement les réservations. Ensuite, les imports s'exécutent automatiquement toutes les 30 minutes pour les séjours allant de 30 jours en arrière jusqu'à environ 18 mois à l'avance.

### Mises à jour instantanées (webhook)

Au lieu d'attendre jusqu'à 30 minutes le prochain import, Hostaway peut informer le portail voyageurs des réservations nouvelles ou modifiées en quelques secondes :

1. Dans **Settings → Channels → Hostaway**, cliquez sur **Set up instant updates** puis sur **Copy** pour copier l'adresse.
2. Dans le tableau de bord Hostaway, ouvrez **Settings → Integrations → Webhooks** (unified webhooks), ajoutez un webhook avec cette URL et enregistrez. Laissez l'identifiant et le mot de passe vides — l'adresse elle-même fait office de clé.
3. La carte indique quand Hostaway a appelé pour la dernière fois et ce qui s'est passé. L'import régulier continue de tourner comme filet de sécurité.

![Mises à jour instantanées : l'adresse secrète du webhook et le dernier appel](/site/img/docs/d-channels-instant.webp "Mises à jour instantanées : l'adresse secrète du webhook et le dernier appel")

L'adresse est secrète : toute personne qui la possède peut demander au portail voyageurs de revérifier une réservation (la réservation elle-même est toujours récupérée depuis Hostaway avec votre clé API). **New address** la remplace si elle venait à fuiter — collez alors la nouvelle adresse dans Hostaway.

## 5. Inviter les voyageurs

Les réservations importées reçoivent immédiatement leur propre lien de portail. Vous pouvez l'envoyer :

- par e-mail depuis la réservation (**Email portal link to guest**) ;
- **dans le chat du canal** — **Send portal link via Airbnb** (ou Booking.com, Vrbo …) dans la réservation. Le message passe par Hostaway et arrive dans la messagerie du voyageur sur la plateforme où il a réservé ;
- automatiquement quelques jours avant l'arrivée : **Settings → Email** — *Email the portal link to new guests automatically* et/ou *Also send it through the booking channel's chat*.

## 6. Écrire aux voyageurs

La section **Messages** de la réservation affiche la conversation issue de Hostaway (messages du voyageur et les vôtres) et vous permet de répondre dans le chat du canal. Les messages sont envoyés exactement tels qu'ils sont rédigés — les variables comme `[guest_name]` ne sont pas remplacées, si bien qu'un message qui en contient encore une est refusé. Détails : [E-mails et notifications](/docs/email-and-notifications).

## Questions fréquentes

### Quelles données viennent de Hostaway et lesquelles restent ici ?

Les demandes d'information, les demandes en attente ou non confirmées (par exemple une demande de réservation Vrbo), les demandes expirées ou refusées et les séjours du propriétaire ne sont pas importés — seulement les vrais séjours. Hostaway fait foi pour les dates, le statut, le nombre de voyageurs et les coordonnées issues de la réservation — sauf les nombres de voyageurs que vous avez corrigés dans la réservation (**Guests → Change**), que les imports suivants conservent. Les données du check-in en ligne, les paiements, le statut du dépôt de garantie, les codes d'accès et vos notes sont gérés dans le portail voyageurs et ne sont jamais écrasés.

### Comment mettre à jour les photos d'un seul logement ?

**Settings → Properties → Settings → Photos → Refresh photos** récupère les nouvelles photos, supprime celles que Hostaway ne liste plus et ne télécharge jamais deux fois la même photo. **Refresh and use the first as cover** réinitialise en plus la photo de couverture.

![Paramètres du logement : actualiser les photos d'un logement](/site/img/docs/d-property-photos.webp "Paramètres du logement : actualiser les photos d'un logement")

### Que se passe-t-il lorsqu'une réservation est annulée dans Hostaway ?

La réservation est marquée comme annulée lors de l'import suivant ; le portail voyageurs affiche l'annulation et les dates sont libérées.

### Certains voyageurs n'ont pas d'adresse e-mail ?

Les canaux masquent souvent la véritable adresse e-mail. Envoyez plutôt le lien du portail via le chat du canal — **Send portal link via …** dans la réservation, ou activez l'invitation automatique par chat dans **Settings → Email**.