Integrācija ar KWHotel

Savienojiet savu ChatLab tērzēšanas robotu ar KWHotel naktsmītņu pārvaldības sistēmu, lai vietnes apmeklētājiem reāllaikā nodrošinātu informāciju par numuru pieejamību, rezervēšanu un veikto rezervāciju meklēšanu. Integrācija izmanto GuestSage booking engine numuru un pieejamības datiem, kā arī KWHotel Integrations API rezervāciju meklēšanai.

Sarunas piemērs

Piemērs parāda klienta pieredzi. Pieejamās darbības un saņemtā informācija ir atkarīga no šīs integrācijas un Jūsu konfigurācijas.

Ko nodrošina integrācija

Kad KWHotel integrācija ir ieslēgta, Jūsu tērzēšanas robots var:

• Parādīt numuru veidu sarakstu ar aprakstiem, ietilpību, platību un fotoattēliem
• Atrast pieejamos numurus norādītajam datumu diapazonam kopā ar cenām
• Pārbaudīt konkrēta numura pieejamību konkrētam datumu diapazonam
• Izveidot jaunas rezervācijas ar viesa datiem
• Meklēt esošās rezervācijas

---

Priekšnosacījumi

Pirms integrācijas iestatīšanas pārliecinieties, ka Jums ir:

• KWHotel konts ar iespējotu GuestSage rezervēšanas dzinēju
• Jūsu Hotel ID (UUID) no GuestSage rezervēšanas dzinēja
• Rezervāciju meklēšanai: Jūsu Integrations Hotel ID (skaitlisks) un KWHotel izsniegta Integrations API Key
• ChatLab abonements, kurā ir iekļauta KWHotel integrācijas funkcija

---

Jūsu Hotel ID (UUID) atrašana

Hotel ID ir UUID, kas Jūsu naktsmītnei ir piešķirts GuestSage rezervēšanas dzinējā.

1. Piesakieties vietnē cloud.kwhotel.com
2. Dodieties uz Modules (Moduļi) > Booking Engine (Rezervēšanas dzinējs)
3. Cilnē General (Vispārīgi) atrodiet lauku Booking engine link (Rezervēšanas dzinēja saite)
4. Nokopējiet UUID no URL adreses

Piemēram, saitē https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 Hotel ID ir 82b0085d-da1b-4443-8fde-d5d569a859e6.

---

Integrations API akreditācijas datu atrašana

KWHotel Integrations API izmanto citu identifikatoru nekā GuestSage UUID:

• Integrations Hotel ID - skaitlisks ID (piemēram, 292)
• Integrations API Key - slepenā atslēga, kuru ģenerējat KWHotel vidē

Skaitliskais Hotel ID

Skaitlisko Hotel ID varat atrast KWHotel administratora paneļa augšējā labajā stūrī.

API atslēgas ģenerēšana

API atslēgu Jūs ģenerējat patstāvīgi KWHotel vidē:

1. Piesakieties KWHotel un atveriet moduli Synchronization (Sinhronizācija)
2. Noklikšķiniet uz pogas Reset API key (Atiestatīt API atslēgu)
3. Nokopējiet ģenerēto atslēgu un ielīmējiet to ChatLab savienojuma formā

Noklikšķinot uz Reset API key, tiek dzēsta iepriekšējā atslēga (ja tāda jau bija izveidota) un uzģenerēta jauna. Jebkura cita sistēma, kas izmantoja iepriekšējo atslēgu, pārtrauks darboties, līdz neatjaunināsiet to ar jauno vērtību.

---

Integrācijas iestatīšana ChatLab

1. solis: Dodieties uz cilni Connect

1. Piesakieties savā ChatLab administratora panelī
2. Izvēlieties robotu, kuru vēlaties konfigurēt
3. Dodieties uz cilni Connect (Savienot)
4. Integrāciju sarakstā atrodiet un noklikšķiniet uz KWHotel

2. solis: Ievadiet savienojuma informāciju

Aizpildiet savienojuma formu:

• Hotel ID (UUID) - Jūsu KWHotel viesnīcas GUID no GuestSage rezervēšanas dzinēja konfigurācijas
• Default Currency (Noklusējuma valūta) - valūta, ko izmanto cenu rādīšanai čata lietotājiem (noklusējums: PLN)
• Default Language (Noklusējuma valoda) - valoda, ko izmanto numuru aprakstos un piedāvājuma tekstā (noklusējums: poļu)
• Integrations Hotel ID - skaitliskais viesnīcas ID, kas paredzēts KWHotel Integrations API (atšķiras no iepriekš minētā UUID)
• Integrations API Key - slepenā API atslēga, ko izsniedz KWHotel
• Discount bot channel (Atlaižu robota kanāls) - nav obligāts. Kad tas ir iestatīts, piedāvājumi tiek iegūti šim KWHotel atlaižu kanālam un sakārtoti ar MI palīdzību. Atstājiet tukšu, lai izmantotu noklusējuma kanālu.

3. solis: Savienojiet

1. Kad lauki ir aizpildīti, poga Connect kļūst aktīva
2. Noklikšķiniet uz Connect, lai saglabātu konfigurāciju. ChatLab pārbauda GuestSage savienojumu un Integrations API savienojumu.
3. Veiksmīga savienojuma gadījumā parādīsies apstiprinājuma paziņojums.

Pēc veiksmīga savienojuma izveides poga Connect mainās uz Update Chatbot (Atjaunināt tērzēšanas robotu), kā arī parādās poga Disconnect (Atvienot), lai Jūs vēlāk varētu atspējot integrāciju.

Ja saglabāšanas laikā Integrations API pārbaude neizdodas, darbība Get reservation tiek automātiski atspējota. Ievadiet pareizus akreditācijas datus no jauna un noklikšķiniet uz Update Chatbot, lai to iespējotu.

---

Papildu savienojuma iespējas

Iespēja Suggest alternative dates when nothing is available for the requested dates (Ieteikt alternatīvus datumus, ja pieprasītajos datumos nekas nav pieejams) ir ieslēgta pēc noklusējuma: meklēšana var atgriezt tuvumā esošos datumus, ja pieprasītajā periodā vietu nav. Pārbaudiet datumus katrā piedāvājumā, kas tiek atgriezts.

Ja pārvaldāt vairākas naktsmītnes, iespējojiet vairāku viesnīcu opciju un pievienojiet katru viesnīcu ar skaidru nosaukumu, tās UUID un nepieciešamajiem konkrētās naktsmītnes iestatījumiem. Pievienojiet atbilstošos Integrations API akreditācijas datus, ja nepieciešama rezervāciju meklēšana. Saglabājiet ar Connect vai Update Chatbot, un pēc tam pārbaudiet katru naktsmītni atsevišķi.

AI Actions konfigurēšana

Pēc savienojuma izveides tiek iespējotas numuru pārlūkošanas un pieejamības darbības. Rezervāciju meklēšanai ir nepieciešami arī strādājoši Integrations API akreditācijas dati. Rezervāciju izveide netiek iespējota automātiski; pirms robota publiskošanas pārskatiet, kurām darbībām jābūt aktīvām.

Pieejamās AI Actions

• KWHotel - get rooms - Parāda numuru veidu sarakstu ar aprakstiem, gultu konfigurāciju, platību, ietilpību un fotoattēliem
• KWHotel - find available rooms - Meklē pieejamos numurus norādītajam datumu diapazonam un atgriež piedāvājumus ar cenām
• KWHotel - check room availability - Pārbauda konkrēta numura veida pieejamību norādītajā datumu diapazonā
• KWHotel - create reservation - Izveido jaunu rezervāciju ar viesa datiem un informāciju par rezervāciju
• KWHotel - get reservation - Meklē esošās rezervācijas

Darbību iespējošana un pielāgošana

1. Pēc savienojuma izveides sekmīgā rezultāta logā noklikšķiniet uz Configure AI Actions (Konfigurēt AI Actions) vai dodieties uz Settings > Actions (Iestatījumi > Darbības) un atrodiet kategoriju KWHotel
2. Ieslēdziet darbības, kuras vēlaties iespējot
3. Pielāgojiet darbības nosaukumu (tekstu, ko lietotāji redz darbības izpildes laikā) un norādes (prompt) instrukcijas pēc vajadzības
4. Apstipriniet darbības dialoglodziņu ar Enable (Iespējot) vai Update (Atjaunināt), kā parādīts.

---

Pārbaudiet pabeigto iestatīšanu

Atveriet Overview (Pārskats) un pajautājiet par numuru nākotnes datumiem un konkrētam viesu skaitam. Salīdziniet naktsmītni, datumus, valūtu, cenu un rezervācijas saiti ar datiem GuestSage sistēmā. Pārbaudiet rezervāciju meklēšanu, izmantojot rezervāciju, kuru Jums ir tiesības skatīt. Iespējojiet Create reservation tikai tad, ja vēlaties, lai tērzēšanas robots veidotu īstas rezervācijas, un saskaņojiet jebkuru rezervēšanas testu ar savas naktsmītnes personālu.

Labākā prakse

Tērzēšanas robota atbilžu optimizēšana

• Apmāciet robotu ar informāciju par naktsmītni - Pievienojiet zināšanu bāzei numuru un viesnīcas pakalpojumu aprakstus, tostarp ērtības, atrašanās vietu, tuvumā esošos apskates objektus, kā arī reģistrēšanās un izrakstīšanās noteikumus
• Iestatiet skaidru sarunas plūsmu - Konfigurējiet sagaidīšanas ziņojumus, kas mudina viesus jautāt par pieejamību, un izmantojiet ieteiktos jautājumus, piemēram, "Pārbaudīt numuru pieejamību" vai "Apskatīt numurus"
• Pievienojiet konkrētu numuru lapas - Izveidojiet savā vietnē atsevišķas lapas katram numura veidam un apmāciet tērzēšanas robotu ar to URL adresēm, lai atbildes būtu izsmeļošākas

Rezervēšanas dzinēja integrācija

• KWHotel integrācija numuru un cenu iegūšanai darbojas ar GuestSage rezervēšanas dzinēja starpniecību
• Lai rezervāciju pabeigtu tieši ārpus čata, ievietojiet GuestSage rezervēšanas logrīku savā tīmekļa vietnē līdzās ChatLab tērzēšanas robotam - robots var novirzīt viesus uz rezervēšanas lapu, tiklīdz viņi ir gatavi veikt rezervāciju

---

Problēmu novēršana

• Savienojums neizdodas - Pārliecinieties, vai Jūsu Hotel ID ir GuestSage UUID (nevis skaitliskais Integrations ID) un ka Jūsu naktsmītne ir aktīva GuestSage rezervēšanas dzinējā
• Darbība Get reservation paliek izslēgta - Ja saglabāšanas laikā Integrations API savienojuma pārbaude neizdodas, darbība tiek automātiski atspējota. Ievadiet Integrations Hotel ID un Integrations API Key vēlreiz un noklikšķiniet uz Update Chatbot.
• Netiek atgriezti numuru dati - Pārbaudiet, vai numuru veidi ir pareizi nokonfigurēti KWHotel sistēmā kopā ar aprakstiem un vai to pieejamība ir publicēta GuestSage
• Nepareizas cenas vai nav piedāvājumu - Cenas nāk no GuestSage. Atjauniniet cenas un piedāvājumu iestatījumus KWHotel, lai atspoguļotu aktuālās cenas. Ja iestatījāt Discount bot channel, pārliecinieties, ka tajā ir aktīvi piedāvājumi.
• Integrācija nav pieejama administratora panelī - KWHotel integrācijai ir nepieciešama atbilstoša funkcija Jūsu abonementā; sekojiet plāna maiņas vai saziņas norādei

---

Numuru katalogs un viesnīcas pārskats

Ja Jūsu kontā ir redzama cilne Hotel (Viesnīca), izmantojiet sadaļu Hotel > Rooms (Viesnīca > Numuri), lai pārskatītu numuru katalogu un apmācības statusu. AI room search (MI numuru meklēšana) darbojas atsevišķi no datumos balstītas pieejamības pārbaudes: tā piemeklē atbilstības numuru aprakstos, kamēr pieejamības darbības pārbauda pieprasīto uzturēšanās laiku. Automātiskā numuru indeksēšana ir atkarīga no kataloga automātiskās indeksēšanas un piešķirtā indeksējamo numuru limita; pretējā gadījumā izmantojiet Train rooms (Apmācīt numurus), kad šī opcija ir pieejama. Pirms paļauties uz MI numuru meklēšanu, pārskatiet iespējotās darbības un pagaidiet, līdz apmācība ir pabeigta.

Saistītie raksti

• Tērzēšanas robota pievienošana tīmekļa vietnei
• Tērzēšanas robota apmācība
• Saites nosūtīšana uz tērzēšanas robotu