Hostaway | ElevenLabs Documentation

Avec l’outil webhook 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.

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.

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 :

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.

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 :

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.

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

Ajoutez une procédure 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.