Intégration avec Beds24

Beds24 est un système de gestion hôtelière (PMS), channel manager et moteur de réservation dans le cloud utilisé par les hôtels, maisons d'hôtes et locations de vacances. Le connecter à ChatLab permet à votre chatbot de répondre aux questions sur les chambres, les dates et les tarifs à partir de vos données en direct de Beds24, plutôt qu'à partir de textes statiques que vous devez constamment mettre à jour.

Remarque : Beds24 nécessite la fonctionnalité d'intégration correspondante. Si votre forfait ne l'inclut pas, ouvrir la tuile Beds24 affiche une courte note contenant un lien pour nous contacter au lieu du formulaire de connexion.

Exemple de conversation

Cet exemple illustre l'expérience client. Les actions disponibles et les informations renvoyées dépendent de cette intégration et de votre configuration.

Ce que propose l'intégration

Une fois connecté, le chatbot bénéficie de trois actions de réservation. Une action distincte de AI room search (recherche de chambres par IA) est disponible lorsque le chatbot dispose de la capacité correspondante de recherche de chambres.

Beds24 - get properties (obtenir les hébergements) - liste chaque chambre et type de chambre de votre établissement. Pour chacun d'eux, le chatbot peut afficher le nom de la chambre, sa description, une photo, le nombre maximal d'adultes et d'enfants, ainsi que son prix de départ.

Beds24 - find available rooms (trouver les chambres disponibles) - le visiteur indique une plage de dates et le nombre de personnes, et le chatbot affiche les chambres libres pour ces dates, avec les tarifs et, si cela est configuré, un lien de réservation par chambre.

Beds24 - check room availability (vérifier la disponibilité d'une chambre) - le visiteur se renseigne sur une chambre précise. Le chatbot retrouve la chambre soit par son identifiant Beds24, soit par son nom, puis renvoie les disponibilités et les tarifs pour les dates demandées, accompagnés d'un lien de réservation.

Les dates sont comprises en langage naturel, de sorte qu'un visiteur peut écrire "le week-end prochain" ou "12-15 juin" plutôt que d'utiliser un format de date strict.

Avant de commencer

Vous avez besoin d'un chatbot auquel connecter l'intégration. Si vous n'en avez pas encore créé un, suivez d'abord Comment créer votre premier chatbot ChatLab.

Récupérez ensuite deux valeurs depuis Beds24 :

1. Code d'invitation (Invite code) - dans votre panneau de contrôle Beds24, allez dans Settings > Marketplace > API (Paramètres > Marketplace > API), générez un code d'invitation et sélectionnez les portées read:properties et read:inventory. Sélectionnez l'accès en lecture aux propriétés et à l'inventaire ; l'intégration ne crée pas de réservations dans Beds24. Consultez Authentification et portées de l'API Beds24.
2. ID de l'établissement (Property ID) - l'identifiant de l'établissement pour lequel vous souhaitez que le chatbot réponde.

Si vous le souhaitez, préparez une troisième valeur :

3. Format de l'URL de réservation - l'adresse de votre propre page de réservation, avec des variables que ChatLab remplit pour chaque réponse :

   • {roomId} - l'identifiant de chambre Beds24
   • {arrival} - date d'arrivée
   • {departure} - date de départ

   Par exemple :

   https://yourdomain.com/book?room={roomId}&arrival={arrival}&departure={departure}
   

   Si vous laissez ce champ vide, le chatbot répond toujours aux questions sur la disponibilité et les prix, mais il n'ajoute simplement aucun lien de réservation.

Étape 1 : Connecter Beds24

1. Sélectionnez votre chatbot et accédez à l'onglet Connect (Connecter).
2. Cliquez sur la vignette Beds24.

3. Collez votre Invite Code (code d'invitation), saisissez votre Property ID (identifiant de l'établissement) et, facultativement, le Booking URL format (format d'URL de réservation).

4. Cliquez sur Connect (Connecter).

ChatLab échange le code d'invitation contre un jeton d'accès et un jeton d'actualisation, les enregistre avec le bot, puis effectue un appel de test vers votre établissement Beds24. Si le code d'invitation est invalide ou expiré, ou si l'établissement ne peut pas être lu, l'intégration est désactivée et l'erreur s'affiche dans le formulaire, afin qu'une connexion défaillante ne reste jamais à moitié activée.

Le code d'invitation n'est utilisé que pendant cette étape. Une fois l'intégration connectée, le champ disparaît du formulaire et seuls Property ID et Booking URL format restent modifiables. ChatLab renouvelle automatiquement le jeton d'accès à l'aide du jeton d'actualisation, tant que les identifiants enregistrés restent valides. Une révocation ou une expiration peut nécessiter un nouveau code d'invitation.

Étape 2 : Vérifier les actions Beds24

La connexion active automatiquement les trois actions Beds24, afin que le chatbot soit prêt à répondre immédiatement. Pour les vérifier ou les ajuster, accédez à Settings > Actions (Paramètres > Actions) et consultez le groupe Beds24 Actions. Vous pouvez également cliquer sur Beds24 dans le panneau Filter by Platform (Filtrer par plateforme) situé à droite pour n'afficher que ce groupe :

• Beds24 - get properties - libellé d'action par défaut "Loading rooms..."
• Beds24 - find available rooms - libellé d'action par défaut "Checking availability..."
• Beds24 - check room availability - libellé d'action par défaut "Checking room..."

La capture d'écran ci-dessus montre le groupe avant la connexion de l'intégration : les actions de réservation ainsi que la recherche de chambres par IA (en option) sont listées, mais portent la mention Not connected (Non connecté) et restent indisponibles pour le chatbot. Les actions de réservation s'activent dès que la connexion est établie. La recherche de chambres par IA dépend du quota de chambres et de l'indexation automatique du catalogue ; son activation n'est pas garantie pour chaque connexion.

Pour chaque action, vous pouvez modifier :

• Action Label - le court message que le visiteur voit dans le chat pendant l'exécution de l'action.
• Instructions - la description de ce que fait l'action, sur laquelle l'IA s'appuie pour décider quand l'appeler.
• User Instructions - vos propres règles complémentaires, par exemple demander le nombre de clients avant de lancer la recherche, ou indiquer votre durée minimale de séjour.

Vous pouvez également désactiver une action individuelle si vous ne souhaitez pas l'utiliser. Par exemple, vous pouvez laisser la liste des chambres et la recherche de disponibilité actives, tout en désactivant la vérification d'une chambre individuelle.

L'action de recherche de disponibilité comprend également un paramètre pour le nombre de résultats : de 1 à 10 chambres, avec 5 par défaut. Cela limite la liste renvoyée ; une réponse ne constitue donc pas nécessairement une liste exhaustive de chaque chambre disponible.

Étape 3 : Tester l'intégration

Ouvrez Vue d'ensemble (Overview), démarrez une nouvelle conversation de test et essayez des questions correspondant à chaque action :

• « Quelles chambres proposez-vous ? » - déclenche Beds24 - get properties
• « Qu'est-ce qui est disponible du 12 au 15 juin de l'année prochaine pour 2 adultes ? » - déclenche Beds24 - find available rooms
• « La Deluxe Suite est-elle libre le week-end prochain ? » - déclenche Beds24 - check room availability

Vérifiez que les noms des chambres et les prix correspondent à vos données Beds24, et que les éventuels liens de réservation ouvrent votre page de réservation avec les dates déjà préremplies.

Gérer l'intégration

Mise à jour des paramètres - ouvrez la vignette Beds24 dans l'onglet Connect, modifiez l'identifiant Property ID ou le format Booking URL format, puis enregistrez. Vous n'avez pas besoin d'un nouveau code d'invitation pour cela.

Déconnexion - ouvrez la vignette Beds24 et cliquez sur déconnecter. Les trois actions Beds24 cesseront d'être accessibles au chatbot. Pour vous reconnecter ultérieurement, vous devrez générer un nouveau code d'invitation dans Beds24, l'ancien ayant déjà été utilisé.

Conseils

• Continuez d'entraîner votre bot sur le contenu de votre site web. Les actions Beds24 couvrent les chambres, les dates et les tarifs ; tout ce que le visiteur demande par ailleurs (petit-déjeuner, parking, horaires d'arrivée, animaux domestiques) provient de votre base de connaissances. Consultez Entraîner votre chatbot - principes de base et limites.
• Intégrez vos règles de réservation telles que la durée minimale de séjour ou la politique d'acompte dans les consignes utilisateur (user instructions) de l'action, afin que le chatbot les mentionne en même temps que la disponibilité, sans attendre que le client ne les découvre au moment du paiement.
• Ajoutez des suggestions de questions comme « Vérifier les disponibilités » ou « Voir les chambres » afin que les visiteurs découvrent ce que le chatbot peut faire.
• Chaque réponse qui fait appel à une action Beds24 consomme des crédits de message, comme toute autre réponse du chatbot. Consultez Qu'est-ce qu'un crédit de message.

Articles connexes

• Intégration avec Hotres
• Intégration avec IdoBooking
• Intégration avec KWHotel
• Entraîner votre chatbot - principes de base et limites
• Qu'est-ce qu'un crédit de message

Catalogue de chambres et aperçu de l'hôtel

Si votre compte affiche l'onglet Hotel (Hôtel), utilisez Hotel > Rooms (Hôtel > Chambres) pour consulter le catalogue de chambres et l'état d'entraînement. La fonction AI room search (recherche de chambres par IA) est distincte des vérifications de disponibilité basées sur les dates : elle fait correspondre les descriptions de chambres, tandis que les actions de disponibilité vérifient un séjour demandé. L'indexation automatique des chambres dépend de l'auto-indexation du catalogue et du quota de chambres attribué ; sinon, utilisez Train rooms (Entraîner les chambres) lorsque cette option est disponible. Vérifiez les actions activées et attendez que l'entraînement soit terminé avant de vous fier à la recherche de chambres par IA.