Sujunkite savo ChatLab pokalbių robotą su KWHotel apgyvendinimo valdymo sistema, kad svetainės lankytojams realiuoju laiku pateiktumėte informaciją apie laisvus kambarius, užsakymus bei esamų rezervacijų paiešką. Integracija naudoja GuestSage booking engine kambarių ir užimtumo duomenims gauti bei KWHotel Integrations API rezervacijų paieškai atlikti.
Ką suteikia ši integracija
Įjungus KWHotel integraciją, jūsų pokalbių robotas gali:
- Pateikti kambarių tipų sąrašą su aprašymais, talpa, plotu ir nuotraukomis
- Rasti laisvus kambarius nurodytam datų intervalui kartu su kainomis
- Patikrinti konkretaus kambario užimtumą pasirinktam datų intervalui
- Sukurti naujas rezervacijas su svečių duomenimis
- Ieškoti esamų rezervacijų informacijos
Reikalavimai prieš pradedant
Prieš nustatydami integraciją, įsitikinkite, kad turite:
- KWHotel paskyrą su įjungtu GuestSage rezervavimo varikliu
- Savo Hotel ID (UUID) iš GuestSage rezervavimo variklio
- Savo Integrations Hotel ID (skaitinį) ir Integrations API Key, kuriuos suteikė KWHotel
- ChatLab paskyrą su STANDARD arba PREMIUM planu arba su priedu Travel Integrations
Kaip rasti savo Hotel ID (UUID)
Hotel ID yra UUID identifikatorius, priskirtas jūsų objektui GuestSage rezervavimo variklyje.
- Prisijunkite prie cloud.kwhotel.com
- Eikite į Modules (Moduliai) > Booking Engine (Rezervavimo variklis)
- Skirtuke General (Bendra) suraskite laukelį Booking engine link (Rezervavimo variklio nuoroda)
- Nukopijuokite UUID reikšmę iš URL adreso
Pavyzdžiui, nuorodoje https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 Hotel ID yra 82b0085d-da1b-4443-8fde-d5d569a859e6.
Kaip rasti Integrations API prisijungimo duomenis
KWHotel Integrations API naudoja kitokį identifikatorių nei GuestSage UUID:
- Integrations Hotel ID - skaitinis ID (pavyzdžiui,
292) - Integrations API Key - slaptas raktas, kurį sugeneruojate KWHotel sistemoje
Skaitinis Hotel ID
Skaitinį Hotel ID galite rasti viršutiniame dešiniajame KWHotel valdymo skydelio kampe.
API rakto generavimas
API raktą sugeneruojate patys KWHotel sistemoje:
- Prisijunkite prie KWHotel ir atidarykite modulį Synchronization (Sinchronizavimas)
- Spustelėkite mygtuką Reset API key (Iš naujo nustatyti API raktą)
- Nukopijuokite sugeneruotą raktą ir įklijuokite jį į ChatLab prijungimo formą
Paspaudus Reset API key, ankstesnis raktas pašalinamas (jei jau buvo sugeneruotas) ir sukuriamas naujas. Bet kuri kita sistema, naudojanti ankstesnį raktą, nustos veikti, kol neatnaujinsite jos naująja reikšme.
Integracijos nustatymas ChatLab sistemoje
1 žingsnis: eikite į skirtuką Connect
- Prisijunkite prie savo ChatLab valdymo skydelio
- Pasirinkite robotą, kurį norite sukonfigūruoti
- Eikite į skirtuką Connect (Prisijungti)
- Integracijų sąraše raskite ir spustelėkite KWHotel
2 žingsnis: įveskite ryšio duomenis
Užpildykite prisijungimo formą:
- Hotel ID (UUID) - jūsų KWHotel viešbučio GUID iš GuestSage rezervavimo variklio konfigūracijos
- Default Currency (Numatytoji valiuta) - valiuta, naudojama kainoms rodyti pokalbio naudotojams (numatytoji vertė - PLN)
- Default Language (Numatytoji kalba) - kalba, naudojama kambarių aprašymams ir pasiūlymų tekstams (numatytoji vertė - lenkų)
- Integrations Hotel ID - skaitinis viešbučio ID, skirtas KWHotel Integrations API (skiriasi nuo aukščiau nurodyto UUID)
- Integrations API Key - slaptas API raktas, kurį suteikė KWHotel
- Discount bot channel (Nuolaidų roboto kanalas) - pasirinktinai. Nustačius šį parametrą, pasiūlymai imami iš šio KWHotel nuolaidų kanalo ir rikiuojami DI pagalba. Palikite tuščią, jei norite naudoti numatytąjį kanalą.
3 žingsnis: prisijunkite
- Užpildžius laukelius, mygtukas Connect (Prisijungti) taps aktyvus
- Spustelėkite Connect, kad išsaugotumėte konfigūraciją. ChatLab patikrins GuestSage ir Integrations API ryšį.
- Sėkmingai prisijungus, pamatysite patvirtinimo pranešimą.
Po sėkmingo prisijungimo mygtukas Connect pasikeis į Update Chatbot (Atnaujinti pokalbių robotą), taip pat atsiras mygtukas Disconnect (Atsijungti), kad vėliau galėtumėte išjungti integraciją.
Jei išsaugant nepavyksta patikrinti Integrations API ryšio, veiksmas Get reservation (Gauti rezervaciją) bus automatiškai išjungtas. Įveskite teisingus duomenis iš naujo ir spustelėkite Update Chatbot, kad jį įjungtumėte.
DI veiksmų konfigūravimas
Prijungę KWHotel integraciją, galite nustatyti, kokius DI veiksmus pokalbių robotas galės atlikti.
Galimi DI veiksmai
- KWHotel - get rooms - pateikia kambarių tipų sąrašą su aprašymais, lovų konfigūracija, plotu, talpa ir nuotraukomis
- KWHotel - find available rooms - ieško laisvų kambarių nurodytam datų intervalui ir grąžina pasiūlymus su kainomis
- KWHotel - check room availability - patikrina konkretaus kambario tipo užimtumą pasirinktam datų intervalui
- KWHotel - create reservation - sukuria naują rezervaciją su svečio ir užsakymo duomenimis
- KWHotel - get reservation - ieško esamų rezervacijų informacijos
Veiksmų įjungimas ir pritaikymas
- Prisijungę spustelėkite Configure AI Actions (Konfigūruoti DI veiksmus) sėkmės lange arba eikite į Bot Settings > Actions (Roboto nustatymai > Veiksmai) ir raskite kategoriją KWHotel
- Įjunkite veiksmus, kuriuos norite naudoti
- Jei reikia, pritaikykite veiksmo etiketę (tekstą, rodomą naudotojams veiksmo vykdymo metu) ir raginimo instrukcijas
- Spustelėkite Save (Išsaugoti), kad pritaikytumėte pakeitimus
Geroji praktika
Pokalbių roboto atsakymų optimizavimas
- Apmokykite robotą naudodami objekto informaciją - į žinių bazę įtraukite kambarių ir viešbučio patogumų aprašymus, įskaitant paslaugas, vietovę, netoliese esančias lankytinas vietas bei atvykimo ir išvykimo taisykles
- Nustatykite aiškią pokalbio eigą - sukonfigūruokite pasisveikinimo žinutes, kurios nukreiptų svečius teirautis apie laisvus kambarius, ir naudokite siūlomus klausimus, pavyzdžiui, „Patikrinti kambarių užimtumą“ arba „Peržiūrėti kambarius“
- Pridėkite konkretiems kambariams skirtus puslapius - savo svetainėje sukurkite atskirus puslapius kiekvienam kambario tipui ir apmokykite pokalbių robotą naudodami jų URL adresus, kad atsakymai būtų išsamesni
Rezervavimo variklio integravimas
- KWHotel integracija naudoja GuestSage rezervavimo variklį kambarių likučiams ir kainoms gauti
- Norėdami leisti atlikti tiesioginį užsakymą ne pokalbio lange, įkelkite GuestSage rezervavimo valdiklį į savo svetainę šalia ChatLab pokalbių roboto - pokalbių robotas galės nukreipti svečius į rezervavimo puslapį, kai jie bus pasirengę užsisakyti
Trikčių šalinimas
- Nepavyksta prisijungti - įsitikinkite, kad jūsų Hotel ID yra GuestSage UUID (o ne skaitinis Integrations ID), ir kad jūsų objektas yra aktyvus GuestSage rezervavimo variklyje
- Veiksmas Get reservation lieka išjungtas - jei išsaugant Integrations API ryšio bandymas nepavyksta, veiksmas automatiškai išjungiamas. Iš naujo įveskite Integrations Hotel ID bei Integrations API Key ir spustelėkite Update Chatbot.
- Negrąžinami kambarių duomenys - patikrinkite, ar jūsų kambarių tipai yra tinkamai sukonfigūruoti KWHotel sistemoje su aprašymais ir ar užimtumo duomenys yra paskelbti GuestSage sistemoje
- Neteisingos kainos arba nėra pasiūlymų - kainodaros duomenys gaunami iš GuestSage. Atnaujinkite įkainius ir pasiūlymų nustatymus KWHotel sistemoje, kad jie atitiktų dabartines kainas. Jei nustatėte Discount bot channel, įsitikinkite, kad jame yra aktyvių pasiūlymų.
- Integracija nepasiekiama valdymo skydelyje - KWHotel integracijai reikalingas ChatLab STANDARD arba PREMIUM planas arba priedas Travel Integrations