Yhdistä ChatLab-chatbotisi KWHotel-kiinteistönhallintajärjestelmääsi (PMS) tarjotaksesi verkkosivustosi vierailijoille reaaliaikaiset huoneiden saatavuustiedot, varaukset sekä varausten haun. Integraatio käyttää GuestSage-varausmoottoria huone- ja saatavuustietoihin sekä KWHotel Integrations API:a varausten hakuun.
Mitä integraatio tarjoaa
Kun KWHotel-integraatio on käytössä, chatbotisi voi:
- Listata huonetyypit kuvauksineen, kapasiteetteineen, pinta-aloineen ja kuvineen
- Etsiä saatavilla olevia huoneita valitulle ajanjaksolle hintatietoineen
- Tarkistaa tietyn huoneen saatavuuden halutulle ajanjaksolle
- Luoda uusia varauksia vieraan tiedoilla
- Etsiä olemassa olevia varauksia
Esivaatimukset
Varmista ennen integraation käyttöönottoa, että sinulla on:
- KWHotel-tili, jossa on käytössä GuestSage-varausmoottori
- Hotel ID (UUID) GuestSage-varausmoottorista
- KWHotelin myöntämä Integrations Hotel ID (numeerinen) sekä Integrations API Key
- ChatLab-tili Standard- tai Premium-sopimuksella tai Travel Integrations -lisäosalla
Hotel ID:n (UUID) löytäminen
Hotel ID on UUID-tunniste, joka on määritetty kohteellesi GuestSage-varausmoottorissa.
- Kirjaudu sisään osoitteessa cloud.kwhotel.com
- Siirry kohtaan Modules (Moduulit) > Booking Engine (Varausmoottori)
- Etsi General (Yleiset) -välilehdeltä kenttä Booking engine link (Varausmoottorin linkki)
- Kopioi UUID URL-osoitteesta
Esimerkiksi linkissä https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 Hotel ID on 82b0085d-da1b-4443-8fde-d5d569a859e6.
Integrations API -tunnistetietojen löytäminen
KWHotel Integrations API käyttää eri tunnistetta kuin GuestSage UUID:
- Integrations Hotel ID - numeerinen tunniste (esimerkiksi
292) - Integrations API Key - salainen avain, jonka luot KWHotelissa
Numeerinen Hotel ID
Löydät numeerisen Hotel ID:n KWHotelin hallintapaneelin oikeasta yläkulmasta.
API-avaimen luominen
Luot API-avaimen itse KWHotelin sisällä:
- Kirjaudu sisään KWHoteliin ja avaa moduuli Synchronization (Synkronointi)
- Napsauta painiketta Reset API key (Nollaa API-avain)
- Kopioi luotu avain ja liitä se ChatLabin liittämislomakkeeseen
Painikkeen Reset API key napsauttaminen poistaa aiemman avaimen (jos sellainen oli jo luotu) ja luo uuden. Kaikki muut aiempaa avainta käyttävät järjestelmät lakkaavat toimimasta, kunnes päivität niihin uuden arvon.
Integraation määrittäminen ChatLabissa
Vaihe 1: Siirry Connect-välilehdelle
- Kirjaudu sisään ChatLab-hallintapaneeliisi
- Valitse botti, jonka haluat määrittää
- Siirry välilehdelle Connect (Yhdistä)
- Etsi ja napsauta integraatioluettelosta KWHotel
Vaihe 2: Syötä yhteystiedot
Täytä liittämislomake:
- Hotel ID (UUID) - KWHotel-hotellisi GUID GuestSage-varausmoottorin asetuksista
- Default Currency (Oletusvaluutta) - valuutta, jota käytetään chat-käyttäjille näytettävissä hinnoissa (oletuksena PLN)
- Default Language (Oletuskieli) - kieli, jota käytetään huonekuvauksissa ja tarjousteksteissä (oletuksena puola)
- Integrations Hotel ID - numeerinen hotellitunniste KWHotel Integrations API:a varten (eri kuin yllä oleva UUID)
- Integrations API Key - KWHotelin myöntämä salainen API-avain
- Discount bot channel - valinnainen. Kun tämä on asetettu, tarjoukset noudetaan tälle KWHotelin alennuskanavalle ja tekoäly lajittelee ne. Jätä tyhjäksi käyttääksesi oletuskanavaa.
Vaihe 3: Yhdistä
- Kun kentät on täytetty, painike Connect (Yhdistä) aktivoituu
- Napsauta Connect tallentaaksesi määritykset. ChatLab testaa sekä GuestSage-yhteyden että Integrations API -yhteyden.
- Onnistumisen jälkeen näet vahvistusilmoituksen.
Onnistuneen yhdistämisen jälkeen Connect-painike muuttuu muotoon Update Chatbot (Päivitä chatbot), ja näkyviin tulee painike Disconnect (Katkaise yhteys), jotta voit poistaa integraation käytöstä myöhemmin.
Jos Integrations API -tarkistus epäonnistuu tallennuksen yhteydessä, toiminto Get reservation poistetaan automaattisesti käytöstä. Syötä oikeat tunnistetiedot uudelleen ja ota se käyttöön napsauttamalla Update Chatbot.
Tekoälytoimintojen (AI Actions) määrittäminen
Kun KWHotel-integraatiosi on yhdistetty, voit määrittää, mitä tekoälytoimintoja chatbotisi voi suorittaa.
Saatavilla olevat tekoälytoiminnot
- KWHotel - get rooms - Listaa huonetyypit kuvauksineen, vuodekokoonpanoineen, pinta-aloineen, kapasiteetteineen ja kuvineen
- KWHotel - find available rooms - Etsii saatavilla olevia huoneita valitulle ajanjaksolle ja palauttaa tarjoukset hintatietoineen
- KWHotel - check room availability - Tarkistaa tietyn huonetyypin saatavuuden valitulle ajanjaksolle
- KWHotel - create reservation - Luo uuden varauksen vieraan tiedoilla ja varaustiedoilla
- KWHotel - get reservation - Etsii olemassa olevia varauksia
Toimintojen käyttöönotto ja mukauttaminen
- Yhdistämisen jälkeen napsauta onnistumisikkunassa Configure AI Actions (Määritä tekoälytoiminnot) tai siirry kohtaan Bot Settings > Actions (Botin asetukset > Toiminnot) ja etsi kategoria KWHotel
- Ota käyttöön haluamasi toiminnot kytkimistä
- Mukauta toiminnon nimikettä (käyttäjille toiminnon suorittamisen aikana näytettävää tekstiä) sekä prompt-ohjeita tarpeen mukaan
- Napsauta Save (Tallenna) ottaaksesi muutokset käyttöön
Parhaat käytännöt
Chatbotin vastausten optimointi
- Kouluta bottisi majoituspaikan tiedoilla - Lisää tietopohjaan kuvauksia huoneistasi ja hotellin palveluista, mukaan lukien mukavuudet, sijainti, lähistön nähtävyydet sekä sisään- ja uloskirjautumiskäytännöt
- Määritä selkeät keskustelupolut - Määritä tervetuloviestejä, jotka ohjaavat vieraita kysymään saatavuudesta, ja käytä ehdotettuja kysymyksiä, kuten "Tarkista huoneiden saatavuus" tai "Näytä huoneet"
- Lisää huonekohtaisia sivuja - Luo verkkosivustollesi omat sivut kullekin huonetyypille ja kouluta chatbotille niiden URL-osoitteet entistä kattavampien vastausten tarjoamiseksi
Varausmoottorin integraatio
- KWHotel-integraatio toimii GuestSage-varausmoottorin kautta saatavuuden ja hinnoittelun osalta
- Jos haluat suorittaa varauksen loppuun suoraan chatin ulkopuolella, upota GuestSage-varauswidget verkkosivustollesi ChatLab-chatbotin rinnalle - chatbot voi ohjata vieraat varaussivulle, kun he ovat valmiita tekemään varauksen
Vianmääritys
- Yhteys epäonnistuu - Varmista, että Hotel ID on GuestSagen UUID (ei numeerinen Integrations ID) ja että kohteesi on aktiivinen GuestSage-varausmoottorissa
- Get reservation -toiminto pysyy pois päältä - Jos Integrations API -yhteystesti epäonnistuu tallennuksen yhteydessä, toiminto poistetaan automaattisesti käytöstä. Syötä Integrations Hotel ID ja Integrations API Key uudelleen ja napsauta Update Chatbot.
- Huonetietoja ei palauteta - Tarkista, että huonetyyppisi on määritetty KWHotelissa asianmukaisesti kuvauksineen ja että saatavuus on julkaistu GuestSagessa
- Virheellinen hinnoittelu tai ei tarjouksia - Hinnoittelu tulee GuestSagesta. Päivitä hinnat ja tarjousasetukset KWHotelissa vastaamaan nykyistä hinnoittelua. Jos määritit Discount bot channel -asetuksen, varmista, että sillä on aktiivisia tarjouksia.
- Integraatio ei ole saatavilla hallintapaneelissa - KWHotel-integraatio vaatii ChatLabin Standard- tai Premium-sopimuksen taikka Travel Integrations -lisäosan