Forbind din ChatLab-chatbot med dit KWHotel property management system for at give dine websitebesøgende adgang til værelsestilgængelighed i realtid, booking og opslag af reservationer. Integrationen bruger GuestSage booking engine til data om værelser og tilgængelighed samt KWHotel Integrations API til opslag af reservationer.
Hvad integrationen tilbyder
Når KWHotel-integrationen er aktiveret, kan din chatbot:
- Vise en liste over værelsestyper med beskrivelser, kapacitet, areal og fotos
- Finde ledige værelser for et givet datointerval med priser
- Tjekke tilgængelighed for et specifikt værelse og datointerval
- Oprette nye reservationer med gæsteoplysninger
- Slå eksisterende reservationer op
Forudsætninger
Før du opsætter integrationen, skal du sikre dig, at du har:
- En KWHotel-konto, hvor GuestSage booking engine er aktiveret
- Dit Hotel ID (UUID) fra GuestSage booking engine
- Dit Integrations Hotel ID (numerisk) og din Integrations API Key, udstedt af KWHotel
- En ChatLab-konto på en Standard- eller Premium-plan eller med tilkøbet Travel Integrations
Sådan finder du dit Hotel ID (UUID)
Hotel-ID'et er et UUID, der er tildelt din ejendom i GuestSage booking engine.
- Log ind på cloud.kwhotel.com
- Gå til Modules > Booking Engine
- Find feltet Booking engine link under fanen General
- Kopiér UUID'et fra URL'en
For eksempel er Hotel-ID'et i linket https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 lig med 82b0085d-da1b-4443-8fde-d5d569a859e6.
Sådan finder du dine Integrations API-adgangsoplysninger
KWHotel Integrations API bruger en anden identifikator end GuestSage UUID'et:
- Integrations Hotel ID - et numerisk ID (for eksempel
292) - Integrations API Key - en hemmelig nøgle, som du genererer i KWHotel
Numerisk Hotel ID
Du finder det numeriske Hotel ID i øverste højre hjørne af KWHotel-administrationspanelet.
Generering af API-nøglen
Du genererer selv API-nøglen inde i KWHotel:
- Log ind på KWHotel og åbn modulet Synchronization
- Klik på knappen Reset API key
- Kopiér den genererede nøgle og indsæt den i ChatLab-forbindelsesformularen
Når du klikker på Reset API key, fjernes den forrige nøgle (hvis der allerede var genereret en), og der oprettes en ny. Ethvert andet system, der bruger den forrige nøgle, vil holde op med at fungere, indtil du opdaterer det med den nye værdi.
Opsætning af integrationen i ChatLab
Trin 1: Gå til fanen Connect
- Log ind på dit ChatLab-kontrolpanel
- Vælg den bot, du vil konfigurere
- Gå til fanen Connect (Forbind)
- Find og klik på KWHotel i listen over integrationer
Trin 2: Indtast forbindelsesoplysninger
Udfyld forbindelsesformularen:
- Hotel ID (UUID) - dit KWHotel-hotel-GUID fra konfigurationen af GuestSage booking engine
- Default Currency - den valuta, der bruges til priser, som vises til brugere i chatten (standard er PLN)
- Default Language - det sprog, der bruges til værelsesbeskrivelser og tilbudstekst (standard er polsk)
- Integrations Hotel ID - det numeriske hotel-ID til KWHotel Integrations API (et andet end ovenstående UUID)
- Integrations API Key - den hemmelige API-nøgle, som KWHotel har udstedt
- Discount bot channel - valgfrit. Når dette felt er udfyldt, hentes tilbud for denne KWHotel-rabatkanal og sorteres af vores AI. Lad feltet stå tomt for at bruge standardkanalen.
Trin 3: Forbind
- Når felterne er udfyldt, bliver knappen Connect (Forbind) aktiv
- Klik på Connect for at gemme konfigurationen. ChatLab tester forbindelsen til GuestSage og til Integrations API.
- Når det lykkes, ser du en bekræftelsesbesked.
Efter en vellykket forbindelse ændres knappen Connect til Update Chatbot (Opdater chatbot), og der vises en Disconnect-knap (Afbryd forbindelse), så du kan deaktivere integrationen senere.
Hvis kontrollen af Integrations API mislykkes, når du gemmer, deaktiveres handlingen Get reservation automatisk. Indtast de korrekte adgangsoplysninger igen, og klik på Update Chatbot for at aktivere den.
Konfiguration af AI Actions
Når din KWHotel-integration er forbundet, kan du konfigurere, hvilke AI-handlinger din chatbot må udføre.
Tilgængelige AI Actions
- KWHotel - get rooms - Viser en liste over værelsestyper med beskrivelser, sengekonfiguration, areal, kapacitet og fotos
- KWHotel - find available rooms - Søger efter ledige værelser for et givet datointerval og returnerer tilbud med priser
- KWHotel - check room availability - Tjekker tilgængelighed for en specifik værelsestype og et datointerval
- KWHotel - create reservation - Opretter en ny reservation med gæsteoplysninger og bookinginformation
- KWHotel - get reservation - Slår eksisterende reservationer op
Aktivering og tilpasning af handlinger
- Efter forbindelsen er oprettet, kan du klikke på Configure AI Actions (Konfigurer AI Actions) i bekræftelsesvinduet eller gå til Bot Settings > Actions (Bot-indstillinger > Handlinger) og finde kategorien KWHotel
- Slå de handlinger til, som du vil aktivere
- Tilpas handlingsetiketten (den tekst, brugerne ser, mens handlingen kører) og prompt-instruktionerne efter behov
- Klik på Save (Gem) for at anvende ændringerne
Bedste praksis
Optimering af chatbot-svar
- Træn din bot med ejendomsoplysninger - Tilføj beskrivelser af dine værelser og hotelfaciliteter til vidensbasen, herunder faciliteter, beliggenhed, nærliggende seværdigheder samt regler for ind- og udtjekning
- Definer tydelige samtaleforløb - Opsæt velkomstbeskeder, der guider gæsterne til at spørge om ledighed, og brug foreslåede spørgsmål som f.eks. "Tjek ledige værelser" eller "Se værelser"
- Opret værelsesspecifikke sider - Opret dedikerede undersider for hver værelsestype på dit website, og træn chatbotted med deres URL'er for at give mere detaljerede svar
Integration med bookingsystemet
- KWHotel-integrationen fungerer via GuestSage booking engine i forhold til lager og priser
- Hvis du ønsker, at reservationer skal kunne fuldføres direkte uden for chatten, kan du integrere GuestSage booking-widgetten på dit website side om side med ChatLab-chatbottem - chatbottem kan guide gæsterne videre til bookingsiden, når de er klar til at reservere
Fejlfinding
- Forbindelsen mislykkes - Kontrollér, at dit Hotel ID er GuestSage UUID'et (ikke det numeriske Integrations ID), og at din ejendom er aktiv i GuestSage booking engine
- Handlingen Get reservation forbliver slået fra - Hvis forbindelsestesten til Integrations API mislykkes, når du gemmer, deaktiveres handlingen automatisk. Indtast dit Integrations Hotel ID og din Integrations API Key igen, og klik på Update Chatbot.
- Der returneres ingen værelsesdata - Tjek, at dine værelsestyper er konfigureret korrekt i KWHotel med beskrivelser, og at tilgængeligheden er publiceret i GuestSage
- Forkerte priser eller ingen tilbud - Priserne hentes fra GuestSage. Opdater priser og tilbudsindstillinger i KWHotel, så de afspejler de aktuelle priser. Hvis du har angivet en Discount bot channel, skal du sikre dig, at den har aktive tilbud.
- Integrationen er ikke tilgængelig i kontrolpanelet - KWHotel-integrationen kræver en Standard- eller Premium-ChatLab-plan eller tilkøbet Travel Integrations