Koppla din ChatLab-chattbot till ditt fastighetssystem KWHotel för att ge dina webbplatsbesökare rumsstatus i realtid, bokning och uppslagning av bokningar. Integrationen använder GuestSage booking engine för rums- och tillgänglighetsdata samt KWHotel Integrations API för att slå upp bokningar.
Vad integrationen ger
När KWHotel-integrationen är aktiverad kan din chattbot:
- Visa rumstyper med beskrivningar, kapacitet, yta och foton
- Hitta lediga rum för ett visst datumintervall med priser
- Kontrollera tillgänglighet för ett specifikt rum och datumintervall
- Skapa nya bokningar med gästuppgifter
- Slå upp befintliga bokningar
Förutsättningar
Innan du konfigurerar integrationen ska du se till att du har:
- Ett KWHotel-konto med GuestSage booking engine aktiverat
- Ditt Hotel ID (UUID) från GuestSage booking engine
- Ditt Integrations Hotel ID (numeriskt) och din Integrations API Key utfärdade av KWHotel
- Ett ChatLab-konto med ett Standard- eller Premium-abonnemang, eller tillägget Travel Integrations
Hitta ditt Hotel ID (UUID)
Ditt Hotel ID är ett UUID som tilldelats ditt boende i GuestSage booking engine.
- Logga in på cloud.kwhotel.com
- Gå till Modules (Moduler) > Booking Engine
- Leta reda på fältet Booking engine link under fliken General (Allmänt)
- Kopiera UUID:t från webbadressen
I länken https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 är till exempel Hotel ID 82b0085d-da1b-4443-8fde-d5d569a859e6.
Hitta dina uppgifter för Integrations API
KWHotel Integrations API använder en annan identifierare än GuestSage-UUID:t:
- Integrations Hotel ID - ett numeriskt ID (till exempel
292) - Integrations API Key - en hemlig nyckel som du genererar i KWHotel
Numeriskt Hotel ID
Du hittar det numeriska hotell-ID:t i det övre högra hörnet av KWHotels adminpanel.
Generera API-nyckeln
Du skapar API-nyckeln själv i KWHotel:
- Logga in på KWHotel och öppna modulen Synchronization (Synkronisering)
- Klicka på knappen Reset API key (Återställ API-nyckel)
- Kopiera den genererade nyckeln och klistra in den i anslutningsformuläret i ChatLab
Om du klickar på Reset API key raderas den tidigare nyckeln (om en redan hade genererats) och en ny skapas. Alla andra system som använder den tidigare nyckeln slutar fungera tills du uppdaterar dem med det nya värdet.
Konfigurera integrationen i ChatLab
Steg 1: Gå till fliken Connect
- Logga in i din ChatLab-adminpanel
- Välj den bot du vill konfigurera
- Gå till fliken Connect (Anslut)
- Leta upp och klicka på KWHotel i listan över integrationer
Steg 2: Fyll i anslutningsuppgifter
Fyll i formuläret:
- Hotel ID (UUID) - ditt hotell-GUID för KWHotel från konfigurationen av GuestSage booking engine
- Default Currency (Standardvaluta) - valutan som används för priserna som visas för chattbesökare (standard är PLN)
- Default Language (Standardspråk) - språket som används för rumsbeskrivningar och erbjudandetext (standard är polska)
- Integrations Hotel ID - det numeriska hotell-ID:t för KWHotel Integrations API (annorlunda än ovanstående UUID)
- Integrations API Key - den hemliga API-nyckeln som utfärdats av KWHotel
- Discount bot channel (Rabattkanal för bot) - valfritt. När detta är inställt hämtas erbjudanden för denna rabattkanal i KWHotel och sorteras av AI:n. Lämna tomt för att använda standardkanalen.
Steg 3: Anslut
- När fälten är ifyllda blir knappen Connect (Anslut) aktiv
- Klicka på Connect för att spara konfigurationen. ChatLab testar anslutningen mot GuestSage och mot Integrations API.
- När det lyckas visas en bekräftelse.
Efter en lyckad anslutning ändras knappen Connect till Update Chatbot (Uppdatera chattbot), och knappen Disconnect (Koppla från) visas så att du kan stänga av integrationen senare.
Om kontrollen av Integrations API misslyckas vid sparandet inaktiveras åtgärden Get reservation automatiskt. Ange rätt inloggningsuppgifter igen och klicka på Update Chatbot för att aktivera den.
Konfigurera AI-åtgärder
När din KWHotel-integration är ansluten kan du ställa in vilka AI-åtgärder din chattbot ska kunna utföra.
Tillgängliga AI-åtgärder
- KWHotel - get rooms - Visar rumstyper med beskrivningar, sängkonfiguration, yta, kapacitet och foton
- KWHotel - find available rooms - Söker efter lediga rum för ett visst datumintervall och visar erbjudanden med priser
- KWHotel - check room availability - Kontrollerar tillgänglighet för en viss rumstyp och ett visst datumintervall
- KWHotel - create reservation - Skapar en ny bokning med gästuppgifter och bokningsinformation
- KWHotel - get reservation - Slår upp befintliga bokningar
Aktivera och anpassa åtgärder
- När du har anslutit klickar du på Configure AI Actions (Konfigurera AI-åtgärder) i bekräftelserutan, eller går till Bot Settings > Actions (Botinställningar > Åtgärder) och letar upp kategorin KWHotel
- Aktivera de åtgärder du vill använda med reglagen
- Anpassa åtgärdens etikett (texten som visas för användare medan åtgärden körs) och instruktionerna i prompten efter behov
- Klicka på Save (Spara) för att tillämpa ändringarna
Bästa praxis
Optimera chattbotens svar
- Träna din bot med information om boendet - Lägg till beskrivningar av dina rum och hotellets faciliteter i kunskapsbasen, inklusive bekvämligheter, läge, närliggande sevärdheter och regler för in- och utcheckning
- Skapa tydliga konversationsflöden - Konfigurera välkomstmeddelanden som vägleder gästerna att fråga om tillgänglighet, och använd förslag på frågor som "Kontrollera lediga rum" eller "Visa rum"
- Lägg till rumsspecifika sidor - Skapa särskilda sidor för varje rumstyp på din webbplats och träna chattboten med deras webbadresser för mer utförliga svar
Integration med bokningsmotor
- KWHotel-integrationen fungerar via GuestSage booking engine för rumsutbud och priser
- För direkta bokningar utanför chatten kan du bädda in bokningswidgeten från GuestSage på din webbplats vid sidan av ChatLab-chattboten - chattboten kan sedan vägleda gäster till bokningssidan när de är redo att boka
Felsökning
- Anslutningen misslyckas - Kontrollera att ditt Hotel ID är ditt UUID för GuestSage (inte det numeriska Integrations ID:t) och att ditt boende är aktivt i GuestSage booking engine
- Åtgärden Get reservation förblir avstängd - Om anslutningstestet för Integrations API misslyckas vid sparandet inaktiveras åtgärden automatiskt. Fyll i Integrations Hotel ID och Integrations API Key igen och klicka på Update Chatbot.
- Ingen rumsdata returneras - Kontrollera att dina rumstyper är korrekt konfigurerade i KWHotel med beskrivningar och att tillgängligheten är publicerad i GuestSage
- Felaktiga priser eller inga erbjudanden - Priserna hämtas från GuestSage. Uppdatera priser och inställningar för erbjudanden i KWHotel för att spegla aktuella priser. Om du har angett en Discount bot channel måste du se till att den har aktiva erbjudanden.
- Integrationen är inte tillgänglig i adminpanelen - KWHotel-integrationen kräver ett Standard- eller Premium-abonnemang i ChatLab, eller tillägget Travel Integrations