Integrasjon med IdoBooking

Koble ChatLab-chatboten din sammen med IdoBooking-reservasjonssystemet ditt for å gi sanntidsinformasjon om tilgjengelighet og bookinghjelp til nettstedsbesøkende.

Eksempelsamtale

Eksempelet illustrerer kundeopplevelsen. Tilgjengelige handlinger og informasjonen som returneres, avhenger av denne integrasjonen og konfigurasjonen din.

Før du starter

Opprett eller velg en chatbot først. Du må ha tillatelse til å administrere integrasjonene dens og ha tilgang til tilkoblingsinnstillingene i den eksterne kontoen. Hvis Connect-flisen viser en oppfordring om oppgradering eller kontakt, må du sjekke at abonnementet ditt inkluderer denne integrasjonen. Hold API-tilgangsopplysninger hemmelige; lim dem aldri inn i integreringskoden (embed-koden) på nettstedet.

Hva integrasjonen tilbyr

Når IdoBooking-integrasjonen er aktivert, kan chatboten din:

• Vise en liste over tilgjengelige leiligheter og overnattingssteder med beskrivelser og bilder
• Sjekke tilgjengelighet for bestemte datoer
• Finne tilgjengelige leiligheter for et gitt datointervall med priser
• Slå opp eksisterende reservasjoner etter ID, status eller datointervall
• Opprette nye reservasjoner med gjesteinformasjon

Det er 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 via IdoBooking Marketplace. Denne metoden håndterer API-tilgangsopplysninger automatisk og aktiverer lesehandlingene for chatboten din.

Trinn 1: Installer ChatLab fra IdoBooking Marketplace

1. Logg inn på administrasjonspanelet ditt i IdoBooking
2. Gå til Marketplace-seksjonen
3. Finn ChatLab og klikk på Install (installer)

IdoBooking sender API-tilgangsopplysningene dine til ChatLab automatisk - du trenger ikke å opprette en egen API-bruker eller kopiere tilgangsopplysninger 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 oppsettsveiviser. Hvis du allerede har en ChatLab-konto, logger du inn. Hvis ikke, oppretter du en ny konto.

Trinn 3: Velg en abonnementsplan

Velg en abonnementsplan som passer dine behov. Funksjonene for IdoBooking-bookingintegrasjonen (leilighetssøk, tilgjengelighetssjekk, reservasjoner) krever funksjonen for IdoBooking-integrasjon. Hvis abonnementet ditt ikke inkluderer dette, følger du oppfordringen om oppgradering eller kontakt.

Trinn 4: Velg en chatbot

Velg en eksisterende chatbot du vil koble til IdoBooking, eller opprett en ny. Veiviseren kan opprette en ny bot for deg automatisk.

Trinn 5: Fullfør oppsettet

Veiviseren gjør automatisk følgende:

• Kobler IdoBooking-tilgangsopplysningene dine til den valgte chatboten
• Aktiverer leilighetssøk, tilgjengelighetssjekker og reservasjonsoppslag. Oppretting av reservasjoner aktiveres ikke automatisk.
• Videresender deg tilbake til IdoBooking eller til ChatLab-administrasjonspanelet

Når du har fullført veiviseren, er chatboten klar til å håndtere bookinghenvendelser. Du kan finjustere individuelle AI-handlinger under Settings > Actions (Innstillinger > Handlinger).

---

Alternativ B: Manuelt oppsett

Følg disse trinnene hvis du foretrekker å konfigurere integrasjonen manuelt.

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

1. Logg inn på administrasjonspanelet ditt i IdoBooking
2. Gå til Settings > Users (Innstillinger > Brukere)
3. Klikk på Add new user (Legg til ny bruker)

Trinn 2: Opprett brukerkonto

1. Skriv inn et login name (brukernavn) for den nye brukeren (f.eks. "chatlab-api")
2. Fyll ut resten av den påkrevde informasjonen
3. Angi et sikkert password (passord) for denne kontoen

Trinn 3: Konfigurer API-tilgang

Konfigurer følgende tilgangsinnstillinger for den nye brukeren:

1. Enable (Aktiver) "Active API access" - dette er nødvendig for at integrasjonen skal fungere
2. Disable (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
• Dette gir omfattende API-tillatelser selv når paneltilgang er deaktivert. Bruk en tilpasset rolle hvis integrasjonen bare trenger utvalgte leseoperasjoner.

Alternativ B: Tilpasset brukerrolle (mer detaljert)

Hvis du foretrekker mer detaljert kontroll, velger du Custom user (Tilpasset bruker) og konfigurerer følgende modultillatelser:

• Reservations - Skrivebeskyttet / Read-only (hvis chatboten bare skal hente reservasjonsinformasjon) eller Full tilgang / Full access (hvis chatboten skal opprette reservasjoner)
• Customers - Skrivebeskyttet / Read-only
• Offers - Skrivebeskyttet / Read-only

For tilpassede brukere må du også konfigurere lokasjonstillatelser:

1. Rull ned til delen Location and accommodation permissions (Tillatelser for lokasjon og overnattingssted)
2. Velg eiendommene denne chatboten skal dekke; gi tilgang til alle bare hvis det faktisk er det tiltenkte omfanget.

Trinn 5: Deaktiver unødvendige varsler

For å forhindre at API-brukeren mottar driftsvarsler, deaktiverer du følgende alternativer:

• Notifications for property staff - Deaktiver (Disable)
• Automatic email notifications - Deaktiver (Disable)

Trinn 6: Lagre og samle inn tilkoblingsdetaljer

1. Klikk på Save (Lagre) for å opprette brukerkontoen
2. Noter ned følgende informasjon - du trenger den for ChatLab-konfigurasjonen:

• Login - Brukernavnet du opprettet (f.eks. chatlab-api)
• Password - Passordet du angav
• 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 ditt client3760.

Del 2: Sette opp integrasjonen i ChatLab

Trinn 1: Gå til Connect-fanen

1. Logg inn på ChatLab-administrasjonspanelet ditt
2. Velg boten du vil konfigurere
3. Gå til Connect-fanen (Koble til)
4. 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 (ikke https://client3760.idosell.com)
• System Login - Skriv inn brukernavnet til API-brukeren du opprettet i IdoBooking
• System Password - Skriv inn passordet for API-brukeren
• Default Currency - Velg valutaen for prisinformasjon
• Default Language - Velg språket for eiendomsbeskrivelser

Trinn 3: Koble til

1. Når du har fylt ut alle obligatoriske felt, blir knappen Connect aktiv
2. Klikk på Connect for å opprette tilkoblingen
3. Vent på bekreftelsesmeldingen
4. Når den er tilkoblet, vil du se et suksessvarsel

Etter en vellykket tilkobling endres knappen fra "Connect" til "Update Chatbot", og en "Disconnect"-knapp vises hvis du skulle trenge å deaktivere integrasjonen senere.

---

Konfigurere AI Actions

Når IdoBooking-integrasjonen din er koblet til (uansett metode), kan du konfigurere hvilke AI-handlinger chatboten din kan utføre. Gå gjennom de aktive handlingene etter oppsettet. Oppretting av reservasjoner aktiveres ikke automatisk.

Tilgjengelige AI Actions

• Get Apartments - Viser tilgjengelige 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 et gitt datointervall
• Get Reservations - Slår opp eksisterende reservasjoner etter ID, status eller datointervall
• Create Reservation - Oppretter nye reservasjoner med gjesteopplysninger og bestillingsinformasjon
• AI room search - Matcher gjestens beskrivelse av hva de ønsker med rombeskrivelsene dine, i stedet for å sjekke datoer

AI room search og Get Apartments er alternativer til hverandre, ikke tillegg. Når AI room search er aktivert, erstatter den det enkle listeverktøyet, og Get Apartments fjernes fra chatboten, slik at bare ett romlistingsverktøy er aktivt om gangen. De datobaserte handlingene påvirkes ikke.

Aktivere og tilpasse handlinger

1. Etter tilkobling klikker du på Configure AI Actions i bekreftelsesvinduet, eller navigerer til Settings > Actions (Innstillinger > Handlinger) og finner IdoBooking-kategorien
2. Slå på handlingene du vil aktivere
3. Tilpass handlingsetiketten (teksten som vises til brukere mens handlingen kjører) og instruksjonene etter behov
4. I handlingsdialogen klikker du på Enable (Aktiver) for en ny handling eller Update (Oppdater) for en eksisterende handling.

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 velges ut. Åpne handlingen fra 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 (standard er 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 flere alternativer å sammenligne, noe som er nyttig for overnattingssteder med en større katalog.

Offer selection strategy (Strategi for utvalg av tilbud)

En rullegardinmeny som bestemmer hvilke leiligheter som velges ut fra den fullstendige listen over tilgjengelige resultater etter filtrering på dato og antall gjester. Fire alternativer er tilgjengelige:

• Cheapest offers (standard) - returnerer leilighetene med lavest minstepris, sortert fra billigst til dyrest. Passer godt når gjester er prisbevisste, eller når du vil lede an med de rimeligste alternativene.
• Evenly distributed by price - velger leiligheter jevnt fordelt over hele prisklassen. Med for eksempel 9 tilbud gir dette omtrent 3 billigste, 3 i mellomklassen og 3 dyreste. Nyttig når du vil at gjestene skal se hele spekteret av hva 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 overnattingssteder, eller når du vil fremheve toppsegmentet ditt.
• Random selection - velger leiligheter tilfeldig fra de filtrerte resultatene. Nyttig når du vil variere hvilke leiligheter som trekkes frem i ulike samtaler, og unngå å alltid anbefale de samme.

Begge innstillingene lagres per bot, sammen med den eksisterende tilpassede ledeteksten og handlingsetiketten.

---

Test det fullførte oppsettet

Åpne Overview (Oversikt) og start en ny testsamtale. Be om rom for et fremtidig datointervall og et bestemt antall gjester, åpne deretter den returnerte bookinglenken og sammenlign datoene, valutaen og prisen med IdoBooking. Test reservasjonsoppslag med en reservasjon du har tillatelse til å sjekke. Aktiver og test bare Create Reservation når du faktisk har til hensikt å opprette en ekte booking; en samtaledrevet test kan skrive direkte til bookingsystemet ditt.

Beste praksis

Sikkerhetsanbefalinger (manuelt oppsett)

• Bruk en dedikert API-bruker - Opprett en separat bruker spesifikt for ChatLab-integrasjonen i stedet for å bruke din personlige administratorkonto
• Minimale tillatelser - Gi bare de tillatelsene som er nødvendige for bruksområdet ditt. Bruk skrivebeskyttet tilgang hvis chatboten bare trenger å hente informasjon
• Regelmessig utskifting av tilgangsopplysninger - Oppdater passordet for API-brukeren med jevne mellomrom, og oppdater deretter tilgangsopplysningene i ChatLab

Optimalisering av chatbotens svar

• Tren boten din med eiendomsinformasjon - Legg til beskrivelser av overnattingsstedene dine i kunnskapsbasen, inkludert fasiliteter, romfunksjoner og lokasjonsdetaljer
• Sett opp tydelige samtaleflyter - Konfigurer velkomstmeldinger som veileder brukerne til å spørre om tilgjengelighet, og bruk foreslåtte spørsmål som "Sjekk tilgjengelighet" eller "Se rom"

---

Feilsøking

• Tilkobling mislykkes - Kontroller at "Active API access" er aktivert for brukeren i IdoBooking
• Feil med "Access denied" (Ingen tilgang) - Sjekk at brukeren har de riktige modultillatelsene
• Ingen data returneres - Forsikre deg om at brukeren har tilgang til de relevante lokasjonene og eiendommene
• Feil underdomene - Sjekk IdoBooking-URL-en din og hent ut bare underdomenedelen (f.eks. client3760 fra https://client3760.idosell.com)

---

Romkatalog og hotelloversikt

Hvis kontoen din viser Hotel-fanen, bruker du Hotel > Rooms for å se over romkatalogen og treningsstatusen. AI room search fungerer uavhengig av datobaserte tilgjengelighetssjekker: funksjonen matcher rombeskrivelser, mens tilgjengelighetshandlinger sjekker et forespurt opphold. Automatisk romindeksering avhenger av automatisk katalogindeksering og tildelt romkapasitet; ellers bruker du Train rooms når dette er tilgjengelig. Gjennomgå de aktiverte handlingene og vent til treningen er fullført før du stoler på AI-romsøk.

Relaterte artikler

• Legge til en chatbot på nettstedet ditt
• Trening av chatboten din
• Sende en lenke til chatboten din