Integracija sa KWHotel sistemom

Povežite svoj ChatLab chatbot sa Vašim KWHotel sistemom za upravljanje objektima (property management system) kako biste posetiocima veb-sajta pružili uvid u dostupnost soba u realnom vremenu, rezervaciju i pretragu postojećih rezervacija. Integracija koristi GuestSage booking engine za podatke o sobama i dostupnosti, kao i KWHotel Integrations API za pretragu rezervacija.

Primer razgovora

Primer prikazuje korisničko iskustvo. Dostupne radnje i vraćene informacije zavise od ove integracije i Vaše konfiguracije.

Šta ova integracija pruža

Kada je integracija sa KWHotel aktivirana, Vaš chatbot može da:

• Prikazuje tipove soba sa opisima, kapacitetom, površinom i fotografijama
• Pronalazi slobodne sobe za zadati raspon datuma sa cenama
• Proverava dostupnost za određenu sobu i raspon datuma
• Kreira nove rezervacije sa podacima o gostima
• Pronalazi postojeće rezervacije

---

Preduslovi

Pre podešavanja integracije, uverite se da imate:

• KWHotel nalog sa aktiviranim GuestSage booking engine-om
• Vaš Hotel ID (UUID) iz GuestSage booking engine-a
• Za pretragu rezervacija: Vaš Integrations Hotel ID (numerički) i Integrations API Key koje izdaje KWHotel
• ChatLab pretplatu koja uključuje funkciju integracije sa KWHotel-om

---

Pronalaženje Vašeg Hotel ID-ja (UUID)

Hotel ID je UUID dodeljen Vašem objektu u okviru GuestSage booking engine-a.

1. Prijavite se na cloud.kwhotel.com
2. Idite na Modules (Moduli) > Booking Engine
3. U kartici General (Opšte), pronađite polje Booking engine link
4. Kopirajte UUID iz URL adrese

Na primer, u linku https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 Hotel ID je 82b0085d-da1b-4443-8fde-d5d569a859e6.

---

Pronalaženje pristupnih podataka za Integrations API

KWHotel Integrations API koristi drugačiji identifikator u odnosu na GuestSage UUID:

• Integrations Hotel ID - numerički ID (na primer 292)
• Integrations API Key - tajni ključ koji sami generišete u KWHotel-u

Numerički Hotel ID

Numerički Hotel ID možete pronaći u gornjem desnom uglu KWHotel kontrolne table.

Generisanje API ključa

API ključ generišete sami unutar KWHotel-a:

1. Prijavite se na KWHotel i otvorite modul Synchronization (Sinhronizacija)
2. Kliknite na dugme Reset API key (Resetuj API ključ)
3. Kopirajte generisani ključ i nalepite ga u formular za povezivanje u ChatLab-u

Klikom na Reset API key uklanja se prethodni ključ (ako je već postojao) i kreira novi. Bilo koji drugi sistem koji koristi prethodni ključ prestaće da radi sve dok ga ne ažurirate novom vrednošću.

---

Podešavanje integracije u ChatLab-u

1. korak: Idite na karticu Connect

1. Prijavite se na svoju ChatLab kontrolnu tablu
2. Izaberite bota kojeg želite da konfigurišete
3. Otvorite karticu Connect (Poveži)
4. Pronađite i kliknite na KWHotel na listi integracija

2. korak: Unesite podatke za povezivanje

Popunite formular za povezivanje:

• Hotel ID (UUID) - Vaš KWHotel GUID hotela iz konfiguracije GuestSage booking engine-a
• Default Currency (Podrazumevana valuta) - valuta koja se koristi za prikaz cena korisnicima u ćaskanju (podrazumevano je PLN)
• Default Language (Podrazumevani jezik) - jezik koji se koristi za opise soba i tekst ponuda (podrazumevano je poljski)
• Integrations Hotel ID - numerički ID hotela za KWHotel Integrations API (razlikuje se od gorenavedenog UUID-ja)
• Integrations API Key - tajni API ključ koji izdaje KWHotel
• Discount bot channel (Kanal za popuste bota) - opciono. Kada je podešeno, ponude se preuzimaju za ovaj KWHotel kanal sa popustom i AI ih sortira. Ostavite prazno da biste koristili podrazumevani kanal.

3. korak: Povežite se

1. Kada popunite polja, dugme Connect (Poveži) postaće aktivno
2. Kliknite na Connect da biste sačuvali konfiguraciju. ChatLab testira vezu sa GuestSage-om i sa Integrations API-jem.
3. Nakon uspešnog povezivanja, videćete obaveštenje o potvrdi.

Nakon uspešnog povezivanja, dugme Connect menja se u Update Chatbot (Ažuriraj chatbota), a pojavljuje se i dugme Disconnect (Prekini vezu) kako biste kasnije mogli da deaktivirate integraciju.

Ako provera Integrations API-ja ne uspe prilikom čuvanja, radnja Get reservation se automatski onemogućava. Ponovo unesite ispravne podatke i kliknite na Update Chatbot da biste je omogućili.

---

Dodatne opcije povezivanja

Opcija Suggest alternative dates when nothing is available for the requested dates (Predloži alternativne datume kada ništa nije dostupno za tražene datume) podrazumevano je uključena: pretraga može ponuditi obližnje datume kada traženi boravak nije dostupan. Proverite datume za svaku ponuđenu opciju.

Ukoliko imate više objekata, omogućite opciju za više hotela i dodajte svaki hotel sa jasnim nazivom za prikaz, njegovim UUID-jem i opcionim podešavanjima specifičnim za taj objekat. Dodajte odgovarajuće podatke za Integrations API ako je potrebna pretraga rezervacija. Sačuvajte pomoću Connect ili Update Chatbot, a zatim testirajte svaki objekat pojedinačno.

Konfigurisanje AI radnji

Povezivanjem se omogućavaju radnje za pregled soba i proveru dostupnosti. Za pretragu rezervacija takođe su potrebni ispravni pristupni podaci za Integrations API. Kreiranje rezervacija nije automatski omogućeno; proverite koje radnje treba da budu aktivne pre nego što bota učinite javno dostupnim.

Dostupne AI radnje

• KWHotel - get rooms - Prikazuje tipove soba sa opisima, rasporedom kreveta, površinom, kapacitetom i fotografijama
• KWHotel - find available rooms - Pretražuje slobodne sobe za zadati raspon datuma i prikazuje ponude sa cenama
• KWHotel - check room availability - Proverava dostupnost za određeni tip sobe i raspon datuma
• KWHotel - create reservation - Kreira novu rezervaciju sa podacima o gostu i informacijama o boravku
• KWHotel - get reservation - Pronalazi postojeće rezervacije

Omogućavanje i prilagođavanje radnji

1. Nakon povezivanja, kliknite na Configure AI Actions (Konfiguriši AI radnje) u iskačućem prozoru za potvrdu, ili idite na Settings > Actions (Podešavanja > Radnje) i pronađite kategoriju KWHotel
2. Uključite radnje koje želite da omogućite
3. Prilagodite oznaku radnje (tekst koji se prikazuje korisnicima dok se radnja izvršava) i uputstva za prompt po potrebi
4. Potvrdite dijalog radnje klikom na Enable (Omogući) ili Update (Ažuriraj), kao što je prikazano.

---

Testiranje završenog podešavanja

Otvorite Overview (Pregled) i zatražite sobu za buduće datume i određeni broj gostiju. Proverite objekat, datume, valutu, cenu i link za rezervaciju u poređenju sa GuestSage-om. Testirajte pretragu rezervacija koristeći rezervaciju za koju imate ovlašćenje da je proverite. Uključite Create reservation samo ako želite da chatbot kreira stvarne rezervacije i dogovorite svako testno rezervisanje sa svojim timom u objektu.

Najbolje prakse

Optimizovanje odgovora chatbota

• Trenirajte svog bota informacijama o objektu - Dodajte opise soba i sadržaja hotela u bazu znanja, uključujući pogodnosti, lokaciju, obližnje atrakcije i pravila za prijavu i odjavu
• Podesite jasne tokove razgovora - Konfigurišite poruke dobrodošlice koje vode goste ka tome da pitaju za dostupnost i koristite predložena pitanja kao što su „Proveri dostupnost soba” ili „Pogledaj sobe”
• Dodajte stranice posvećene pojedinačnim sobama - Kreirajte posebne stranice za svaki tip sobe na svom veb-sajtu i trenirajte chatbota njihovim URL adresama kako biste dobili sadržajnije odgovore

Integracija booking engine-a

• KWHotel integracija funkcioniše preko GuestSage booking engine-a za stanje kapaciteta i cene
• Za direktno dovršavanje rezervacije van ćaskanja, ugradite GuestSage widget za rezervacije na svoj veb-sajt pored ChatLab chatbota - chatbot može usmeriti goste na stranicu za rezervaciju kada budu spremni da rezervišu

---

Rešavanje problema

• Povezivanje ne uspeva - Proverite da li je Vaš Hotel ID zapravo GuestSage UUID (a ne numerički Integrations ID), kao i da li je Vaš objekat aktivan u GuestSage booking engine-u
• Radnja Get reservation ostaje isključena - Ako test povezivanja sa Integrations API-jem ne uspe prilikom čuvanja, radnja se automatski isključuje. Ponovo unesite Integrations Hotel ID i Integrations API Key i kliknite na Update Chatbot.
• Podaci o sobama se ne prikazuju - Proverite da li su tipovi soba ispravno konfigurisani u KWHotel-u sa opisima i da li je dostupnost objavljena u GuestSage-u
• Netačne cene ili nema ponuda - Cene potiču iz GuestSage-a. Ažurirajte cenovnike i postavke ponuda u KWHotel-u kako bi odražavali važeće cene. Ako ste postavili Discount bot channel, uverite se da on ima aktivne ponude.
• Integracija nije dostupna na kontrolnoj tabli - Integracija sa KWHotel-om zahteva odgovarajuću funkciju u okviru Vaše pretplate; pratite uputstva za nadogradnju plana ili kontakt

---

Katalog soba i pregled hotela

Ako Vaš nalog prikazuje karticu Hotel, koristite Hotel > Rooms (Sobe) da biste pregledali katalog soba i status treniranja. Funkcija AI room search (AI pretraga soba) je odvojena od provera dostupnosti na osnovu datuma: ona pronalazi odgovarajuće opise soba, dok radnje za proveru dostupnosti proveravaju traženi boravak. Automatsko indeksiranje soba zavisi od automatskog indeksiranja kataloga i dodeljenog limita za indeksirane sobe; u suprotnom, koristite Train rooms (Treniraj sobe) kada je dostupno. Pregledajte omogućene radnje i sačekajte da se treniranje završi pre nego što se oslonite na AI pretragu soba.

Povezani članci

• Dodavanje chatbota na Vaš veb-sajt
• Treniranje Vašeg chatbota
• Slanje linka ka Vašem chatbotu