Intégration avec IdoBooking

Connectez votre chatbot ChatLab à votre système de réservation IdoBooking afin de fournir des informations de disponibilité en temps réel et une assistance à la réservation aux visiteurs de votre site web.

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.

Avant de commencer

Créez ou sélectionnez d'abord un chatbot. Vous devez disposer des autorisations nécessaires pour gérer ses intégrations et avoir accès aux paramètres de connexion du compte externe. Si la tuile Connect (Connecter) affiche une invitation de mise à niveau ou de contact, vérifiez que votre abonnement inclut cette intégration. Gardez vos identifiants API confidentiels ; ne les collez jamais dans le code d'intégration d'un site web.

Ce que propose l'intégration

Lorsque l'intégration IdoBooking est activée, votre chatbot peut :

• Lister les appartements et hébergements disponibles avec leurs descriptions et photos
• Vérifier la disponibilité pour des dates spécifiques
• Trouver les appartements disponibles pour une période donnée avec les tarifs
• Rechercher des réservations existantes par identifiant, statut ou période
• Créer de nouvelles réservations avec les coordonnées des clients

Il existe deux façons de configurer cette intégration - via la Marketplace IdoBooking (recommandé) ou manuellement depuis le panneau d'administration de ChatLab.

---

Option A : Configuration via la Marketplace IdoBooking (recommandé)

Le moyen le plus rapide de connecter ChatLab à IdoBooking est de passer par la Marketplace IdoBooking. Cette méthode gère automatiquement les identifiants API et active les actions de lecture pour votre chatbot.

Étape 1 : Installer ChatLab depuis la Marketplace IdoBooking

1. Connectez-vous à votre panneau d'administration IdoBooking
2. Accédez à la section Marketplace
3. Recherchez ChatLab et cliquez sur Install (Installer)

IdoBooking envoie automatiquement vos identifiants API à ChatLab - vous n'avez pas besoin de créer un utilisateur API distinct ni de copier les identifiants manuellement.

Étape 2 : Créer ou vous connecter à votre compte ChatLab

Après avoir activé ChatLab sur la marketplace, vous êtes redirigé vers un assistant de configuration guidé. Si vous possédez déjà un compte ChatLab, connectez-vous. Sinon, créez un nouveau compte.

Étape 3 : Choisir un forfait d'abonnement

Sélectionnez un forfait d'abonnement adapté à vos besoins. Les fonctionnalités d'intégration de réservation IdoBooking (recherche d'appartements, vérification des disponibilités, réservations) nécessitent la fonctionnalité d'intégration IdoBooking. Si votre abonnement ne l'inclut pas, suivez l'invitation de mise à niveau ou de contact.

Étape 4 : Sélectionner un chatbot

Choisissez un chatbot existant à connecter à IdoBooking, ou créez-en un nouveau. L'assistant peut créer automatiquement un nouveau bot pour vous.

Étape 5 : Terminer la configuration

L'assistant réalise automatiquement les opérations suivantes :

• Connexion de vos identifiants IdoBooking au chatbot sélectionné
• Activation de la recherche d'appartements, de la vérification des disponibilités et de la consultation des réservations. La création de réservations n'est pas activée automatiquement.
• Redirection vers IdoBooking ou vers le panneau d'administration de ChatLab

Une fois l'assistant terminé, votre chatbot est prêt à traiter les demandes de réservation. Vous pouvez ajuster chaque action de l'IA dans Settings > Actions (Paramètres > Actions).

---

Option B : Configuration manuelle

Si vous préférez configurer l'intégration manuellement, suivez ces étapes.

Partie 1 : Créer un utilisateur API dans IdoBooking

Avant de connecter ChatLab à votre système IdoBooking, vous devez créer un utilisateur dédié disposant d'un accès API dans votre panneau IdoBooking.

Étape 1 : Accéder à la gestion des utilisateurs

1. Connectez-vous à votre panneau d'administration IdoBooking
2. Allez dans Settings > Users (Paramètres > Utilisateurs)
3. Cliquez sur Add new user (Ajouter un nouvel utilisateur)

Étape 2 : Créer le compte utilisateur

1. Entrez un login name (nom d'utilisateur) pour le nouvel utilisateur (par ex. « chatlab-api »)
2. Renseignez les autres informations requises
3. Définissez un password (mot de passe) sécurisé pour ce compte

Étape 3 : Configurer l'accès API

Configurez les paramètres d'accès suivants pour le nouvel utilisateur :

1. Activez « Active API access » - cela est indispensable au bon fonctionnement de l'intégration
2. Désactivez « Active panel access » - l'utilisateur n'a pas besoin d'accéder au panneau d'administration

Étape 4 : Définir le rôle et les autorisations de l'utilisateur

Vous avez deux options pour configurer le rôle de l'utilisateur :

Option A : Rôle d'administrateur (plus simple)

• Sélectionnez Administrator (Administrateur) comme rôle
• Cela accorde des autorisations API étendues même si l'accès au panneau est désactivé. Utilisez un rôle personnalisé si l'intégration n'a besoin que de certaines opérations de lecture.

Option B : Rôle d'utilisateur personnalisé (plus granulaire)

Si vous préférez un contrôle plus précis, sélectionnez Custom user (Utilisateur personnalisé) et configurez les autorisations de module suivantes :

• Reservations (Réservations) - Lecture seule (si le chatbot doit seulement consulter les informations de réservation) ou Accès complet (si le chatbot va créer des réservations)
• Customers (Clients) - Lecture seule
• Offers (Offres) - Lecture seule

Pour les utilisateurs personnalisés, vous devez également configurer les autorisations d'emplacement :

1. Faites défiler jusqu'à la section Location and accommodation permissions (Autorisations d'emplacement et d'hébergement)
2. Sélectionnez les établissements que ce chatbot doit couvrir ; n'accordez l'accès à tous que si tel est votre objectif.

Étape 5 : Désactiver les notifications inutiles

Pour éviter que l'utilisateur API ne reçoive des notifications opérationnelles, désactivez les options suivantes :

• Notifications for property staff (Notifications pour le personnel de l'établissement) - Désactiver
• Automatic email notifications (Notifications automatiques par e-mail) - Désactiver

Étape 6 : Enregistrer et rassembler les informations de connexion

1. Cliquez sur Save (Enregistrer) pour créer le compte utilisateur
2. Notez les informations suivantes - vous en aurez besoin pour la configuration dans ChatLab :

• Login (Identifiant) - Le nom d'utilisateur que vous avez créé (par ex. chatlab-api)
• Password (Mot de passe) - Le mot de passe que vous avez défini
• Subdomain (Sous-domaine) - Votre sous-domaine IdoBooking (par ex. client3760)

Trouver votre sous-domaine : Regardez l'URL de votre panneau IdoBooking. Par exemple, si votre URL est https://client3760.idosell.com, votre sous-domaine est client3760.

Partie 2 : Configurer l'intégration dans ChatLab

Étape 1 : Accéder à l'onglet Connect

1. Connectez-vous à votre panneau d'administration ChatLab
2. Sélectionnez le bot que vous souhaitez configurer
3. Accédez à l'onglet Connect (Connecter)
4. Recherchez et cliquez sur IdoBooking dans la liste des intégrations

Étape 2 : Saisir les détails de connexion

Remplissez le formulaire de connexion avec les informations recueillies dans IdoBooking :

• Client Subdomain (Sous-domaine du client) - Entrez votre sous-domaine IdoBooking (sans l'URL complète). Exemple : client3760 (et non https://client3760.idosell.com)
• System Login (Identifiant système) - Entrez le nom d'utilisateur de l'API créé dans IdoBooking
• System Password (Mot de passe système) - Entrez le mot de passe de l'utilisateur API
• Default Currency (Devise par défaut) - Sélectionnez la devise pour les informations tarifaires
• Default Language (Langue par défaut) - Sélectionnez la langue pour les descriptions des hébergements

Étape 3 : Se connecter

1. Après avoir rempli tous les champs obligatoires, le bouton Connect devient actif
2. Cliquez sur Connect pour établir la connexion
3. Attendez le message de confirmation
4. Une fois la connexion établie, une notification de succès s'affiche

Une fois la connexion réussie, l'intitulé du bouton passe de « Connect » à « Update Chatbot » (Mettre à jour le chatbot), et un bouton « Disconnect » (Déconnecter) apparaît si vous souhaitez désactiver l'intégration ultérieurement.

---

Configurer les actions de l'IA

Une fois votre intégration IdoBooking connectée (quelle que soit la méthode employée), vous pouvez choisir les actions IA que votre chatbot peut exécuter. Vérifiez les actions actives après la configuration. La création de réservations n'est pas activée automatiquement.

Actions IA disponibles

• Get Apartments (Obtenir les appartements) - Liste les appartements et hébergements disponibles avec descriptions, configurations des lits et photos
• Find Available Apartments (Trouver des appartements disponibles) - Recherche les appartements disponibles pour une période donnée avec les tarifs
• Check Apartment Availability (Vérifier la disponibilité d'un appartement) - Vérifie la disponibilité d'un hébergement spécifique pour une période donnée
• Get Reservations (Obtenir les réservations) - Recherche des réservations existantes par identifiant, statut ou période
• Create Reservation (Créer une réservation) - Crée de nouvelles réservations avec les coordonnées du client et les informations de séjour
• AI room search (Recherche de chambres par IA) - Compare la description des souhaits d'un voyageur avec les descriptions de vos hébergements, au lieu de vérifier les dates

La recherche de chambres par IA et Get Apartments sont des alternatives, pas des options complémentaires. Lorsque la recherche par IA est activée, elle remplace l'outil de liste simple et Get Apartments est retiré du chatbot, de sorte qu'un seul outil d'affichage des chambres reste actif. Les actions basées sur les dates ne sont pas affectées.

Activer et personnaliser les actions

1. Après la connexion, cliquez sur Configure AI Actions (Configurer les actions IA) dans la fenêtre de confirmation, ou rendez-vous dans Settings > Actions et recherchez la catégorie IdoBooking
2. Activez les actions de votre choix
3. Personnalisez l'intitulé de l'action (le texte affiché aux utilisateurs pendant l'exécution de l'action) et les instructions selon vos besoins
4. Dans la fenêtre de l'action, cliquez sur Enable (Activer) pour une nouvelle action ou sur Update (Mettre à jour) pour une action existante.

Configurer « Find available apartments »

L'action Find available apartments propose deux paramètres supplémentaires pour définir le nombre d'appartements affichés par le chatbot lorsqu'un voyageur demande des disponibilités, ainsi que le mode de sélection de ces hébergements. Accédez-y depuis Settings > Actions > IdoBooking - find available apartments.

Number of offers to show (Nombre d'offres à afficher)

Un curseur réglable de 3 à 10 (valeur par défaut : 6). Il contrôle le nombre d'appartements renvoyés par le chatbot dans une seule réponse.

• Les valeurs plus faibles (3-4) permettent d'obtenir une réponse concise et ciblée, idéale lorsque la plupart des voyageurs choisissent parmi un petit nombre d'options.
• Les valeurs plus élevées (8-10) offrent aux clients un plus grand éventail de comparaison, ce qui est parfait pour les établissements disposant d'un vaste catalogue.

Offer selection strategy (Stratégie de sélection des offres)

Un menu déroulant qui détermine les appartements sélectionnés dans la liste des résultats disponibles après filtrage par date et nombre de personnes. Quatre options sont proposées :

• Cheapest offers (Offres les moins chères - par défaut) - renvoie les appartements ayant le tarif minimum le plus bas, triés du moins cher au plus cher. Idéal lorsque les clients font attention au budget ou si vous souhaitez mettre en avant les options les plus accessibles.
• Evenly distributed by price (Répartition équilibrée selon le prix) - choisit des appartements répartis uniformément sur l'ensemble de la gamme de prix. Par exemple, pour 9 offres, cela donne environ 3 options économiques, 3 intermédiaires et 3 haut de gamme. Pratique pour présenter toute l'étendue de l'offre sans se limiter aux prix d'entrée de gamme.
• Most expensive offers (Offres les plus chères) - renvoie les appartements aux tarifs les plus élevés, triés du plus cher au moins cher. Idéal pour les établissements haut de gamme ou pour mettre en avant vos hébergements les plus prestigieux.
• Random selection (Sélection aléatoire) - sélectionne des appartements au hasard parmi les résultats filtrés. Utile si vous souhaitez varier les suggestions d'une conversation à l'autre et éviter de toujours recommander les mêmes hébergements.

Ces deux paramètres sont enregistrés par bot, en plus des instructions personnalisées et du libellé de l'action.

---

Tester la configuration

Ouvrez Overview (Vue d'ensemble) et lancez une nouvelle conversation de test. Demandez des hébergements pour des dates futures et un nombre précis de personnes, puis ouvrez le lien de réservation fourni et comparez les dates, la devise et le tarif avec les données d'IdoBooking. Testez la recherche de réservation avec un numéro que vous avez le droit de consulter. N'activez et ne testez Create Reservation que si vous avez l'intention de générer une vraie réservation ; un test dans le chat peut modifier les données de votre système de réservation.

Bonnes pratiques

Recommandations de sécurité (configuration manuelle)

• Utiliser un utilisateur API dédié - Créez un utilisateur distinct spécifiquement pour l'intégration ChatLab au lieu d'utiliser votre compte administrateur personnel
• Privilèges minimaux - N'accordez que les autorisations strictement nécessaires à votre usage. Choisissez un accès en lecture seule si le chatbot doit simplement récupérer des informations
• Renouvellement régulier des identifiants - Mettez à jour régulièrement le mot de passe de l'utilisateur API, puis actualisez vos identifiants dans ChatLab

Optimiser les réponses du chatbot

• Entraîner votre bot avec les informations de vos hébergements - Ajoutez des descriptions de vos logements à la base de connaissances, y compris les équipements, les caractéristiques des chambres et les précisions sur l'emplacement
• Définir des scénarios de conversation clairs - Configurez des messages de bienvenue qui incitent les visiteurs à se renseigner sur les disponibilités, et utilisez des suggestions de questions telles que « Vérifier les disponibilités » ou « Voir les chambres »

---

Dépannage

• Échec de la connexion - Vérifiez que l'option « Active API access » est bien activée pour l'utilisateur dans IdoBooking
• Erreurs de type « Access denied » (Accès refusé) - Vérifiez que l'utilisateur dispose des autorisations de module appropriées
• Aucune donnée retournée - Assurez-vous que l'utilisateur a accès aux hébergements et emplacements concernés
• Sous-domaine incorrect - Vérifiez l'URL de votre panneau IdoBooking et ne conservez que la partie correspondant au sous-domaine (par ex. client3760 pour https://client3760.idosell.com)

---

Catalogue des chambres et vue d'ensemble de l'hôtel

Si votre compte affiche l'onglet Hotel (Hôtel), utilisez Hotel > Rooms (Hôtel > Chambres) pour consulter le catalogue des chambres et l'état de l'entraînement. La fonction AI room search est distincte des vérifications de disponibilité par dates : elle fait correspondre les descriptions de chambres, tandis que les actions de disponibilité vérifient un séjour précis. 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 la fin de l'entraînement avant de vous appuyer sur la recherche de chambres par IA.

Articles connexes

• Ajouter un chatbot à votre site web
• Entraîner votre chatbot
• Envoyer un lien vers votre chatbot