Forbind din ChatLab-chatbot med dit IdoBooking-reservationssystem for at give dine websitebesøgende oplysninger om ledighed i realtid og hjælp til booking.
Hvad integrationen giver
Når IdoBooking-integrationen er aktiveret, kan din chatbot:
- Vise en liste over ledige lejligheder og overnatningssteder med beskrivelser og fotos
- Tjekke ledighed for specifikke datoer
- Finde ledige lejligheder for et givent datointerval med priser
- Slå eksisterende reservationer op efter ID, status eller datointerval
- Oprette nye reservationer med gæsteoplysninger
Der er to måder at opsætte denne integration på - via IdoBooking Marketplace (anbefales) eller manuelt via ChatLabs administrationspanel.
Mulighed A: Opsætning via IdoBooking Marketplace (anbefales)
Den hurtigste måde at forbinde ChatLab med IdoBooking på er via IdoBooking Marketplace. Denne metode håndterer automatisk API-adgangsoplysninger og aktiverer alle AI-handlinger for din chatbot.
Trin 1: Installer ChatLab fra IdoBooking Marketplace
- Log ind på dit IdoBooking-administrationspanel
- Gå til sektionen Marketplace
- Find ChatLab, og klik på Install (Installer)
IdoBooking sender automatisk dine API-adgangsoplysninger til ChatLab - der er ingen grund til at oprette en separat API-bruger eller kopiere adgangsoplysninger manuelt.
Trin 2: Opret en ChatLab-konto, eller log ind på en eksisterende
Når du har aktiveret ChatLab i marketplace, omdirigeres du til en trinvis opsætningsguide. Hvis du allerede har en ChatLab-konto, logger du ind. Ellers opretter du en ny konto.
Trin 3: Vælg en abonnementsplan
Vælg en abonnementsplan, der passer til dine behov. Funktionerne til IdoBooking-bookingintegrationen (lejlighedssøgning, ledighedstjek, reservationer) kræver en STANDARD- eller PREMIUM-plan.
Trin 4: Vælg en chatbot
Vælg en eksisterende chatbot, der skal forbindes med IdoBooking, eller opret en ny. Guiden kan oprette en ny bot for dig automatisk.
Trin 5: Fuldfør opsætningen
Guiden sørger automatisk for at:
- Forbinde dine IdoBooking-adgangsoplysninger med den valgte chatbot
- Aktivere alle tilgængelige AI-handlinger (lejlighedssøgning, ledighedstjek, reservationer)
- Omdirigere dig tilbage til IdoBooking eller til ChatLabs administrationspanel
Når guiden er fuldført, er din chatbot klar til at håndtere bookingforespørgsler. Du kan finjustere de enkelte AI-handlinger under Bot Settings > Actions (Botindstillinger > Handlinger).
Mulighed B: Manuel opsætning
Hvis du foretrækker at konfigurere integrationen manuelt, skal du følge disse trin.
Del 1: Oprettelse af en API-bruger i IdoBooking
Før du forbinder ChatLab til dit IdoBooking-system, skal du oprette en dedikeret bruger med API-adgang i dit IdoBooking-panel.
Trin 1: Gå til brugeradministration
- Log ind på dit IdoBooking-administrationspanel
- Gå til Settings > Users (Indstillinger > Brugere)
- Klik på Add new user (Tilføj ny bruger)
Trin 2: Opret brugerkonto
- Indtast et login name (loginnavn) for den nye bruger (f.eks. "chatlab-api")
- Udfyld de resterende påkrævede oplysninger
- Angiv en sikker adgangskode for denne konto
Trin 3: Konfigurer API-adgang
Konfigurer følgende adgangsindstillinger for den nye bruger:
- Aktiver "Active API access" (Aktiv API-adgang) - dette er påkrævet, for at integrationen kan fungere
- Deaktiver "Active panel access" (Aktiv paneladgang) - brugeren behøver ikke adgang til administrationspanelet
Trin 4: Angiv brugerrolle og rettigheder
Du har to muligheder for at konfigurere brugerrollen:
Mulighed A: Administratorrolle (enklere)
- Vælg Administrator som rollen
- Da brugeren ikke vil have paneladgang, er dette en sikker løsning, der giver fulde API-rettigheder
Mulighed B: Brugerdefineret brugerrolle (mere detaljeret styring)
Hvis du foretrækker mere detaljeret kontrol, skal du vælge Custom user (Brugerdefineret bruger) og konfigurere følgende modulrettigheder:
- Reservations (Reservationer) - Read-only (Skrivebeskyttet, hvis chatbotten kun skal hente reservationsoplysninger) eller Full access (Fuld adgang, hvis chatbotten skal oprette reservationer)
- Customers (Kunder) - Read-only (Skrivebeskyttet)
- Offers (Tilbud) - Read-only (Skrivebeskyttet)
For brugerdefinerede brugere skal du også konfigurere placeringsrettigheder:
- Rul ned til sektionen Location and accommodation permissions (Placerings- og overnatningsrettigheder)
- Vi anbefaler at vælge Select all (Vælg alle) for at give adgang til alle ejendomme
Trin 5: Deaktiver unødvendige notifikationer
For at forhindre API-brugeren i at modtage driftsmæssige notifikationer skal du deaktivere følgende indstillinger:
- Notifications for property staff (Notifikationer til ejendomspersonale) - Deaktiver
- Automatic email notifications (Automatiske e-mailnotifikationer) - Deaktiver
Trin 6: Gem, og indsaml forbindelsesoplysninger
- Klik på Save (Gem) for at oprette brugerkontoen
- Noter følgende oplysninger - du skal bruge dem til konfigurationen i ChatLab:
- Login - Det brugernavn, du oprettede (f.eks. chatlab-api)
- Adgangskode - Den adgangskode, du valgte
- Underdomæne - Dit IdoBooking-underdomæne (f.eks. client3760)
Sådan finder du dit underdomæne: Se på webadressen til dit IdoBooking-panel. Hvis din webadresse f.eks. er
https://client3760.idosell.com, er dit underdomæneclient3760.
Del 2: Opsætning af integrationen i ChatLab
Trin 1: Gå til fanen Connect
- Log ind på dit ChatLab-administrationspanel
- Vælg den bot, du vil konfigurere
- Gå til fanen Connect (Forbind)
- Find og klik på IdoBooking på listen over integrationer
Trin 2: Indtast forbindelsesoplysninger
Udfyld forbindelsesformularen med de oplysninger, du indsamlede fra IdoBooking:
- Client Subdomain - Indtast dit IdoBooking-underdomæne (uden den fulde webadresse). Eksempel:
client3760(ikkehttps://client3760.idosell.com) - System Login - Indtast brugernavnet på den API-bruger, du oprettede i IdoBooking
- System Password - Indtast adgangskoden til API-brugeren
- Default Currency - Vælg valutaen for prisoplysninger
- Default Language - Vælg sproget til ejendomsbeskrivelser
Trin 3: Opret forbindelse
- Når alle påkrævede felter er udfyldt, bliver knappen Connect (Opret forbindelse) aktiv
- Klik på Connect for at etablere forbindelsen
- Vent på bekræftelsesmeddelelsen
- Når forbindelsen er oprettet, vises en notifikation om gennemført handling
Efter en vellykket forbindelse ændres knappen fra "Connect" til "Update Chatbot", og der vises en "Disconnect"-knap, hvis du senere får brug for at deaktivere integrationen.
Konfiguration af AI-handlinger
Når din IdoBooking-integration er forbundet (uanset hvilken metode du brugte), kan du konfigurere, hvilke AI-handlinger din chatbot må udføre. Hvis du brugte marketplace-opsætningen, er alle handlinger aktiveret som standard.
Tilgængelige AI-handlinger
- Get Apartments - Viser en liste over ledige lejligheder og overnatningssteder med beskrivelser, sengekonfigurationer og fotos
- Find Available Apartments - Søger efter ledige lejligheder for et givent datointerval med prisoplysninger
- Check Apartment Availability - Tjekker ledighed for en specifik lejlighed og et givent datointerval
- Get Reservations - Finder eksisterende reservationer efter ID, status eller datointerval
- Create Reservation - Opretter nye reservationer med gæsteoplysninger og bookinginformation
Aktivering og tilpasning af handlinger
- Efter tilslutning klikker du på Configure AI Actions (Konfigurer AI-handlinger) i bekræftelsesmodalen, eller navigerer til Bot Settings > Actions og finder IdoBooking-kategorien
- Slå de handlinger til, som du vil aktivere
- Tilpas handlingsetiketten (den tekst, der vises for brugerne, mens handlingen kører) og instruktionerne efter behov
- Klik på Save (Gem) for at anvende ændringerne
Konfiguration af "Find available apartments"
Handlingen Find available apartments har to ekstra indstillinger, der bestemmer, hvor mange lejligheder chatbotten viser, når en gæst spørger om ledighed, samt hvilke lejligheder der udvælges. Åbn handlingen under Bot Settings > Actions > IdoBooking - find available apartments for at få adgang til dem.
Antal tilbud, der skal vises
En skyder, der går fra 3 til 10 (standard 6). Den styrer, hvor mange lejligheder chatbotten returnerer til brugeren i et enkelt svar.
- Lavere værdier (3-4) holder svaret kort og fokuseret, hvilket er nyttigt, når de fleste gæster vælger mellem blot nogle få favoritter.
- Højere værdier (8-10) giver gæsterne mere variation at sammenligne, hvilket er nyttigt for steder med et større katalog.
Strategi for udvælgelse af tilbud
En rullemenu, der afgør, hvilke lejligheder der vælges fra den samlede liste over ledige resultater, når de er filtreret efter dato og antal gæster. Der er fire valgmuligheder:
- Cheapest offers (standard) - returnerer lejlighederne med den laveste minimumspris, sorteret fra billigst til dyrest. Godt, hvis gæsterne er prisbevidste, eller hvis du vil lægge ud med de mest tilgængelige muligheder.
- Evenly distributed by price - udvælger lejligheder jævnt fordelt over prisintervallet. Med 9 tilbud giver dette f.eks. cirka 3 af de billigste, 3 i mellemklassen og 3 af de dyreste. Nyttigt, når du ønsker, at gæsterne skal se hele bredden af det tilgængelige udvalg frem for kun budgetkategorien.
- Most expensive offers - returnerer de dyreste lejligheder, sorteret fra dyrest til billigst. Godt til luksusovernatningssteder, eller hvis du vil fremhæve dine bedste faciliteter først.
- Random selection - udvælger lejligheder tilfældigt blandt de filtrerede resultater. Nyttigt, hvis du vil variere, hvilke lejligheder der fremhæves mellem samtalerne, og undgå altid at anbefale de samme.
Begge indstillinger gemmes pr. bot sammen med den eksisterende tilpassede prompt og handlingsetiket.
Best practices
Sikkerhedsanbefalinger (manuel opsætning)
- Brug en dedikeret API-bruger - Opret en separat bruger udelukkende til ChatLab-integrationen i stedet for at bruge din personlige administratorkonto
- Minimale rettigheder - Tildel kun de rettigheder, der er strengt nødvendige til dit formål. Brug skrivebeskyttet adgang, hvis chatbotten kun behøver at hente oplysninger
- Regelmæssig udskiftning af adgangsoplysninger - Opdater API-brugerens adgangskode med jævne mellemrum, og opdater derefter adgangsoplysningerne i ChatLab
Optimering af chatbotsvar
- Træn din bot med ejendomsoplysninger - Tilføj beskrivelser af dine overnatningssteder til vidensbasen, herunder faciliteter, værelsesdetaljer og information om beliggenhed
- Opsæt tydelige samtaleflows - Konfigurer velkomstbeskeder, der opfordrer brugerne til at spørge om ledighed, og brug forslåede spørgsmål som "Tjek ledighed" eller "Se værelser"
Fejlfinding
- Forbindelsen mislykkes - Kontroller, at "Active API access" er aktiveret for brugeren i IdoBooking
- Fejl om "Adgang nægtet" (Access denied) - Kontroller, at brugeren har de korrekte modulrettigheder
- Der returneres ingen data - Sørg for, at brugeren har adgang til de relevante lokationer og ejendomme
- Forkert underdomæne - Tjek din IdoBooking-webadresse, og udtræk udelukkende underdomænedelen (f.eks.
client3760frahttps://client3760.idosell.com)