Verbind je ChatLab-chatbot met je IdoBooking-reserveringssysteem om bezoekers van je website realtime beschikbaarheidsinformatie en hulp bij het boeken te bieden.
Wat de integratie biedt
Wanneer de IdoBooking-integratie is ingeschakeld, kan je chatbot:
- Beschikbare appartementen en accommodaties tonen met beschrijvingen en foto's
- Beschikbaarheid controleren voor specifieke data
- Beschikbare appartementen zoeken voor een bepaalde periode inclusief prijzen
- Bestaande reserveringen opzoeken op basis van ID, status of datumbereik
- Nieuwe reserveringen aanmaken met gastgegevens
Er zijn twee manieren om deze integratie in te stellen - via de IdoBooking Marketplace (aanbevolen) of handmatig via het ChatLab-beheerderspanel.
Optie A: Installatie via de IdoBooking Marketplace (aanbevolen)
De snelste manier om ChatLab met IdoBooking te verbinden is via de IdoBooking Marketplace. Deze methode verwerkt API-inloggegevens automatisch en schakelt alle AI-acties in voor je chatbot.
Stap 1: Installeer ChatLab vanuit de IdoBooking Marketplace
- Log in op je IdoBooking-beheerderspanel
- Ga naar het onderdeel Marketplace
- Zoek ChatLab en klik op Install (Installeren)
IdoBooking stuurt je API-inloggegevens automatisch naar ChatLab - je hoeft geen aparte API-gebruiker aan te maken of inloggegevens handmatig te kopiëren.
Stap 2: Maak een ChatLab-account aan of log in
Nadat je ChatLab in de marketplace hebt geactiveerd, word je doorgestuurd naar een installatiewizard. Als je al een ChatLab-account hebt, log je in. Maak anders een nieuw account aan.
Stap 3: Kies een abonnement
Kies een abonnement dat aansluit op je behoeften. Voor de functies van de IdoBooking-boekingsintegratie (appartementen zoeken, beschikbaarheid controleren, reserveringen maken) is een STANDARD- of PREMIUM-abonnement vereist.
Stap 4: Selecteer een chatbot
Kies een bestaande chatbot om met IdoBooking te verbinden, of maak een nieuwe aan. De wizard kan ook automatisch een nieuwe bot voor je aanmaken.
Stap 5: Voltooi de installatie
De wizard regelt automatisch het volgende:
- Koppelt je IdoBooking-inloggegevens aan de geselecteerde chatbot
- Schakelt alle beschikbare AI-acties in (appartementen zoeken, beschikbaarheidscontroles, reserveringen)
- Stuurt je terug naar IdoBooking of naar het ChatLab-beheerderspanel
Nadat je de wizard hebt voltooid, is je chatbot klaar om boekingsvragen af te handelen. Je kunt afzonderlijke AI-acties verfijnen via Bot Settings > Actions (Botinstellingen > Acties).
Optie B: Handmatige installatie
Volg deze stappen als je de integratie liever handmatig configureert.
Deel 1: Een API-gebruiker aanmaken in IdoBooking
Voordat je ChatLab met je IdoBooking-systeem kunt verbinden, moet je in je IdoBooking-panel een speciale gebruiker met API-toegang aanmaken.
Stap 1: Navigeer naar gebruikersbeheer
- Log in op je IdoBooking-beheerderspanel
- Ga naar Settings > Users (Instellingen > Gebruikers)
- Klik op Add new user (Nieuwe gebruiker toevoegen)
Stap 2: Gebruikersaccount aanmaken
- Voer een login name (inlognaam) in voor de nieuwe gebruiker (bijv. "chatlab-api")
- Vul de overige vereiste informatie in
- Stel een veilig password (wachtwoord) in voor dit account
Stap 3: API-toegang configureren
Configureer de volgende toegangsinstellingen voor de nieuwe gebruiker:
- Schakel in: "Active API access" (Actieve API-toegang) - dit is vereist om de integratie te laten werken
- Schakel uit: "Active panel access" (Actieve paneltoegang) - de gebruiker heeft geen toegang nodig tot het beheerderspanel
Stap 4: Gebruikersrol en -rechten instellen
Je hebt twee opties om de gebruikersrol te configureren:
Optie A: Beheerdersrol (eenvoudiger)
- Selecteer Administrator (Beheerder) als rol
- Aangezien de gebruiker geen paneltoegang heeft, is dit een veilige optie die volledige API-rechten toekent
Optie B: Aangepaste gebruikersrol (meer gedetailleerd)
Als je de voorkeur geeft aan meer gedetailleerde controle, selecteer je Custom user (Aangepaste gebruiker) en configureer je de volgende modulerechten:
- Reservations (Reserveringen) - Alleen-lezen (als de chatbot alleen reserveringsinformatie hoeft op te halen) of Volledige toegang (als de chatbot ook reserveringen moet aanmaken)
- Customers (Klanten) - Alleen-lezen
- Offers (Aanbiedingen) - Alleen-lezen
Voor aangepaste gebruikers moet je ook de locatierechten configureren:
- Scrol naar het onderdeel Location and accommodation permissions (Locatie- en accommodatierechten)
- We raden aan om Select all (Alles selecteren) te kiezen om toegang te verlenen tot alle accommodaties
Stap 5: Onnodige meldingen uitschakelen
Schakel de volgende opties uit om te voorkomen dat de API-gebruiker operationele meldingen ontvangt:
- Notifications for property staff (Meldingen voor accommodatiepersoneel) - Uitschakelen
- Automatic email notifications (Automatische e-mailmeldingen) - Uitschakelen
Stap 6: Opslaan en verbindingsgegevens verzamelen
- Klik op Save (Opslaan) om het gebruikersaccount aan te maken
- Noteer de volgende informatie - je hebt deze nodig voor de configuratie in ChatLab:
- Login - De gebruikersnaam die je hebt aangemaakt (bijv. chatlab-api)
- Password - Het wachtwoord dat je hebt ingesteld
- Subdomain - Je IdoBooking-subdomein (bijv. client3760)
Je subdomein vinden: Kijk naar de URL van je IdoBooking-panel. Als je URL bijvoorbeeld
https://client3760.idosell.comis, dan is je subdomeinclient3760.
Deel 2: De integratie instellen in ChatLab
Stap 1: Navigeer naar het tabblad Connect
- Log in op je ChatLab-beheerderspanel
- Selecteer de bot die je wilt configureren
- Ga naar het tabblad Connect (Verbinden)
- Zoek en klik op IdoBooking in de lijst met integraties
Stap 2: Verbindingsgegevens invoeren
Vul het verbindingsformulier in met de gegevens die je uit IdoBooking hebt verzameld:
- Client Subdomain (Subdomein van klant) - Voer je IdoBooking-subdomein in (zonder de volledige URL). Voorbeeld:
client3760(niethttps://client3760.idosell.com) - System Login (Systeeminlog) - Voer de gebruikersnaam in van de API-gebruiker die je in IdoBooking hebt aangemaakt
- System Password (Systeemwachtwoord) - Voer het wachtwoord in van de API-gebruiker
- Default Currency (Standaardvaluta) - Selecteer de valuta voor prijsinformatie
- Default Language (Standaardtaal) - Selecteer de taal voor accommodatiebeschrijvingen
Stap 3: Verbinden
- Na het invullen van alle verplichte velden wordt de knop Connect (Verbinden) actief
- Klik op Connect om de verbinding tot stand te brengen
- Wacht op het bevestigingsbericht
- Zodra de verbinding succesvol is, zie je een bevestigingsmelding
Na een succesvolle verbinding verandert de knop van "Connect" naar "Update Chatbot", en verschijnt er een knop "Disconnect" voor het geval je de integratie later wilt uitschakelen.
AI-acties configureren
Zodra je IdoBooking-integratie is verbonden (via een van beide methoden), kun je configureren welke AI-acties je chatbot kan uitvoeren. Als je de marketplace-installatie hebt gebruikt, zijn alle acties standaard ingeschakeld.
Beschikbare AI-acties
- Get Apartments - Toont beschikbare appartementen en accommodaties met beschrijvingen, bedconfiguraties en foto's
- Find Available Apartments - Zoekt beschikbare appartementen voor een bepaalde periode inclusief prijsinformatie
- Check Apartment Availability - Controleert de beschikbaarheid voor een specifiek appartement en een specifiek datumbereik
- Get Reservations - Zoekt bestaande reserveringen op basis van ID, status of datumbereik
- Create Reservation - Maakt nieuwe reserveringen aan met gastgegevens en boekingsinformatie
Acties inschakelen en aanpassen
- Klik na het verbinden op Configure AI Actions (AI-acties configureren) in het bevestigingsvenster, of ga naar Bot Settings > Actions en zoek de categorie IdoBooking
- Schakel de gewenste acties in of uit
- Pas het actielabel (de tekst die aan gebruikers wordt getoond terwijl de actie wordt uitgevoerd) en de instructies naar wens aan
- Klik op Save (Opslaan) om de wijzigingen toe te passen
"Find available apartments" configureren
De actie Find available apartments bevat twee extra instellingen die bepalen hoeveel appartementen de chatbot toont wanneer een gast naar beschikbaarheid vraagt, en welke appartementen worden geselecteerd. Open de actie via Bot Settings > Actions > IdoBooking - find available apartments om deze aan te passen.
Number of offers to show (Aantal te tonen aanbiedingen)
Een schuifregelaar van 3 tot 10 (standaard 6). Hiermee bepaal je hoeveel appartementen de chatbot in één antwoord aan de gebruiker toont.
- Lagere waarden (3-4) houden het antwoord kort en to the point, handig wanneer de meeste gasten slechts tussen een paar favorieten kiezen.
- Hogere waarden (8-10) bieden gasten meer variatie om te vergelijken, handig voor accommodaties met een groter aanbod.
Offer selection strategy (Selectiestrategie voor aanbiedingen)
Een vervolgkeuzemenu dat bepaalt welke appartementen worden gekozen uit de volledige lijst met beschikbare resultaten nadat er is gefilterd op datum en aantal gasten. Er zijn vier opties beschikbaar:
- Cheapest offers (Goedkoopste aanbiedingen, standaard) - toont de appartementen met de laagste minimumprijs, gesorteerd van goedkoop naar duur. Prettig wanneer gasten prijsbewust zijn of als je eerst de meest toegankelijke opties wilt presenteren.
- Evenly distributed by price (Gelijkmatig verdeeld op prijs) - kiest appartementen die gelijkmatig over de prijsklasse zijn verdeeld. Bij bijvoorbeeld 9 aanbiedingen levert dit grofweg 3 goedkope, 3 gemiddeld geprijsde en 3 duurdere opties op. Handig als je gasten de volledige breedte van het aanbod wilt laten zien in plaats van alleen het budgetsegment.
- Most expensive offers (Duurste aanbiedingen) - toont de hoogst geprijsde appartementen, gesorteerd van duur naar goedkoop. Geschikt voor premium accommodaties of wanneer je je topsegment wilt uitlichten.
- Random selection (Willekeurige selectie) - kiest willekeurig appartementen uit de gefilterde resultaten. Handig als je wilt variëren welke appartementen tussen gesprekken door worden uitgelicht en wilt voorkomen dat steeds dezelfde worden aangeraden.
Beide instellingen worden per bot opgeslagen, samen met de bestaande aangepaste prompt en het actielabel.
Best practices
Veiligheidsaanbevelingen (handmatige installatie)
- Gebruik een speciale API-gebruiker - Maak een aparte gebruiker aan specifiek voor de ChatLab-integratie in plaats van je persoonlijke beheerdersaccount te gebruiken
- Minimale rechten - Verleen alleen de rechten die nodig zijn voor jouw situatie. Gebruik alleen-lezen als de chatbot enkel informatie hoeft op te halen
- Regelmatige rotatie van inloggegevens - Werk het wachtwoord van de API-gebruiker regelmatig bij en pas de gegevens vervolgens aan in ChatLab
Reacties van de chatbot optimaliseren
- Train je bot met accommodatie-informatie - Voeg beschrijvingen van je accommodaties toe aan de kennisbank, inclusief voorzieningen, kamerkenmerken en locatiegegevens
- Stel duidelijke gespreksstromen in - Configureer welkomstberichten die gebruikers stimuleren om naar beschikbaarheid te vragen, en gebruik suggestievragen zoals "Beschikbaarheid controleren" of "Kamers bekijken"
Probleemoplossing
- Verbinding mislukt - Controleer of "Active API access" is ingeschakeld voor de gebruiker in IdoBooking
- Foutmeldingen met "Access denied" (Toegang geweigerd) - Controleer of de gebruiker de juiste modulerechten heeft
- Geen gegevens geretourneerd - Zorg ervoor dat de gebruiker toegang heeft tot de relevante locaties en accommodaties
- Onjuist subdomein - Controleer je IdoBooking-URL en neem alleen het subdomeingedeelte over (bijv.
client3760uithttps://client3760.idosell.com)