> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Hostaway

Avec l'[outil webhook](/docs/fr/reception-ai/integrations/webhooks) ci-dessous, votre réceptionniste peut consulter le calendrier d'une annonce Hostaway aux dates demandées par un appelant et lui indiquer si le chalet ou le logement est disponible, le tarif à la nuitée et le séjour minimum. L'API publique de Hostaway délivre un jeton d'accès valable 24 mois, l'outil appelle donc Hostaway directement.

> **Note**
>
> Votre réceptionniste ne peut pas créer de réservations ni rechercher des réservations existantes. Il consulte le calendrier et
> prend la demande de réservation, puis votre équipe confirme le séjour à partir du [résumé post-appel](/docs/fr/reception-ai/features/notifications).

## Avant de commencer

### Créer une clé API

Dans le Dashboard Hostaway, ouvrez **Settings** → **Hostaway API** et créez une clé API. Nommez-la `Reception.ai` et choisissez **Hostaway Public API** comme partenaire. Copiez la clé : Hostaway ne l'affiche qu'une seule fois. Notez votre **Account ID**, également affiché dans **Settings**.

### Obtenir un jeton d'accès

Échangez la clé contre un jeton d'accès dans un terminal, en remplaçant `ACCOUNT_ID` et `API_KEY` :

```bash
curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'
```

Copiez la valeur `access_token` de la réponse. Elle est valable 24 mois.

> **Warning**
>
> Le jeton d'accès peut lire et modifier l'ensemble de votre compte Hostaway, y compris les coordonnées des clients
> et les codes de porte. Ne le collez pas dans des documents partagés ou des outils en ligne. En cas de fuite, révoquez-le et
> supprimez la clé API dans Hostaway.

### Trouver les ID de vos annonces

Répertoriez vos annonces à l'aide du jeton, en remplaçant `YOUR_TOKEN` :

```bash
curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'
```

Chaque annonce dans la réponse possède un `id` et un `name`. Notez l'ID de chaque annonce que votre réceptionniste doit consulter.

## Créer l'outil

Accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**.

| Champ                     | Valeur                                                                                                                                                                                                                |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                   | `check_hostaway_calendar`                                                                                                                                                                                             |
| **Description**           | "Vérifiez si l'une de nos locations est disponible aux dates de l'appelant, ainsi que le tarif à la nuitée et le séjour minimum. Utilisez cet outil avant d'indiquer à l'appelant qu'une location est disponible."    |
| **Méthode**               | GET                                                                                                                                                                                                                   |
| **URL**                   | `https://api.hostaway.com/v1/listings/{listing_id}/calendar`                                                                                                                                                          |
| **En-têtes de requête**   | `Authorization`: `Bearer ` suivi de votre jeton d'accès, avec le **Type** défini sur **Secret**                                                                                                                       |
| **Paramètres de chemin**  | `listing_id` (chaîne, obligatoire) : "Utilisez `11111` pour le chalet Cedar et `22222` pour le chalet Lakeside."                                                                                                      |
| **Paramètres de requête** | `startDate` (chaîne, obligatoire) : "La date d'arrivée, au format AAAA-MM-JJ."  `endDate` (chaîne, obligatoire) : "La dernière nuit du séjour, au format AAAA-MM-JJ."  `includeResources` (chaîne, valeur fixe) : `0` |
| **Attribuer aux agents**  | **Receptionist**                                                                                                                                                                                                      |

Remplacez les noms et les ID des chalets par les vôtres, puis ajoutez une ligne par annonce. Sélectionnez **Enable**.

Hostaway renvoie une entrée par nuit. Une nuit est disponible lorsque `status` est défini sur `available`. Chaque nuit comporte également son `price` et son `minimumStay`.

> **Warning**
>
> Conservez `includeResources` fixé à `0`. Avec `1`, Hostaway ajoute les réservations de chaque nuit,
> y compris les noms, numéros de téléphone et emails des clients, à ce que voit votre réceptionniste.

### Tester

[Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en demandant un chalet à des dates que vous savez réservées, puis à des dates que vous savez disponibles. Comparez les réponses avec votre calendrier Hostaway.

> **Tip**
>
> Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) pour les demandes de séjour : demandez la
> location, les dates d'arrivée et de départ, ainsi que le nombre de voyageurs, consultez le calendrier, puis recueillez le
> nom, le numéro de téléphone et l'email de l'appelant pour votre équipe. Ajoutez une règle précisant que votre réceptionniste ne
> promet jamais qu'un séjour est réservé.

## Limites

* Votre réceptionniste ne peut pas créer, modifier ou annuler de réservations. Votre équipe confirme chaque séjour.
* Il consulte une annonce à la fois. Pour suggérer un autre chalet, il les consulte l'un après l'autre.
* Les tarifs à la nuitée n'incluent pas les frais de ménage, les taxes ni les réductions. Votre réceptionniste doit donc les communiquer à titre indicatif uniquement.
* L'outil ne recherche pas les réservations existantes. Les fiches de réservation et d'annonce Hostaway contiennent des codes de porte et des mots de passe Wi-Fi. Ce guide ne les met donc pas à la disposition de votre réceptionniste. L'application Hostaway de Zapier renvoie les mêmes fiches et ne propose aucune action de réservation ou de disponibilité.
* Votre jeton d'accès cesse de fonctionner après 24 mois. Créez-en un nouveau et mettez à jour l'en-tête avant cette échéance.

## Résolution des problèmes

| Problème                                       | Vérification à effectuer                                                                                                               |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Erreur 401 ou 403 de Hostaway                  | La valeur de l'en-tête doit être `Bearer`, suivi d'un espace et du jeton d'accès, et non de la clé API. Vérifiez qu'il n'a pas expiré. |
| Le mauvais chalet est consulté                 | Vérifiez que les ID d'annonce dans la description de `listing_id` correspondent à vos annonces.                                        |
| Une nuit réservée apparaît comme disponible    | Vérifiez le calendrier dans Hostaway. Les nuits bloquées et réservées ont un `status` différent de `available`.                        |
| Le réceptionniste propose un séjour trop court | Indiquez-lui dans la description de l'outil de vérifier `minimumStay` pour la nuit d'arrivée.                                          |