Conectați chatbotul ChatLab cu sistemul dumneavoastră de property management KWHotel pentru a oferi vizitatorilor site-ului disponibilitatea camerelor în timp real, rezervări și căutarea rezervărilor existente. Integrarea utilizează motorul de rezervări GuestSage booking engine pentru datele despre camere și disponibilitate, precum și KWHotel Integrations API pentru căutarea rezervărilor.
Ce oferă integrarea
Cu integrarea KWHotel activată, chatbotul dumneavoastră poate:
- Să afișeze tipurile de camere cu descrieri, capacitate, suprafață și fotografii
- Să găsească camere disponibile pentru un anumit interval de date, împreună cu prețurile
- Să verifice disponibilitatea pentru o anumită cameră și un interval de date
- Să creeze rezervări noi cu datele oaspeților
- Să caute rezervări existente
Cerințe preliminare
Înainte de a configura integrarea, asigurați-vă că aveți:
- Un cont KWHotel cu motorul de rezervări GuestSage activat
- Codul dumneavoastră Hotel ID (UUID) din motorul de rezervări GuestSage
- Codul dumneavoastră Integrations Hotel ID (numeric) și cheia Integrations API Key emise de KWHotel
- Un cont ChatLab pe un plan Standard sau Premium, ori cu add-on-ul Travel Integrations
Găsirea Hotel ID-ului dumneavoastră (UUID)
Hotel ID este un UUID atribuit proprietății dumneavoastră în motorul de rezervări GuestSage.
- Conectați-vă la cloud.kwhotel.com
- Navigați la Modules (Module) > Booking Engine (Motor de rezervări)
- În fila General (General), identificați câmpul Booking engine link (Link motor de rezervări)
- Copiați UUID-ul din URL
De exemplu, în linkul https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6, Hotel ID este 82b0085d-da1b-4443-8fde-d5d569a859e6.
Găsirea credențialelor pentru Integrations API
KWHotel Integrations API utilizează un identificator diferit de cel UUID din GuestSage:
- Integrations Hotel ID - un ID numeric (de exemplu
292) - Integrations API Key - o cheie secretă pe care o generați în KWHotel
Hotel ID-ul numeric
Puteți găsi Hotel ID-ul numeric în colțul din dreapta sus al panoului de administrare KWHotel.
Generarea cheii API
Generați cheia API direct din KWHotel:
- Conectați-vă la KWHotel și deschideți modulul Synchronization (Sincronizare)
- Faceți clic pe butonul Reset API key (Resetare cheie API)
- Copiați cheia generată și introduceți-o în formularul de conectare din ChatLab
Făcând clic pe Reset API key veți șterge cheia anterioară (dacă fusese deja generată una) și veți crea una nouă. Orice alt sistem care utilizează cheia anterioară va înceta să funcționeze până când o actualizați cu noua valoare.
Configurarea integrării în ChatLab
Pasul 1: Navigați la fila Connect
- Conectați-vă la panoul de administrare ChatLab
- Selectați botul pe care doriți să îl configurați
- Mergeți la fila Connect (Conectare)
- Găsiți și faceți clic pe KWHotel în lista de integrări
Pasul 2: Introduceți detaliile de conectare
Completați formularul de conectare:
- Hotel ID (UUID) - GUID-ul hotelului dumneavoastră din KWHotel preluat din configurația motorului de rezervări GuestSage
- Default Currency (Monedă implicită) - moneda utilizată pentru prețurile afișate utilizatorilor pe chat (implicit PLN)
- Default Language (Limbă implicită) - limba utilizată pentru descrierile camerelor și textul ofertelor (implicit poloneză)
- Integrations Hotel ID - ID-ul numeric de hotel pentru KWHotel Integrations API (diferit de UUID-ul de mai sus)
- Integrations API Key - cheia secretă API emisă de KWHotel
- Discount bot channel (Canal de reduceri pentru bot) - opțional. Când este setat, ofertele sunt preluate pentru acest canal de reduceri din KWHotel și sortate de AI. Lăsați necompletat pentru a utiliza canalul implicit.
Pasul 3: Conectați-vă
- După ce câmpurile sunt completate, butonul Connect (Conectare) devine activ
- Faceți clic pe Connect pentru a salva configurația. ChatLab testează conexiunea GuestSage și conexiunea la Integrations API.
- În caz de reușită, veți vedea un mesaj de confirmare de tip toast.
După o conexiune reușită, butonul Connect se transformă în Update Chatbot (Actualizare chatbot), și va apărea butonul Disconnect (Deconectare) pentru a putea dezactiva integrarea ulterior.
Dacă verificarea Integrations API eșuează la salvare, acțiunea Get reservation este dezactivată automat. Introduceți din nou credențialele corecte și faceți clic pe Update Chatbot pentru a o activa.
Configurarea acțiunilor AI
Odată ce integrarea dumneavoastră KWHotel este conectată, puteți configura ce acțiuni AI poate efectua chatbotul dumneavoastră.
Acțiuni AI disponibile
- KWHotel - get rooms - Afișează tipurile de camere cu descrieri, configurația paturilor, suprafață, capacitate și fotografii
- KWHotel - find available rooms - Caută camere disponibile pentru un anumit interval de date și returnează oferte cu prețuri
- KWHotel - check room availability - Verifică disponibilitatea pentru un anumit tip de cameră și interval de date
- KWHotel - create reservation - Creează o nouă rezervare cu detaliile oaspetelui și informațiile sejurului
- KWHotel - get reservation - Caută rezervări existente
Activarea și personalizarea acțiunilor
- După conectare, faceți clic pe Configure AI Actions (Configurare acțiuni AI) în fereastra modală de succes, sau navigați la Bot Settings > Actions (Setări bot > Acțiuni) și căutați categoria KWHotel
- Comutați acțiunile pe care doriți să le activați
- Personalizați eticheta acțiunii (textul afișat utilizatorilor în timp ce acțiunea se execută) și instrucțiunile din prompt, după cum este necesar
- Faceți clic pe Save (Salvare) pentru a aplica modificările
Bune practici
Optimizarea răspunsurilor chatbotului
- Antrenați botul cu informații despre proprietate - Adăugați în baza de cunoștințe descrieri ale camerelor și ale facilităților hotelului, inclusiv dotări, locație, atracții din apropiere și politicile de check-in/check-out
- Stabiliți fluxuri clare de conversație - Configurați mesaje de întâmpinare care să orienteze oaspeții să întrebe despre disponibilitate și folosiți întrebări sugerate precum „Verifică disponibilitatea camerelor” sau „Vezi camerele”
- Adăugați pagini dedicate camerelor - Creați pagini specifice pentru fiecare tip de cameră pe site-ul dumneavoastră web și antrenați chatbotul cu URL-urile acestora pentru a oferi răspunsuri mai detaliate
Integrarea motorului de rezervări
- Integrarea KWHotel funcționează prin motorul de rezervări GuestSage pentru stocul de camere și prețuri
- Pentru finalizarea directă a rezervării în afara chatului, integrați widgetul de rezervare GuestSage pe site-ul dumneavoastră web alături de chatbotul ChatLab - chatbotul poate ghida oaspeții către pagina de rezervare atunci când sunt gata să rezerve
Depanare
- Conexiunea eșuează - Verificați dacă Hotel ID-ul dumneavoastră este UUID-ul din GuestSage (nu cel numeric din Integrations ID) și dacă proprietatea dumneavoastră este activă în motorul de rezervări GuestSage
- Acțiunea Get reservation rămâne dezactivată - Dacă testul de conexiune la Integrations API eșuează la salvare, acțiunea este dezactivată automat. Introduceți din nou valorile pentru Integrations Hotel ID și Integrations API Key, apoi faceți clic pe Update Chatbot.
- Nu se returnează date despre camere - Verificați dacă tipurile de camere sunt configurate corect în KWHotel, cu descrieri, și dacă disponibilitatea este publicată în GuestSage
- Prețuri incorecte sau lipsă oferte - Prețurile provin din GuestSage. Actualizați tarifele și setările ofertelor în KWHotel pentru a reflecta prețurile actuale. Dacă ați setat un Discount bot channel, asigurați-vă că acesta conține oferte active.
- Integrarea nu este disponibilă în panoul de administrare - Integrarea KWHotel necesită un plan ChatLab Standard sau Premium, ori add-on-ul Travel Integrations