Povežite svoj ChatLab chatbot sa KWHotel sistemom za upravljanje objektima kako biste posetiocima svog 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.
Šta integracija pruža
Kada je KWHotel integracija omogućena, Vaš chatbot može da:
- Prikazuje tipove soba sa opisima, kapacitetom, površinom i fotografijama
- Pronalazi dostupne sobe za zadati raspon datuma sa cenama
- Proverava dostupnost za određenu sobu i raspon datuma
- Kreira nove rezervacije sa podacima o gostima
- Pronalazi i prikazuje postojeće rezervacije
Preduslovi
Pre podešavanja integracije, uverite se da imate:
- KWHotel nalog sa omogućenim sistemom GuestSage booking engine
- Vaš Hotel ID (UUID) iz GuestSage booking engine konfiguracije
- Vaš Integrations Hotel ID (numerički) i Integrations API Key koje izdaje KWHotel
- ChatLab nalog na planu STANDARD ili PREMIUM, ili sa dodatkom Travel Integrations
Pronalaženje Vašeg Hotel ID-ja (UUID)
Hotel ID je UUID dodeljen Vašem objektu u okviru GuestSage booking engine sistema.
- Prijavite se na cloud.kwhotel.com
- Otvorite Modules (Moduli) > Booking Engine
- Na kartici General (Opšte), pronađite polje Booking engine link
- 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 od GuestSage UUID-ja:
- 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 administratorskog panela.
Generisanje API ključa
API ključ generišete sami unutar KWHotel-a:
- Prijavite se na KWHotel i otvorite modul Synchronization (Sinhronizacija)
- Kliknite na dugme Reset API key (Resetuj API ključ)
- Kopirajte generisani ključ i nalepite ga u formu za povezivanje u ChatLab-u
Klikom na dugme Reset API key uklanja se prethodni ključ (ako je već postojao) i kreira se 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: Otvorite karticu Connect
- Prijavite se na svoj ChatLab administratorski panel
- Izaberite bota kojeg želite da konfigurišete
- Otvorite karticu Connect (Poveži)
- Na listi integracija pronađite i kliknite na KWHotel
2. korak: Unesite podatke za povezivanje
Popunite formu za povezivanje:
- Hotel ID (UUID) - Vaš KWHotel GUID objekta iz konfiguracije sistema GuestSage booking engine
- Default Currency (Podrazumevana valuta) - valuta koja se koristi za prikaz cena korisnicima u chatu (podrazumevano PLN)
- Default Language (Podrazumevani jezik) - jezik koji se koristi za opise soba i tekst ponude (podrazumevano 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 bota za popuste) - opciono. Kada je postavljen, ponude se preuzimaju za ovaj KWHotel kanal popusta i sortira ih AI. Ostavite prazno da biste koristili podrazumevani kanal.
3. korak: Povežite se
- Kada popunite polja, dugme Connect (Poveži) postaje aktivno
- Kliknite na Connect da biste sačuvali konfiguraciju. ChatLab testira vezu sa GuestSage-om i konekciju sa Integrations API-jem.
- Ako je povezivanje uspešno, videćete poruku potvrde (toast obaveštenje).
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 onemogućite integraciju.
Ako provera za Integrations API ne uspe prilikom čuvanja, akcija Get reservation se automatski onemogućava. Ponovo unesite ispravne podatke i kliknite na Update Chatbot da biste je omogućili.
Konfigurisanje AI akcija
Nakon što povežete KWHotel integraciju, možete da konfigurišete koje AI akcije Vaš chatbot može da izvršava.
Dostupne AI akcije
- KWHotel - get rooms - Prikazuje tipove soba sa opisima, konfiguracijom kreveta, površinom, kapacitetom i fotografijama
- KWHotel - find available rooms - Pretražuje dostupne sobe za zadati raspon datuma i vraća 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 detaljima rezervacije
- KWHotel - get reservation - Pronalazi i prikazuje postojeće rezervacije
Omogućavanje i prilagođavanje akcija
- Nakon povezivanja, kliknite na Configure AI Actions (Konfiguriši AI akcije) u modalnom prozoru potvrde, ili idite na Bot Settings > Actions (Podešavanja bota > Akcije) i pronađite kategoriju KWHotel
- Uključite akcije koje želite da omogućite
- Prilagodite naziv akcije (tekst koji se prikazuje korisnicima dok se akcija izvršava) i uputstva za prompt po želji
- Kliknite na Save (Sačuvaj) da biste primenili promene
Najbolje prakse
Optimizacija odgovora chatbota
- Trenirajte bota podacima o objektu - Dodajte opise soba i hotelskih sadržaja u bazu znanja, uključujući pogodnosti, lokaciju, obližnje atrakcije i pravila za prijavu i odjavu (check-in/check-out)
- Definišite jasne tokove razgovora - Podesite poruke dobrodošlice koje vode goste da se raspitaju o dostupnosti i koristite predložena pitanja kao što su "Proveri dostupnost soba" ili "Prikaži sobe"
- Dodajte stranice posvećene pojedinačnim sobama - Kreirajte posebne stranice za svaki tip sobe na svom sajtu i istrenirajte chatbota pomoću njihovih URL adresa kako biste dobili detaljnije odgovore
Integracija sa sistemom za rezervacije
- KWHotel integracija funkcioniše preko sistema GuestSage booking engine za stanje kapaciteta i cene
- Za direktno dovršavanje rezervacije van chata, postavite GuestSage booking vidžet na svoj sajt pored ChatLab chatbota - chatbot može da uputi 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) i da li je Vaš objekat aktivan u GuestSage booking engine sistemu
- Akcija Get reservation ostaje isključena - Ako test povezivanja za Integrations API ne uspe prilikom čuvanja, akcija se automatski onemogućava. Ponovo unesite Integrations Hotel ID i Integrations API Key i kliknite na Update Chatbot.
- Podaci o sobama se ne prikazuju - Proverite da li su Vaši tipovi soba ispravno konfigurisani u sistemu KWHotel sa opisima i da li je dostupnost objavljena u sistemu GuestSage
- Netačne cene ili nedostatak ponuda - Cene se preuzimaju iz GuestSage-a. Ažurirajte tarife i podešavanja ponuda u sistemu KWHotel kako bi prikazivali aktuelne cene. Ako ste postavili Discount bot channel, uverite se da on ima aktivne ponude.
- Integracija nije dostupna u administratorskom panelu - KWHotel integracija zahteva ChatLab plan STANDARD ili PREMIUM, ili dodatak Travel Integrations