Kapcsolja össze ChatLab chatbotját a KWHotel ingatlankezelő rendszerével (PMS), hogy valós idejű szoba elérhetőséget, foglalást és foglaláskeresést biztosítson weboldala látogatóinak. Az integráció a GuestSage foglalómotort használja a szoba- és elérhetőségi adatokhoz, valamint a KWHotel Integrations API-t a meglévő foglalások lekérdezéséhez.
Mit nyújt az integráció?
A KWHotel integráció bekapcsolásával a chatbot az alábbiakra képes:
- Szobatípusok listázása leírással, kapacitással, alapterülettel és fényképekkel
- Szabad szobák keresése egy adott dátumtartományra árakkal együtt
- Adott szoba elérhetőségének ellenőrzése egy meghatározott időszakra
- Új foglalások létrehozása a vendég adataival
- Meglévő foglalások keresése és lekérdezése
Előfeltételek
Az integráció beállítása előtt győződjön meg arról, hogy rendelkezik az alábbiakkal:
- Aktív KWHotel fiók engedélyezett GuestSage foglalómotorral
- A GuestSage foglalómotorból származó Hotel ID (UUID) azonosító
- A KWHotel által kiadott Integrations Hotel ID (számszerű azonosító) és Integrations API Key (API-kulcs)
- ChatLab fiók STANDARD vagy PREMIUM csomagban, vagy Travel Integrations kiegészítővel
A Hotel ID (UUID) megkeresése
A Hotel ID a GuestSage foglalómotorban a szálláshelyéhez rendelt UUID azonosító.
- Jelentkezzen be a cloud.kwhotel.com felületre
- Lépjen a Modules > Booking Engine menüpontra
- A General fülön keresse meg a Booking engine link mezőt
- Másolja ki az UUID-t az URL-ből
Például a https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 linkben a Hotel ID a következő: 82b0085d-da1b-4443-8fde-d5d569a859e6.
Az Integrations API hitelesítési adatainak megkeresése
A KWHotel Integrations API más azonosítót használ, mint a GuestSage UUID:
- Integrations Hotel ID - egy numerikus azonosító (például
292) - Integrations API Key - egy titkos kulcs, amelyet Ön generál a KWHotelben
Számszerű Hotel ID
A számszerű Hotel ID a KWHotel adminisztrációs felületének jobb felső sarkában található.
Az API-kulcs generálása
Az API-kulcsot Önnek kell legenerálnia a KWHotel rendszerében:
- Jelentkezzen be a KWHotelbe, és nyissa meg a Synchronization modult
- Kattintson a Reset API key (API-kulcs visszaállítása) gombra
- Másolja ki a generált kulcsot, és illessze be a ChatLab kapcsolati űrlapjába
A Reset API key gombra kattintva törli az előző kulcsot (ha már létezett ilyen), és újat hoz létre. Bármely más rendszer, amely a korábbi kulcsot használta, leáll, amíg nem frissíti benne az új értéket.
Az integráció beállítása a ChatLabban
1. lépés: Lépjen a Connect fülre
- Jelentkezzen be a ChatLab adminisztrációs felületére
- Válassza ki a konfigurálni kívánt botot
- Lépjen a Connect (Csatlakozás) fülre
- Keresse meg a KWHotel elemet az integrációk listájában, majd kattintson rá
2. lépés: Adja meg a kapcsolati adatokat
Töltse ki az űrlap mezőit:
- Hotel ID (UUID) - a KWHotel szálláshely GUID azonosítója a GuestSage foglalómotor beállításaiból
- Default Currency - a csevegő felhasználóknak megjelenített árak alapértelmezett pénzneme (alapértelmezés szerint PLN)
- Default Language - a szobaleírások és ajánlatszövegek alapértelmezett nyelve (alapértelmezés szerint lengyel)
- Integrations Hotel ID - a KWHotel Integrations API számszerű szálláshely-azonosítója (eltér a fenti UUID-től)
- Integrations API Key - a KWHotel által kiadott titkos API-kulcs
- Discount bot channel - opcionális. Ha be van állítva, a rendszer ebből a KWHotel kedvezménycsatornából gyűjti be az ajánlatokat, és az AI rendezi őket. Hagyja üresen az alapértelmezett csatorna használatához.
3. lépés: Csatlakozás
- A mezők kitöltése után a Connect (Csatlakozás) gomb aktívvá válik
- Kattintson a Connect gombra a beállítások mentéséhez. A ChatLab teszteli a GuestSage kapcsolatot és az Integrations API elérését.
- Sikeres kapcsolódás esetén egy megerősítő értesítés jelenik meg.
A sikeres csatlakozást követően a Connect gomb felirata Update Chatbot (Chatbot frissítése) értékre változik, valamint megjelenik a Disconnect (Kapcsolat bontása) gomb is, amellyel később kikapcsolhatja az integrációt.
Ha az Integrations API ellenőrzése sikertelen a mentés során, a Get reservation művelet automatikusan kikapcsol. Adja meg újra a helyes adatokat, majd kattintson az Update Chatbot gombra az engedélyezéshez.
Az AI-műveletek beállítása
Miután csatlakoztatta a KWHotel integrációt, testreszabhatja, hogy a chatbot mely AI-műveleteket hajthatja végre.
Elérhető AI-műveletek
- KWHotel - get rooms - Listázza a szobatípusokat leírással, ágyelrendezéssel, alapterülettel, kapacitással és képekkel
- KWHotel - find available rooms - Szabad szobákat keres a megadott időszakra, és árakat tartalmazó ajánlatokat ad vissza
- KWHotel - check room availability - Ellenőrzi egy adott szobatípus elérhetőségét egy megadott időszakra
- KWHotel - create reservation - Új foglalást hoz létre a vendég és a foglalás adataival
- KWHotel - get reservation - Meglévő foglalások lekérdezése
Műveletek engedélyezése és testreszabása
- A csatlakozás után kattintson a Configure AI Actions (AI-műveletek beállítása) gombra a sikeres mentést jelző ablakban, vagy lépjen a Bot Settings > Actions (Botbeállítások > Műveletek) menüponthoz, és keresse meg a KWHotel kategóriát
- Kapcsolja be a kívánt műveleteket
- Igény szerint módosítsa a művelet címkéjét (a felhasználónak megjelenő szöveg, miközben a művelet fut) és a promptutasításokat
- Kattintson a Save (Mentés) gombra a változtatások érvénybe léptetéséhez
Bevált gyakorlatok
A chatbot válaszainak optimalizálása
- Tréningezze a botot a szálláshely adataival - Adja hozzá a szobák és a szálloda létesítményeinek leírását a tudásbázishoz, beleértve a felszereltséget, az elhelyezkedést, a közeli látnivalókat, valamint a be- és kijelentkezési szabályzatot
- Állítson be egyértelmű beszélgetésmeneteket - Állítson be olyan üdvözlő üzeneteket, amelyek arra ösztönzik a vendégeket, hogy kérdezzenek az elérhetőségről, és használjon olyan javasolt kérdéseket, mint például: "Szoba elérhetőségének ellenőrzése" vagy "Szobák megtekintése"
- Adjon hozzá szobaspecifikus oldalakat - Hozzon létre külön aloldalt minden szobatípusnak a weboldalán, és tanítsa meg a chatbotnak ezeket az URL-eket a tartalmasabb válaszok érdekében
A foglalómotor integrációja
- A KWHotel integráció a készlet- és áradatok eléréséhez a GuestSage foglalómotort használja
- A csevegésen kívüli, közvetlen szobafoglaláshoz ágyazza be a GuestSage foglalási widgetet a weboldalára a ChatLab chatbot mellé - a chatbot a foglalási oldalra tudja irányítani a vendégeket, amint készen állnak a foglalásra
Hibaelhárítás
- Sikertelen kapcsolódás - Ellenőrizze, hogy a Hotel ID valóban a GuestSage UUID azonosítója (nem pedig a numerikus Integrations ID), és hogy a szálláshely aktív-e a GuestSage foglalómotorban
- A Get reservation művelet kikapcsolva marad - Ha az Integrations API kapcsolat tesztelése mentéskor meghiúsul, a művelet automatikusan kikapcsol. Adja meg újra az Integrations Hotel ID és az Integrations API Key értékét, majd kattintson az Update Chatbot gombra.
- Nem érkeznek szobaadatok - Ellenőrizze, hogy a szobatípusok megfelelően be vannak-e állítva leírásokkal a KWHotelben, és hogy az elérhetőség publikálva van-e a GuestSage rendszerben
- Helytelen árak vagy hiányzó ajánlatok - Az árak a GuestSage-ből származnak. Frissítse az árakat és az ajánlati beállításokat a KWHotelben, hogy a valós árak jelenjenek meg. Ha beállított Discount bot channel értéket, győződjön meg róla, hogy tartoznak hozzá aktív ajánlatok.
- Az integráció nem érhető el az adminisztrációs felületen - A KWHotel integrációhoz STANDARD vagy PREMIUM ChatLab csomag, illetve Travel Integrations kiegészítő szükséges