Koppel je ChatLab-chatbot aan het Hotres-reserveringssysteem om realtime informatie over de beschikbaarheid van appartementen en reserveringslinks direct in de chat aan te bieden.
Opmerking: De Hotres-integratie is beschikbaar op aanvraag. Als je de optie Hotres niet ziet op het tabblad Connect (Verbinden), neem dan contact op met support om dit voor je account in te schakelen.
Wat de integratie biedt
Get Apartments - Klanten kunnen vragen naar de kamers en appartementen van je accommodatie. De chatbot haalt een volledige lijst op uit Hotres met daarin:
- Naam en beschrijving van het appartement of de kamer
- Afbeelding en directe link naar de pagina van het appartement
Check Apartment Availability - Klanten kunnen controleren of een specifiek appartement beschikbaar is voor bepaalde data. De chatbot toont:
- Beschikbaarheidsstatus en prijzen
- Speciale aanbiedingsindicator wanneer het tarief afwijkt van je hoofdprijslijst
- Alternatieve appartementen met voorgestelde datumbereiken als het aangevraagde verblijf niet beschikbaar is of minimumverblijfseisen heeft
- Reserveringslink met vooraf ingevulde data
Find Available Apartments - Klanten kunnen zoeken naar beschikbare appartementen door een datumbereik en het aantal gasten op te geven. De chatbot toont:
- Alle beschikbare appartementen voor de opgegeven data inclusief prijzen
- Speciale aanbiedingsindicator voor gereduceerde tarieven
- Reserveringslinks voor elk beschikbaar appartement
- Als er geen appartementen beschikbaar zijn voor de exacte data: alternatieve opties met voorgestelde datumbereiken die voldoen aan de minimumverblijfseisen
Vereisten
Verzamel voordat je begint de volgende gegevens uit je Hotres-account:
-
API Key - De authenticatiesleutel van je Hotres-API
-
Object ID - De identificatiecode van je Hotres-accommodatie
-
Main Pricelist Name - De exacte naam van je primaire prijslijst in Hotres
-
Booking URL Format - Het URL-patroon voor je reserveringspagina, met gebruik van deze tijdelijke aanduidingen:
{DATE_FROM}- Incheckdatum{DATE_TO}- Uitcheckdatum{TAG}- Identificatiecode van het appartement of de kamer
Voorbeeldindeling:
https://yourdomain.com/booking?checkin={DATE_FROM}&checkout={DATE_TO}&apt={TAG}
Stap 1: Hotres verbinden in ChatLab
- Log in bij ChatLab en selecteer je bot
- Ga naar het tabblad Connect (Verbinden)
- Klik op Connect (Verbinden) op de Hotres-tegel
- Vul de vier verplichte velden in: API Key, Object ID, Main Pricelist Name en Booking URL format
- Klik op Connect (Verbinden)
ChatLab test de verbinding automatisch door gegevens op te vragen bij je Hotres-accommodatie. Als de API key of het Object ID onjuist is, zie je een foutmelding. Bij succes verschijnt er een bevestigingsvenster met de optie om AI-acties te configureren.
Stap 2: Hotres-acties configureren
Schakel na het verbinden individuele AI-acties in en pas ze naar wens aan. Ga naar Settings > Actions (Instellingen > Acties) en filter op het platform Hotres.
Er zijn drie acties beschikbaar:
- Hotres - get apartments - toont alle kamers en appartementen in je accommodatie
- Hotres - check apartment availability - controleert een specifiek appartement voor bepaalde data
- Hotres - find available apartments - zoekt beschikbare appartementen op basis van datumbereik en aantal gasten
Klik op de activatieknop bij elke actie om deze in te schakelen. Je kunt het volgende aanpassen:
- Action Label (Actielabel) - het bericht dat aan gebruikers wordt getoond terwijl de actie wordt uitgevoerd (bijv. "Beschikbaarheid controleren...")
- Instructions (Instructies) - stuurt de AI aan over wanneer en hoe de actie moet worden gebruikt
- User Instructions (Gebruikersinstructies) - aanvullende bedrijfsregels of voorkeuren voor de AI
Je integratie testen
Open na het activeren van de acties je chatbot-widget en probeer:
- "Welke appartementen hebben jullie?" (test Get Apartments)
- "Is appartement 101 beschikbaar van 15 tot 20 december?" (test Check Apartment Availability)
- "Wat is er beschikbaar van 15 tot 20 december voor 2 personen?" (test Find Available Apartments)
Controleer of de antwoorden overeenkomen met je Hotres-gegevens en of reserveringslinks correct openen met vooraf ingevulde data.
De integratie beheren
Instellingen bijwerken - Klik op de Hotres-tegel op het tabblad Connect (Verbinden), werk de gewenste velden bij en klik op Update Chatbot (Chatbot bijwerken).
Verbinding verbreken - Klik op de Hotres-tegel en klik vervolgens op Disconnect (Verbinding verbreken). Hiermee worden alle Hotres-AI-acties gedeactiveerd. Je configuratie wordt opgeslagen en kan later opnieuw worden verbonden.
Tips
- Train je bot met gedetailleerde accommodatiebeschrijvingen, voorzieningen en locatie-informatie, zodat de AI context kan bieden naast de beschikbaarheidsgegevens.
- Voeg suggestievragen toe zoals "Beschikbaarheid controleren" of "Appartementen bekijken" om bezoekers op weg te helpen.
- Als je reserveringsvoorwaarden hebt (minimumverblijf, annuleringsvoorwaarden), voeg deze dan toe aan de actie-instructies zodat de AI ze automatisch vermeldt.