Passer au contenu principal
Votre assistant reconnaît les voyageurs, répond aux questions sur leur séjour et communique les informations d’arrivée depuis votre compte Hostaway. La connexion ne fait que lire : rien n’est créé, modifié ni annulé dans Hostaway. Exemple : à 22 h, un voyageur appelle : « Je suis devant la porte, quel est le code ? » L’assistant retrouve la réservation, vérifie qu’elle est confirmée et que le séjour commence demain ou est en cours, puis lit le code lentement.

Connecter votre compte

  1. Dans Hostaway, ouvrez Settings → Hostaway API et choisissez Create. Donnez le nom de votre choix et sélectionnez le partenaire Hostaway Public API. Hostaway n’affiche l’Account ID et l’API Key qu’une seule fois : copiez les deux avant de fermer la fenêtre.
  2. Ouvrez Agent Tools → Marketplace → Hostaway. Saisissez l’ID du compte et la clé API.
  3. Choisissez Ajouter. La connexion est vérifiée avant l’enregistrement, et le compte doit contenir au moins un logement. Associez ensuite la connexion à votre assistant.
Les clés Hostaway donnent toujours un accès complet au compte et ne peuvent pas être limitées à la lecture seule. Cette connexion ne fait que lire, mais gardez la clé confidentielle et révoquez-la dans Hostaway si elle est compromise.
Pour modifier le compte ou la clé plus tard, supprimez l’outil et reconnectez-le.

Ce que l’assistant peut faire

Activé par défaut :
  • Informations sur le logement : adresse, horaires d’arrivée et de départ en heure locale, règlement intérieur, capacité et équipements. Le Wi-Fi, les codes d’accès et les coordonnées du propriétaire n’en font pas partie.
  • Trouver une réservation : retrouve la réservation en cours ou à venir d’un voyageur avec son nom de famille et son code de réservation (code de confirmation Airbnb ou Booking.com, code d’un autre canal ou numéro de réservation Hostaway).
  • Détails de la réservation : statut, dates, horaires d’arrivée et de départ de la propre réservation de l’appelant.
  • Partager le Wi-Fi et Partager les codes d’accès : voir ci-dessous.
Facultatif, à choisir sous Modifier :
  • Disponibilité et prix : vérifie si un logement est libre pour des dates données et indique le prix. C’est un devis, pas une réservation.
Le règlement intérieur est lu à tous les appelants. Gardez les mots de passe Wi-Fi et les codes de boîte à clés dans les champs Wi-Fi et code d’accès de Hostaway, pas dans le règlement.

Reconnaître les appelants

Avant l’accueil, Famulor compare le numéro de l’appelant avec les séjours en cours ou qui commencent dans les 30 prochains jours. Avec une seule correspondance, l’assistant connaît le prénom, le logement, les dates, les horaires d’arrivée et le statut de la réservation sous forme de variables commençant par hostaway_, et peut accueillir le voyageur par son prénom. Voir Variables. Si le numéro correspond à plusieurs séjours, est partagé par plusieurs voyageurs ou n’apparaît pas dans Hostaway, l’assistant demande le nom de famille et le code de réservation et utilise Trouver une réservation. Les numéros masqués fonctionnent de la même façon. Pendant la conversation, Détails de la réservation retrouve aussi le séjour grâce au numéro de l’appelant.

Codes d’accès et Wi-Fi

L’assistant ne communique ces informations que pour les réservations confirmées, de la veille de l’arrivée au jour du départ, dans le fuseau horaire du logement. Les demandes, les séjours du propriétaire et les réservations annulées n’y ont jamais droit. Un voyageur qui appelle plus tôt apprend à partir de quel jour elles sont disponibles.
  • Le Wi-Fi est disponible lorsque le numéro de l’appelant correspond à exactement un séjour, ou après le nom de famille et le code de réservation.
  • Le code d’accès, la remise des clés et les consignes d’arrivée exigent en plus le nom de famille et le code de réservation. Après trois essais erronés dans une conversation, l’assistant arrête de vérifier. Chaque vérification échouée reçoit la même réponse : personne ne peut deviner si une réservation existe.
Vous désactivez l’un ou l’autre sous Modifier avec les outils Partager les codes d’accès et Partager le Wi-Fi. Les deux sont activés par défaut.

Ce qui reste inchangé dans Hostaway

Rien n’est créé, modifié ni annulé, et aucun message n’est envoyé à un voyageur. L’assistant lit les réservations, les logements et les prix.

Tester sans risque

Créez dans Hostaway une réservation de test et demandez-la à l’assistant avec le nom de famille et le code de réservation (Trouver une réservation). Une vraie conversation lit de vrais codes : utilisez un logement de test ou une réservation pour laquelle c’est autorisé.

Canaux

Au téléphone, l’assistant travaille avec le numéro depuis lequel on l’appelle. Dans le chat web, il n’y a pas de numéro : l’assistant demande donc le nom de famille et le code de réservation. WhatsApp et SMS reconnaissent les voyageurs par leur numéro de téléphone. Pour l’e-mail, c’est l’adresse d’expéditeur vérifiée qui compte.

Automatisations

Connectez Hostaway dans Automatisations → Connexions, ou importez sa connexion Agent Tools. Chaque outil est disponible comme action : Informations sur le logement, Trouver une réservation, Détails de la réservation, Partager le Wi-Fi, Partager les codes d’accès et Disponibilité et prix. Une automatisation déclenchée par un appel ou une conversation par texte (SMS, WhatsApp) connaît le numéro de l’interlocuteur grâce à cet appel lui-même. Les autres exécutions (webhook, planification) n’ont pas d’appelant : Détails de la réservation et Partager le Wi-Fi y nécessitent donc une Référence de la réservation issue d’une étape Trouver une réservation précédente.

API, MCP, CLI & SDK

POST /api/v1/tools/integrations/hostaway · MCP connect_integration · CLI famulor connect-integration hostaway. client.api.connectIntegration nécessite famulor-sdk 0.2.12 ou une version ultérieure. Mettez à jour la CLI avec npm install --global famulor avant d’utiliser connect-integration.

Limites

  • Hostaway limite les requêtes par compte et par adresse IP. Cette limite est partagée avec vos autres intégrations Hostaway : une forte activité ailleurs peut ralentir l’assistant.
  • Les comptes comptant plus de 300 séjours dans les 30 prochains jours risquent de ne pas être reconnus avant l’accueil. Au-delà de 500 séjours, le numéro de l’appelant ne suffit pas non plus pendant la conversation. L’assistant demande alors le nom de famille et le code de réservation.
  • Les prix sont indiqués dans la devise du logement.
  • Les clés et jetons Hostaway expirent après 24 mois. Créez une nouvelle clé et reconnectez le compte lorsque la connexion ne fonctionne plus.
Documentation de l’API Hostaway