Koble ChatLab-chatboten din sammen med IdoBooking-reservasjonssystemet for å gi sanntidsinformasjon om ledige rom og bestillingshjelp til nettstedsbesøkende.
Hva integrasjonen tilbyr
Når IdoBooking-integrasjonen er aktivert, kan chatboten din:
- Vise ledige leiligheter og overnattingssteder med beskrivelser og bilder
- Sjekke tilgjengelighet for bestemte datoer
- Finne ledige leiligheter for et gitt datointervall med priser
- Slå opp eksisterende reservasjoner etter ID, status eller datointervall
- Opprette nye reservasjoner med gjesteopplysninger
Det finnes to måter å sette opp denne integrasjonen på - via IdoBooking Marketplace (anbefalt) eller manuelt via ChatLab-administrasjonspanelet.
Alternativ A: Oppsett via IdoBooking Marketplace (anbefalt)
Den raskeste måten å koble ChatLab sammen med IdoBooking på, er gjennom IdoBooking Marketplace. Denne metoden håndterer API-påloggingsinformasjon automatisk og aktiverer alle AI-handlinger for chatboten din.
Trinn 1: Installer ChatLab fra IdoBooking Marketplace
- Logg inn på administrasjonspanelet ditt i IdoBooking
- Gå til Marketplace-seksjonen
- Finn ChatLab og klikk på Install (installer)
IdoBooking sender API-påloggingsinformasjonen din automatisk til ChatLab - du trenger ikke å opprette en egen API-bruker eller kopiere påloggingsdetaljer manuelt.
Trinn 2: Opprett eller logg inn på ChatLab-kontoen din
Etter at du har aktivert ChatLab på markedsplassen, blir du videresendt til en veiledet installasjonsveiviser. Hvis du allerede har en ChatLab-konto, logger du inn. Ellers oppretter du en ny konto.
Trinn 3: Velg et abonnementsplan
Velg et abonnementsplan som passer dine behov. Funksjonene for bestillingsintegrasjon med IdoBooking (leilighetssøk, tilgjengelighetssjekk, reservasjoner) krever et STANDARD- eller PREMIUM-plan.
Trinn 4: Velg en chatbot
Velg en eksisterende chatbot du vil koble til IdoBooking, eller opprett en ny. Veiviseren kan automatisk opprette en ny bot for deg.
Trinn 5: Fullfør oppsettet
Veiviseren gjør automatisk følgende:
- Kobler IdoBooking-påloggingsinformasjonen din til den valgte chatboten
- Aktiverer alle tilgjengelige AI-handlinger (leilighetssøk, tilgjengelighetssjekk, reservasjoner)
- Videresender deg tilbake til IdoBooking eller til ChatLab-administrasjonspanelet
Etter at du har fullført veiviseren, er chatboten din klar til å håndtere bestillingsforespørsler. Du kan finjustere individuelle AI-handlinger i Bot Settings (bot-innstillinger) > Actions (handlinger).
Alternativ B: Manuelt oppsett
Hvis du foretrekker å konfigurere integrasjonen manuelt, følger du disse trinnene.
Del 1: Opprette en API-bruker i IdoBooking
Før du kobler ChatLab til IdoBooking-systemet ditt, må du opprette en dedikert bruker med API-tilgang i IdoBooking-panelet ditt.
Trinn 1: Gå til brukeradministrasjon
- Logg inn på administrasjonspanelet ditt i IdoBooking
- Gå til Settings > Users (innstillinger > brukere)
- Klikk på Add new user (legg til ny bruker)
Trinn 2: Opprett brukerkonto
- Skriv inn et login name (brukernavn) for den nye brukeren (f.eks. «chatlab-api»)
- Fyll ut resten av den påkrevde informasjonen
- Angi et sikkert password (passord) for denne kontoen
Trinn 3: Konfigurer API-tilgang
Konfigurer følgende tilgangsinnstillinger for den nye brukeren:
- Aktiver «Active API access» - dette er nødvendig for at integrasjonen skal fungere
- Deaktiver «Active panel access» - brukeren trenger ikke tilgang til administrasjonspanelet
Trinn 4: Angi brukerrolle og tillatelser
Du har to alternativer for å konfigurere brukerrollen:
Alternativ A: Administrator-rolle (enklere)
- Velg Administrator som rolle
- Siden brukeren ikke vil ha paneltilgang, er dette et trygt alternativ som gir fulle API-tillatelser
Alternativ B: Tilpasset brukerrolle (mer detaljert)
Hvis du foretrekker mer detaljert kontroll, velger du Custom user (tilpasset bruker) og konfigurerer følgende modultillatelser:
- Reservations (reservasjoner) - Skrivebeskyttet (hvis chatboten bare skal hente reservasjonsinformasjon) eller Full access (full tilgang, hvis chatboten skal opprette reservasjoner)
- Customers (kunder) - Skrivebeskyttet
- Offers (tilbud) - Skrivebeskyttet
For tilpassede brukere må du også konfigurere stedstillatelser:
- Rull ned til seksjonen Location and accommodation permissions (tillatelser for sted og overnatting)
- Vi anbefaler å velge Select all (velg alle) for å gi tilgang til alle eiendommer
Trinn 5: Deaktiver unødvendige varsler
For å forhindre at API-brukeren mottar driftsvarsler, deaktiverer du følgende alternativer:
- Notifications for property staff (varsler for eiendomspersonale) - Deaktiver
- Automatic email notifications (automatiske e-postvarsler) - Deaktiver
Trinn 6: Lagre og hent tilkoblingsdetaljer
- Klikk på Save (lagre) for å opprette brukerkontoen
- Noter ned følgende informasjon - du trenger den for ChatLab-konfigurasjonen:
- Login - Brukernavnet du opprettet (f.eks. chatlab-api)
- Password - Passordet du oppga
- Subdomain - IdoBooking-underdomenet ditt (f.eks. client3760)
Finne underdomenet ditt: Se på URL-en til IdoBooking-panelet ditt. Hvis URL-en din for eksempel er
https://client3760.idosell.com, er underdomenet dittclient3760.
Del 2: Sette opp integrasjonen i ChatLab
Trinn 1: Gå til Connect-fanen
- Logg inn på ChatLab-administrasjonspanelet ditt
- Velg boten du vil konfigurere
- Gå til fanen Connect (koble til)
- Finn og klikk på IdoBooking i listen over integrasjoner
Trinn 2: Skriv inn tilkoblingsdetaljer
Fyll ut tilkoblingsskjemaet med informasjonen du hentet fra IdoBooking:
- Client Subdomain - Skriv inn IdoBooking-underdomenet ditt (uten hele URL-en). Eksempel:
client3760(ikkehttps://client3760.idosell.com) - System Login - Skriv inn brukernavnet til API-brukeren du opprettet i IdoBooking
- System Password - Skriv inn passordet til API-brukeren
- Default Currency - Velg valuta for prisinformasjon
- Default Language - Velg språk for eiendomsbeskrivelser
Trinn 3: Koble til
- Når alle påkrevde felt er fylt ut, blir knappen Connect aktiv
- Klikk på Connect for å opprette tilkoblingen
- Vent på bekreftelsesmeldingen
- Når tilkoblingen er fullført, ser du et suksessvarsel
Etter en vellykket tilkobling endres knappen fra «Connect» til «Update Chatbot» (oppdater chatbot), og en «Disconnect»-knapp (koble fra) vises dersom du ønsker å deaktivere integrasjonen senere.
Konfigurere AI-handlinger
Når IdoBooking-integrasjonen er tilkoblet (uansett metode), kan du konfigurere hvilke AI-handlinger chatboten din skal kunne utføre. Hvis du brukte markedsplassoppsettet, er alle handlinger aktivert som standard.
Tilgjengelige AI-handlinger
- Get Apartments - Viser ledige leiligheter og overnattingssteder med beskrivelser, sengekonfigurasjoner og bilder
- Find Available Apartments - Søker etter ledige leiligheter for et gitt datointervall med prisinformasjon
- Check Apartment Availability - Sjekker tilgjengelighet for en bestemt leilighet og datointervall
- Get Reservations - Slår opp eksisterende reservasjoner etter ID, status eller datointervall
- Create Reservation - Oppretter nye reservasjoner med gjesteopplysninger og bestillingsinformasjon
Aktivere og tilpasse handlinger
- Etter tilkobling klikker du på Configure AI Actions (konfigurer AI-handlinger) i suksessmodulen, eller går til Bot Settings > Actions og finner IdoBooking-kategorien
- Slå på handlingene du vil aktivere
- Tilpass handlingsetiketten (teksten som vises for brukerne mens handlingen kjører) og instruksjonene etter behov
- Klikk på Save for å lagre endringene
Konfigurere «Find available apartments»
Handlingen Find available apartments har to ekstra innstillinger som styrer hvor mange leiligheter chatboten viser når en gjest spør om tilgjengelighet, og hvilke leiligheter som plukkes ut. Åpne handlingen fra Bot Settings > Actions > IdoBooking - find available apartments for å få tilgang til dem.
Number of offers to show (antall tilbud som skal vises)
En glidebryter som går fra 3 til 10 (standardverdi 6). Den styrer hvor mange leiligheter chatboten returnerer til brukeren i et enkelt svar.
- Lavere verdier (3-4) holder svaret kort og fokusert, noe som er nyttig når de fleste gjester velger mellom noen få favoritter.
- Høyere verdier (8-10) gir gjestene større utvalg å sammenligne, noe som er nyttig for eiendommer med en bredere katalog.
Offer selection strategy (strategi for tilbudsutvalg)
En rullegardinmeny som bestemmer hvilke leiligheter som velges ut fra den fullstendige listen over tilgjengelige resultater etter at det er filtrert på dato og antall gjester. Fire alternativer er tilgjengelige:
- Cheapest offers (standard) - returnerer leilighetene med den laveste minimumsprisen, sortert fra billigst til dyrest. Passer godt når gjestene er prisbevisste eller du vil fremheve de rimeligste alternativene først.
- Evenly distributed by price - velger leiligheter jevnt fordelt over hele prisintervallet. Med for eksempel 9 tilbud gir dette omtrent 3 av de billigste, 3 i mellomklassen og 3 av de dyreste. Nyttig når du vil at gjestene skal se hele spekteret av det som er tilgjengelig, i stedet for bare budsjettalternativene.
- Most expensive offers - returnerer leilighetene med høyest pris, sortert fra dyrest til billigst. Passer godt for eksklusive eiendommer eller når du vil lede med toppnivået av enhetene dine.
- Random selection - velger leiligheter tilfeldig fra de filtrerte resultatene. Nyttig når du vil variere hvilke leiligheter som fremheves fra samtale til samtale, og unngå å alltid anbefale de samme.
Begge innstillingene lagres per bot, sammen med den eksisterende tilpassede ledeteksten og handlingsetiketten.
Beste praksis
Sikkerhetsanbefalinger (manuelt oppsett)
- Bruk en dedikert API-bruker - Opprett en egen bruker spesifikt for ChatLab-integrasjonen i stedet for å bruke din personlige administratorkonto
- Minimale tillatelser - Gi bare tillatelsene som er nødvendige for bruksområdet ditt. Bruk skrivebeskyttet tilgang hvis chatboten bare trenger å hente informasjon
- Regelmessig bytte av påloggingsinformasjon - Oppdater passordet for API-brukeren jevnlig, og oppdater deretter påloggingsinformasjonen i ChatLab
Optimalisere chatbotsvar
- Tren boten din med eiendomsinformasjon - Legg til beskrivelser av overnattingsstedene dine i kunnskapsbasen, inkludert fasiliteter, romdetaljer og informasjon om beliggenhet
- Angi klare samtaleforløp - Konfigurer velkomstmeldinger som veileder brukerne til å spørre om tilgjengelighet, og bruk foreslåtte spørsmål som «Sjekk tilgjengelighet» eller «Vis rom»
Feilsøking
- Tilkoblingen mislykkes - Kontroller at «Active API access» er aktivert for brukeren i IdoBooking
- «Access denied»-feil - Sjekk at brukeren har de riktige modultillatelsene
- Ingen data returneres - Sørg for at brukeren har tilgang til de aktuelle stedene og eiendommene
- Feil underdomene - Sjekk IdoBooking-URL-en din og hent bare ut selve underdomenedelen (f.eks.
client3760frahttps://client3760.idosell.com)