Pagalbos centras
Chatboto integracijos

Integracija su KWHotel

Paskutinį kartą atnaujinta:

Sujunkite savo ChatLab pokalbių robotą su KWHotel apgyvendinimo valdymo sistema, kad svetainės lankytojams realiuoju laiku pateiktumėte kambarių užimtumą, užsakymus ir esamų rezervacijų peržiūrą. Integracija naudoja GuestSage booking engine kambarių ir užimtumo duomenims gauti bei KWHotel Integrations API rezervacijų paieškai.

Pokalbio pavyzdys

Pamatykite tai pokalbyje

Nuo kelionės datų iki kambarių pasiūlymų

Reikalinga palaikoma apgyvendinimo integracija ir įjungtas užimtumo tikrinimo veiksmas. Pasiūlymas ar užklausa nepatvirtina rezervacijos.

ChatLab pavyzdysIliustracinis pokalbis

Lankytojas: Kambarys dviem suaugusiems, rugpjūčio 14-16 d.

Paleiskite pavyzdį arba perskaitykite jį žemiau. Tikri klientų duomenys nenaudojami.
1 / 6

Surinkite viešnagės reikalavimus.

Atkūrimas sustabdomas, kai šis pavyzdys dingsta iš ekrano. Tai simuliacija, o ne tiesioginis pokalbis. Atkūrimo metu widget mygtukai ir kiti valdymo elementai nėra interaktyvūs.
Perskaityti visą pavyzdį
  1. Surinkite viešnagės reikalavimus.

    Lankytojas: Kambarys dviem suaugusiems, rugpjūčio 14-16 d.

  2. Prieš atlikdami paiešką, pasiteiraukite trūkstamos informacijos apie datas.

    Asistentas: Kurių metų viešnagę planuojate?

  3. Svečias nurodo metus.

    Lankytojas: 2027.

  4. Pateikite užklausą prijungtai apgyvendinimo sistemai.

    Tikrinamas kambarių užimtumas...

  5. Pateikite gautus šios viešnagės pasiūlymus.

    Dvivietis kambarys su vaizdu į jūrą, €280 / stay. Pavyzdinis pasiūlymas dviem suaugusiems, dviem naktims.

  6. Tęskite naudodami integracijos palaikomą rezervacijos procesą.

    Asistentas: Peržiūrėkite rezervacijos puslapį, kad sužinotumėte galutinę kainą ir sąlygas. Šioje demonstracijoje rezervacija nebuvo atlikta.

Pavyzdyje parodyta kliento patirtis. Galimi veiksmai ir pateikiama informacija priklauso nuo šios integracijos ir Jūsų konfigūracijos.

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ą pasirinktame datų intervale
  • Sukurti naujas rezervacijas su svečių duomenimis
  • Peržiūrėti esamas rezervacijas

Būtinosios sąlygos

Prieš nustatydami integraciją įsitikinkite, kad turite:

  • KWHotel paskyrą su įjungtu GuestSage booking engine
  • Savo Hotel ID (UUID) iš GuestSage booking engine
  • Rezervacijų paieškai: savo Integrations Hotel ID (skaitinį) ir Integrations API Key, kuriuos išdavė KWHotel
  • ChatLab prenumeratą, į kurią įeina KWHotel integracijos funkcija

Kaip rasti savo Hotel ID (UUID)

Hotel ID yra UUID, priskirtas Jūsų apgyvendinimo įstaigai GuestSage booking engine sistemoje.

  1. Prisijunkite prie cloud.kwhotel.com
  2. Eikite į Modules (Moduliai) > Booking Engine
  3. Skirtuke General (Bendra) suraskite lauką Booking engine link (Užsakymų variklio nuoroda)
  4. Nukopijuokite UUID iš URL adreso

Kaip rasti Hotel ID KWHotel sistemoje|width=60

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į susigeneruojate KWHotel sistemoje

Skaitinis Hotel ID

Skaitinį Hotel ID galite rasti viršutiniame dešiniajame KWHotel valdymo skydelio kampe.

Skaitinis Hotel ID KWHotel valdymo skydelyje|width=31

API rakto generavimas

API raktą susigeneruojate patys KWHotel sistemoje:

  1. Prisijunkite prie KWHotel ir atidarykite modulį Synchronization (Sinchronizavimas)
  2. Spustelėkite mygtuką Reset API key (Iš naujo nustatyti API raktą)
  3. Nukopijuokite sugeneruotą raktą ir įklijuokite jį į ChatLab prijungimo formą

REST API rakto generavimas KWHotel sistemoje|width=19

Sugeneruotas REST API raktas|width=60

Spustelėjus Reset API key, ankstesnis raktas pašalinamas (jei toks 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 veiksmas: eikite į skirtuką Connect

  1. Prisijunkite prie savo ChatLab valdymo skydelio
  2. Pasirinkite robotą, kurį norite sukonfigūruoti
  3. Eikite į skirtuką Connect (Prijungti)
  4. Integracijų sąraše raskite ir spustelėkite KWHotel

2 veiksmas: įveskite prisijungimo duomenis

Užpildykite prijungimo formą:

  • Hotel ID (UUID) - Jūsų KWHotel viešbučio GUID iš GuestSage booking engine konfigūracijos
  • Default Currency (Numatytoji valiuta) - valiuta, naudojama pokalbio naudotojams rodomoms kainoms (numatytoji reikšmė - PLN)
  • Default Language (Numatytoji kalba) - kalba, naudojama kambarių aprašymams ir pasiūlymų tekstams (numatytoji reikšmė - lenkų)
  • Integrations Hotel ID - skaitinis viešbučio ID, skirtas KWHotel Integrations API (skiriasi nuo anksčiau nurodyto UUID)
  • Integrations API Key - slaptas API raktas, išduotas KWHotel
  • Discount bot channel (Nuolaidų roboto kanalas) - pasirinktinai. Kai nurodyta, pasiūlymai gaunami šiam KWHotel nuolaidų kanalui ir surikiuojami dirbtinio intelekto. Palikite tuščią, jei norite naudoti numatytąjį kanalą.

3 veiksmas: prijunkite

  1. Užpildžius laukus, mygtukas Connect (Prijungti) tampa aktyvus
  2. Spustelėkite Connect, kad išsaugotumėte konfigūraciją. ChatLab patikrina ryšį su GuestSage ir Integrations API.
  3. Sėkmės atveju pamatysite patvirtinimo pranešimą.

Sėkmingai prisijungus, mygtukas Connect pasikeičia į Update Chatbot (Atnaujinti pokalbių robotą), taip pat atsiranda mygtukas Disconnect (Atsijungti), kad vėliau galėtumėte išjungti integraciją.

Jei išsaugojimo metu Integrations API patikra nepavyksta, veiksmas Get reservation (Gauti rezervaciją) yra automatiškai išjungiamas. Įveskite teisingus duomenis iš naujo ir spustelėkite Update Chatbot, kad jį įjungtumėte.


Papildomos ryšio parinktys

Parinktis Suggest alternative dates when nothing is available for the requested dates (Pasiūlyti alternatyvias datas, kai pageidaujamomis datomis nieko nėra) yra įjungta pagal nutylėjimą: paieška gali pateikti artimas datas, jei pageidaujama viešnagė negalima. Patikrinkite kiekvieno pateikto pasiūlymo datas.

Jei valdote kelias apgyvendinimo įstaigas, įjunkite kelių viešbučių parinktį ir pridėkite kiekvieną viešbutį su aiškiu rodomu pavadinimu, jo UUID bei pasirinktiniais konkretaus objekto nustatymais. Pridėkite atitinkamus Integrations API duomenis, jei reikalinga rezervacijų paieška. Išsaugokite spustelėdami Connect arba Update Chatbot, tada išbandykite kiekvieną objektą atskirai.

AI veiksmų konfigūravimas

Prisijungus įgalinami kambarių naršymo ir užimtumo tikrinimo veiksmai. Rezervacijų paieškai taip pat reikalingi veikiantys Integrations API prisijungimo duomenys. Rezervacijų kūrimas nėra įjungiamas automatiškai; peržiūrėkite, kurie veiksmai turėtų būti aktyvūs, prieš padarydami robotą viešai prieinamą.

Galimi AI 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 pateikia pasiūlymus su kainomis
  • KWHotel - check room availability - patikrina konkretaus kambario tipo užimtumą nurodytame datų intervale
  • KWHotel - create reservation - sukuria naują rezervaciją su svečio duomenimis ir užsakymo informacija
  • KWHotel - get reservation - suranda esamas rezervacijas

Veiksmų įjungimas ir pritaikymas

  1. Prisijungę sėkmės lange spustelėkite Configure AI Actions (Konfigūruoti AI veiksmus) arba eikite į Settings > Actions (Nustatymai > Veiksmai) ir raskite kategoriją KWHotel
  2. Įjunkite norimus veiksmus perjungikliais
  3. Pagal poreikį pritaikykite veiksmo etiketę (tekstą, rodomą naudotojams veiksmo vykdymo metu) ir prompt instrukcijas
  4. Patvirtinkite veiksmų dialogo langą spustelėdami Enable (Įjungti) arba Update (Atnaujinti), kaip parodyta.

Užbaigtos sąrankos išbandymas

Atidarykite Overview (Apžvalga) ir pasiteiraukite kambario ateities datoms bei konkrečiam svečių skaičiui. Patikrinkite apgyvendinimo įstaigą, datas, valiutą, kainą ir užsakymo nuorodą pagal GuestSage duomenis. Išbandykite rezervacijos paiešką naudodami užsakymą, kurį turite teisę tikrinti. Įjunkite Create reservation tik tuo atveju, jei norite, kad pokalbių robotas kurtų tikrus užsakymus, ir suderinkite bet kokį bandomąjį užsakymą su savo apgyvendinimo įstaigos komanda.

Geroji praktika

Pokalbių roboto atsakymų optimizavimas

  • Apmokykite robotą su apgyvendinimo įstaigos informacija - į žinių bazę įtraukite savo kambarių ir viešbučio patogumų aprašymus, įskaitant patogumus, vietą, netoliese esančias lankytinas vietas bei atvykimo ir išvykimo taisykles
  • Nustatykite aiškius pokalbių srautus - sukonfigūruokite pasveikinimo pranešimus, kurie paskatintų svečius teirautis apie užimtumą, ir naudokite siūlomus klausimus, tokius kaip „Patikrinti kambarių užimtumą“ arba „Peržiūrėti kambarius“
  • Pridėkite konkrečių kambarių puslapius - savo svetainėje sukurkite atskirus puslapius kiekvienam kambario tipui ir apmokykite pokalbių robotą su jų URL adresais, kad atsakymai būtų išsamesni

Užsakymų variklio integracija

  • KWHotel integracija veikia per GuestSage booking engine kambarių užimtumo ir kainų informacijai gauti
  • Tiesioginiam rezervacijos užbaigimui ne pokalbyje įterpkite GuestSage užsakymų valdiklį savo svetainėje šalia ChatLab pokalbių roboto - pokalbių robotas gali nukreipti svečius į užsakymo puslapį, kai jie bus pasirengę rezervuoti

Trikčių šalinimas

  • Nepavyksta prisijungti - patikrinkite, ar Jūsų Hotel ID yra GuestSage UUID (o ne skaitinis Integrations ID), ir ar Jūsų apgyvendinimo įstaiga yra aktyvi GuestSage booking engine sistemoje
  • Veiksmas Get reservation lieka išjungtas - jei išsaugojimo metu Integrations API ryšio patikra 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žimtumas yra paskelbtas GuestSage
  • Neteisingos kainos arba nėra pasiūlymų - kainos gaunamos iš GuestSage. Atnaujinkite įkainius ir pasiūlymų nustatymus KWHotel sistemoje, kad jie atspindėtų dabartines kainas. Jei nustatėte Discount bot channel, įsitikinkite, kad jame yra aktyvių pasiūlymų.
  • Integracija nepasiekiama valdymo skydelyje - KWHotel integracijai reikalinga atitinkama funkcija Jūsų prenumeratoje; vadovaukitės plano atnaujinimo arba susisiekimo raginimu

Kambarių katalogas ir viešbučio apžvalga

Jei Jūsų paskyroje rodomas skirtukas Hotel (Viešbutis), naudokite Hotel > Rooms (Viešbutis > Kambariai), kad peržiūrėtumėte kambarių katalogą ir apmokymo būseną. AI room search (AI kambarių paieška) veikia atskirai nuo datomis pagrįstų užimtumo patikrų: ji sutapatina kambarių aprašymus, o užimtumo veiksmai tikrina pageidaujamą viešnagę. Automatinis kambarių indeksavimas priklauso nuo katalogo automatinio indeksavimo ir priskirto indeksuojamų kambarių limito; priešingu atveju naudokite Train rooms (Apmokyti kambarius), kai ši funkcija pasiekiama. Peržiūrėkite įjungtus veiksmus ir palaukite, kol apmokymas bus baigtas, prieš pasikliaudami AI room search.

Susiję straipsniai