Integration med IdoBooking

Forbind din ChatLab-chatbot med dit IdoBooking-reservationssystem for at give dine websitebesøgende tilgængelighedsoplysninger i realtid og hjælp til booking.

Eksempel på samtale

Eksemplet illustrerer kundeoplevelsen. De tilgængelige handlinger og de returnerede oplysninger afhænger af denne integration og din konfiguration.

Før du går i gang

Opret eller vælg en chatbot først. Du skal have tilladelse til at administrere dens integrationer og adgang til den eksterne kontos forbindelsesindstillinger. Hvis Connect-feltet viser en opfordring til opgradering eller kontakt, skal du kontrollere, at dit abonnement inkluderer denne integration. Hold API-adgangsoplysninger private; indsæt dem aldrig i websitets integreringskode.

Hvad integrationen tilbyder

Når IdoBooking-integrationen er aktiveret, kan din chatbot:

• Vise en oversigt over ledige lejligheder og overnatningssteder med beskrivelser og billeder
• Tjekke ledighed for specifikke datoer
• Finde ledige lejligheder for et givent datointerval med priser
• Slå eksisterende reservationer op ud fra 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 ChatLab-kontrolpanelet.

---

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 API-adgangsoplysninger automatisk og aktiverer læsehandlinger for din chatbot.

Trin 1: Installer ChatLab fra IdoBooking Marketplace

1. Log ind på dit IdoBooking-administrationspanel
2. Gå til sektionen Marketplace
3. Find ChatLab, og klik på Install (Installer)

IdoBooking sender automatisk dine API-adgangsoplysninger til ChatLab - det er ikke nødvendigt at oprette en separat API-bruger eller kopiere adgangsoplysninger manuelt.

Trin 2: Opret eller log ind på din ChatLab-konto

Når du har aktiveret ChatLab på markedspladsen, omdirigeres du til en trinvis opsætningsguide. Hvis du allerede har en ChatLab-konto, skal du logge ind. Ellers skal du oprette en ny konto.

Trin 3: Vælg et abonnement

Vælg et abonnement, der passer til dine behov. Funktionerne til IdoBooking-bookingintegrationen (lejlighedssøgning, ledighedstjek, reservationer) kræver IdoBooking-integrationsfunktionen. Hvis dit abonnement ikke inkluderer den, skal du følge opfordringen til opgradering eller kontakt.

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 lejlighedssøgning, ledighedstjek og reservationsopslag. Oprettelse af reservationer aktiveres ikke automatisk.
• Omdirigere dig tilbage til IdoBooking eller til ChatLab-kontrolpanelet

Når du har fuldført guiden, er din chatbot klar til at håndtere bookingforespørgsler. Du kan finjustere individuelle AI-handlinger under Settings > Actions (Indstillinger > 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 med dit IdoBooking-system, skal du oprette en dedikeret bruger med API-adgang i dit IdoBooking-panel.

Trin 1: Gå til brugeradministration

1. Log ind på dit IdoBooking-administrationspanel
2. Gå til Settings > Users (Indstillinger > Brugere)
3. Klik på Add new user (Tilføj ny bruger)

Trin 2: Opret brugerkonto

1. Indtast et login name (loginnavn) for den nye bruger (f.eks. "chatlab-api")
2. Udfyld de resterende påkrævede oplysninger
3. Angiv en sikker password (adgangskode) til denne konto

Trin 3: Konfigurer API-adgang

Konfigurer følgende adgangsindstillinger for den nye bruger:

1. Aktiver "Active API access" - dette er påkrævet, for at integrationen kan fungere
2. Deaktiver "Active panel access" - brugeren behøver ikke adgang til administrationspanelet

Trin 4: Angiv brugerrolle og tilladelser

Du har to muligheder for at konfigurere brugerrollen:

Mulighed A: Administratorrolle (enklere)

• Vælg Administrator som rollen
• Dette tildeler brede API-tilladelser, selv når paneladgang er deaktiveret. Brug en tilpasset rolle, hvis integrationen kun behøver udvalgte læsehandlinger.

Mulighed B: Tilpasset brugerrolle (mere detaljeret)

Hvis du foretrækker mere detaljeret kontrol, skal du vælge Custom user (Tilpasset bruger) og konfigurere følgende modultilladelser:

• Reservations - Skrivebeskyttet (hvis chatbotten kun skal hente reservationsoplysninger) eller Fuld adgang (hvis chatbotten skal oprette reservationer)
• Customers - Skrivebeskyttet
• Offers - Skrivebeskyttet

For tilpassede brugere skal du også konfigurere placeringstilladelser:

1. Rul ned til sektionen Location and accommodation permissions (Placerings- og overnatningstilladelser)
2. Vælg de ejendomme, som denne chatbot skal dække; giv kun adgang til alle, hvis det er din hensigt.

Trin 5: Deaktiver unødvendige notifikationer

For at forhindre API-brugeren i at modtage driftsnotifikationer skal du deaktivere følgende indstillinger:

• Notifications for property staff - Deaktiver
• Automatic email notifications - Deaktiver

Trin 6: Gem og indsaml forbindelsesoplysninger

1. Klik på Save (Gem) for at oprette brugerkontoen
2. Noter følgende oplysninger - du skal bruge dem til konfigurationen i ChatLab:

• Login - Det brugernavn, du oprettede (f.eks. chatlab-api)
• Password - Den adgangskode, du valgte
• Subdomain - Dit IdoBooking-underdomæne (f.eks. client3760)

Sådan finder du dit underdomæne: Kig på webadressen for dit IdoBooking-panel. Hvis din URL f.eks. er https://client3760.idosell.com, er dit underdomæne client3760.

Del 2: Opsætning af integrationen i ChatLab

Trin 1: Gå til fanen Connect

1. Log ind på dit ChatLab-kontrolpanel
2. Vælg den bot, du vil konfigurere
3. Gå til fanen Connect (Forbind)
4. 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 hele webadressen). Eksempel: client3760 (ikke https://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 til prisoplysninger
• Default Language - Vælg sproget til ejendomsbeskrivelser

Trin 3: Opret forbindelse

1. Når du har udfyldt alle påkrævede felter, bliver knappen Connect (Forbind) aktiv
2. Klik på Connect for at etablere forbindelsen
3. Vent på bekræftelsesmeddelelsen
4. Når forbindelsen er oprettet, ser du en succesmeddelelse

Efter en vellykket forbindelse ændres knappen fra "Connect" til "Update Chatbot", og en "Disconnect"-knap vises, hvis du får brug for at deaktivere integrationen senere.

---

Konfiguration af AI-handlinger

Når din IdoBooking-integration er forbundet (via en af de to metoder), kan du konfigurere, hvilke AI-handlinger din chatbot må udføre. Gennemgå de aktive handlinger uanset valg af opsætningsmetode. Oprettelse af reservationer aktiveres ikke automatisk.

Tilgængelige AI-handlinger

• Get Apartments - Viser ledige lejligheder og overnatningssteder med beskrivelser, sengefordeling og billeder
• Find Available Apartments - Søger efter ledige lejligheder for et givent datointerval med prisoplysninger
• Check Apartment Availability - Tjekker ledighed for en bestemt lejlighed og et specifikt datointerval
• Get Reservations - Finder eksisterende reservationer ud fra ID, status eller datointerval
• Create Reservation - Opretter nye reservationer med gæsteoplysninger og bookinginformation
• AI room search - Matcher en gæsts beskrivelse af ønsker med dine værelsesbeskrivelser i stedet for at tjekke datoer

AI-værelsessøgning og Get Apartments er alternativer, ikke tilføjelser. Når AI-værelsessøgning er slået til, erstatter den det almindelige listeværktøj, og Get Apartments fjernes fra chatbotten, så kun ét værktøj til værelsesvisning er aktivt ad gangen. De datobaserede handlinger påvirkes ikke.

Aktivering og tilpasning af handlinger

1. Når forbindelsen er oprettet, skal du klikke på Configure AI Actions i pop op-vinduet eller gå til Settings > Actions og finde IdoBooking-kategorien
2. Slå de handlinger til, som du vil aktivere
3. Tilpas handlingens etiket (den tekst, der vises for brugerne, mens handlingen kører) og instruktionerne efter behov
4. I handlingsdialogen skal du klikke på Enable (Aktiver) for en ny handling eller Update (Opdater) for en eksisterende handling.

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, og hvilke lejligheder der udvælges. Åbn handlingen under Settings > Actions > IdoBooking - find available apartments for at få adgang til dem.

Number of offers to show

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 nogle få favoritter.
• Højere værdier (8-10) giver gæsterne mere variation at sammenligne, hvilket er en fordel for steder med et bredere katalog.

Offer selection strategy

En rullemenu, der bestemmer, hvilke lejligheder der udvælges fra den samlede liste over ledige resultater efter filtrering på dato og antal gæster. Der er fire valgmuligheder:

• Cheapest offers (standard) - returnerer lejlighederne med den laveste minimumspris, sorteret fra billigst til dyrest. Godt, når gæsterne er prisbevidste, eller hvis du vil fremhæve de mest tilgængelige muligheder først.
• Evenly distributed by price - udvælger lejligheder jævnt fordelt over prisintervallet. Med 9 tilbud giver dette for eksempel cirka 3 billigste, 3 i mellemklassen og 3 dyreste. Nyttigt, hvis du ønsker, at gæsterne skal se hele udvalget frem for kun budgetmulighederne.
• Most expensive offers - returnerer lejlighederne med de højeste priser, sorteret fra dyrest til billigst. Godt til premium-ejendomme, eller hvis du vil fremhæve dine bedste faciliteter først.
• Random selection - udvælger tilfældige lejligheder fra 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.

---

Test den færdige opsætning

Åbn Overview (Oversigt), og start en ny testsamtale. Spørg efter værelser til et fremtidigt datointerval og et bestemt antal gæster, åbn derefter det modtagne bookinglink, og sammenlign datoer, valuta og pris med IdoBooking. Test reservationsopslag med en reservation, du har tilladelse til at inspicere. Aktiver og test kun Create Reservation, når du rent faktisk har til hensigt at oprette en rigtig booking; en samtale-test kan skrive direkte til dit bookingsystem.

Bedste praksis

Sikkerhedsanbefalinger (manuel opsætning)

• Brug en dedikeret API-bruger - Opret en separat bruger specifikt til ChatLab-integrationen i stedet for at bruge din personlige administratorkonto
• Minimale tilladelser - Tildel kun de tilladelser, der er nødvendige til formålet. Brug skrivebeskyttet adgang, hvis chatbotten kun skal hente oplysninger
• Regelmæssig udskiftning af adgangsoplysninger - Opdater API-brugerens adgangskode med jævne mellemrum, og opdater derefter adgangsoplysningerne i ChatLab

Optimering af chatbot-svar

• Træn din bot med ejendomsoplysninger - Tilføj beskrivelser af dine overnatningssteder til vidensbasen, herunder faciliteter, værelsesdetaljer og oplysninger om placering
• Opsæt klare samtaleflows - Konfigurer velkomstbeskeder, der guider brugerne til at spørge om ledighed, og brug foreslåede spørgsmål såsom "Tjek ledighed" eller "Se værelser"

---

Fejlfinding

• Forbindelse mislykkes - Kontroller, at "Active API access" er aktiveret for brugeren i IdoBooking
• Fejlmeddelelser om "Access denied" (Adgang nægtet) - Tjek, at brugeren har de korrekte modultilladelser
• Ingen data returneres - Sørg for, at brugeren har adgang til de relevante placeringer og ejendomme
• Forkert underdomæne - Tjek din IdoBooking-URL, og udtræk kun underdomænedelen (f.eks. client3760 fra https://client3760.idosell.com)

---

Værelseskatalog og hoteloversigt

Hvis din konto viser fanen Hotel, kan du bruge Hotel > Rooms (Hotel > Værelser) til at gennemgå værelseskataloget og træningsstatussen. AI room search er adskilt fra datobaserede ledighedstjek: den matcher værelsesbeskrivelser, mens ledighedshandlinger tjekker et specifikt ophold. Automatisk indeksering af værelser afhænger af automatisk katalogindeksering og tildelt værelseskapacitet; ellers bruges Train rooms (Træn værelser), når det er tilgængeligt. Gennemgå de aktiverede handlinger, og vent på, at træningen er færdig, før du forlader dig på AI-værelsessøgning.

Relaterede artikler

• Tilføjelse af chatbot på dit website
• Træning af din chatbot
• Afsendelse af et link til din chatbot