Koble ChatLab-chatboten din sammen med eiendomssystemet (PMS) KWHotel for å gi besøkende på nettstedet romtilgjengelighet i sanntid, mulighet for bestilling og oppslag på reservasjoner. Integrasjonen bruker GuestSage booking engine for rom- og tilgjengelighetsdata, og KWHotel Integrations API for oppslag på reservasjoner.
Hva integrasjonen tilbyr
Når KWHotel-integrasjonen er aktivert, kan chatboten din:
- Vise romtyper med beskrivelser, kapasitet, areal og bilder
- Finne ledige rom for et gitt datoperiode med priser
- Sjekke tilgjengelighet for et spesifikt rom og datoperiode
- Opprette nye reservasjoner med gjesteopplysninger
- Slå opp eksisterende reservasjoner
Forutsetninger
Før du setter opp integrasjonen, må du passe på at du har:
- En KWHotel-konto med GuestSage booking engine aktivert
- Din Hotel ID (UUID) fra GuestSage booking engine
- Din Integrations Hotel ID (numerisk) og Integrations API Key utstedt av KWHotel
- En ChatLab-konto på et STANDARD- eller PREMIUM-abonnement, eller med tillegget Travel Integrations
Finne din Hotel ID (UUID)
Hotel ID er en UUID som er tildelt overnattingsstedet ditt i GuestSage booking engine.
- Logg inn på cloud.kwhotel.com
- Gå til Modules (Moduler) > Booking Engine
- Finn feltet Booking engine link under fanen General (Generelt)
- Kopier UUID-en fra nettadressen
I lenken https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 er for eksempel Hotel ID 82b0085d-da1b-4443-8fde-d5d569a859e6.
Finne påloggingsinformasjon for Integrations API
KWHotel Integrations API bruker en annen identifikator enn GuestSage-UUID-en:
- Integrations Hotel ID - en numerisk ID (for eksempel
292) - Integrations API Key - en hemmelig nøkkel du genererer i KWHotel
Numerisk Hotel ID
Du finner den numeriske hotell-ID-en øverst til høyre i administrasjonspanelet i KWHotel.
Generere API-nøkkelen
Du genererer API-nøkkelen selv inne i KWHotel:
- Logg inn på KWHotel og åpne modulen Synchronization (Synkronisering)
- Klikk på knappen Reset API key (Tilbakestill API-nøkkel)
- Kopier den genererte nøkkelen og lim den inn i tilkoblingsskjemaet i ChatLab
Hvis du klikker på Reset API key, fjernes den forrige nøkkelen (hvis en allerede var generert) og det lages en ny. Eventuelle andre systemer som bruker den forrige nøkkelen, vil slutte å fungere frem til du oppdaterer dem med den nye verdien.
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å KWHotel i listen over integrasjoner
Trinn 2: Fyll inn tilkoblingsdetaljer
Fyll ut tilkoblingsskjemaet:
- Hotel ID (UUID) - din KWHotel-hotell-GUID fra konfigurasjonen i GuestSage booking engine
- Default Currency - valutaen som brukes for priser vist til chatbrukere (standard er PLN)
- Default Language - språket som brukes for rombeskrivelser og tilbudstekst (standard er polsk)
- Integrations Hotel ID - den numeriske hotell-ID-en for KWHotel Integrations API (forskjellig fra UUID-en ovenfor)
- Integrations API Key - den hemmelige API-nøkkelen utstedt av KWHotel
- Discount bot channel - valgfritt. Når dette feltet er fylt ut, hentes tilbud for denne KWHotel-rabattkanalen og sorteres av AI-en. La feltet stå tomt for å bruke standardkanalen.
Trinn 3: Koble til
- Så snart feltene er fylt ut, blir knappen Connect (Koble til) aktiv
- Klikk på Connect for å lagre konfigurasjonen. ChatLab tester tilkoblingen mot GuestSage og Integrations API.
- Når alt er i orden, ser du et bekreftelsesvarsel.
Etter en vellykket tilkobling endres knappen Connect til Update Chatbot (Oppdater chatbot), og det dukker opp en Disconnect-knapp (Koble fra) slik at du kan deaktivere integrasjonen senere.
Hvis testen mot Integrations API mislykkes ved lagring, blir handlingen Get reservation automatisk deaktivert. Legg inn riktig påloggingsinformasjon på nytt og klikk på Update Chatbot for å aktivere den.
Konfigurere AI-handlinger
Når KWHotel-integrasjonen er tilkoblet, kan du konfigurere hvilke AI-handlinger chatboten din skal kunne utføre.
Tilgjengelige AI-handlinger
- KWHotel - get rooms - Viser romtyper med beskrivelser, sengesammensetning, areal, kapasitet og bilder
- KWHotel - find available rooms - Søker etter ledige rom for en gitt datoperiode og returnerer tilbud med priser
- KWHotel - check room availability - Sjekker tilgjengelighet for en bestemt romtype og datoperiode
- KWHotel - create reservation - Oppretter en ny reservasjon med gjestedetaljer og bestillingsinformasjon
- KWHotel - get reservation - Slår opp eksisterende reservasjoner
Aktivere og tilpasse handlinger
- Etter tilkobling klikker du på Configure AI Actions (Konfigurer AI-handlinger) i bekreftelsesvinduet, eller går til Bot Settings (Botinnstillinger) > Actions (Handlinger) og finner kategorien KWHotel
- Aktiver handlingene du ønsker å bruke
- Tilpass handlingsetiketten (teksten som vises for brukerne mens handlingen kjører) og prompt-instruksjonene etter behov
- Klikk på Save (Lagre) for å ta i bruk endringene
Beste praksis
Optimalisere chatbotsvar
- Tren boten din med eiendomsinformasjon - Legg inn beskrivelser av rommene og hotellfasilitetene i kunnskapsbasen, inkludert fasiliteter, beliggenhet, severdigheter i nærheten og regler for innsjekking/utsjekking
- Sett opp tydelige samtaleløp - Konfigurer velkomstmeldinger som oppfordrer gjestene til å spørre om ledige rom, og bruk foreslåtte spørsmål som «Sjekk ledige rom» eller «Vis rom»
- Legg til romspesifikke sider - Lag egne sider for hver romtype på nettstedet ditt og tren chatboten med nettadressene deres for mer innholdsrike svar
Integrasjon med bookingmotor
- KWHotel-integrasjonen henter romoversikt og priser via GuestSage booking engine
- For direkte bestilling utenfor chatten kan du bygge inn GuestSage-bookingwidgeten på nettstedet ditt ved siden av ChatLab-chatboten - chatboten kan deretter veilede gjestene til bestillingssiden når de er klare til å reservere
Feilsøking
- Tilkoblingen mislykkes - Kontroller at Hotel ID er GuestSage-UUID-en (ikke den numeriske Integrations ID-en), og at overnattingsstedet ditt er aktivt i GuestSage booking engine
- Handlingen Get reservation forblir deaktivert - Hvis tilkoblingstesten mot Integrations API mislykkes ved lagring, deaktiveres handlingen automatisk. Fyll inn Integrations Hotel ID og Integrations API Key på nytt, og klikk på Update Chatbot.
- Ingen romdata returneres - Sjekk at romtypene dine er riktig konfigurert i KWHotel med beskrivelser, og at tilgjengeligheten er publisert i GuestSage
- Feil priser eller ingen tilbud - Prisene hentes fra GuestSage. Oppdater priser og tilbudsinnstillinger i KWHotel for å gjenspeile gjeldende priser. Hvis du har angitt en Discount bot channel, må du påse at den har aktive tilbud.
- Integrasjonen er ikke tilgjengelig i administrasjonspanelet - KWHotel-integrasjonen krever et ChatLab STANDARD- eller PREMIUM-abonnement, eller et Travel Integrations-tillegg