Abikeskus
Chatboti integratsioonid

Integratsioon KWHoteliga

Viimati uuendatud:

Ühendage oma ChatLab chatbot KWHoteli hotellihaldussüsteemiga (PMS), et pakkuda oma veebisaidi külastajatele reaalajas teavet tubade saadavuse, broneerimise ja broneeringute otsingu kohta. Integratsioon kasutab tubade ja saadavuse andmete jaoks broneerimismootorit GuestSage booking engine ning broneeringute otsimiseks liidest KWHotel Integrations API.

Mida integratsioon võimaldab

Kui KWHoteli integratsioon on sisse lülitatud, saab teie chatbot:

  • Kuvada toatüüpide nimekirja koos kirjelduste, mahutavuse, pindala ja fotodega
  • Leida vabade tubade pakkumisi koos hindadega määratud kuupäevavahemikuks
  • Kontrollida konkreetse toatüübi saadavust määratud kuupäevavahemikus
  • Luua uusi broneeringuid koos külalise andmetega
  • Otsida olemasolevaid broneeringuid

Eeldused

Enne integratsiooni seadistamist veenduge, et teil on:

  • KWHotel konto, kus on aktiveeritud GuestSage'i broneerimismootor
  • Teie Hotel ID (UUID) GuestSage'i broneerimismootorist
  • Teie numbriline Integrations Hotel ID ja KWHoteli väljastatud Integrations API Key
  • ChatLab konto paketiga STANDARD või PREMIUM või lisamooduliga Travel Integrations

Oma Hotel ID (UUID) leidmine

Hotel ID on UUID-tunnus, mis on määratud teie majutusasutusele GuestSage'i broneerimismootoris.

  1. Logige sisse aadressil cloud.kwhotel.com
  2. Liikuge jaotisse Modules (Moodulid) > Booking Engine (Broneerimismootor)
  3. Leidke vahekaardil General (Üldine) väli Booking engine link (Broneerimismootori link)
  4. Kopeerige UUID-kood aadressiribalt (URL)

Hotel ID leidmine KWHotelis

Näiteks lingis https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 on Hotel ID 82b0085d-da1b-4443-8fde-d5d569a859e6.


Oma Integrations API mandaatide leidmine

KWHotel Integrations API kasutab teistsugust identifikaatorit kui GuestSage'i UUID:

  • Integrations Hotel ID - numbriline ID (näiteks 292)
  • Integrations API Key - salajane võti, mille loote KWHotelis

Numbriline Hotel ID

Numbrilise Hotel ID leiate KWHoteli halduspaneeli paremast ülanurgast.

Numbriline Hotel ID KWHoteli halduspaneelis|width=450

API-võtme loomine

API-võtme loote ise KWHoteli sees:

  1. Logige sisse KWHoteli ja avage moodul Synchronization (Sünkroonimine)
  2. Klõpsake nupul Reset API key (Lähtesta API-võti)
  3. Kopeerige loodud võti ja kleepige see ChatLabi ühendusvormi

REST API võtme loomine KWHotelis|width=250

Loodud REST API võti

Nupul Reset API key klõpsamine eemaldab eelmise võtme (kui see oli juba loodud) ja genereerib uue. Iga teine süsteem, mis kasutab eelmist võtit, lakkab töötamast, kuni te seda uue väärtusega ei uuenda.


Integratsiooni seadistamine ChatLabis

1. samm: minge vahekaardile Connect

  1. Logige sisse oma ChatLabi halduspaneeli
  2. Valige bot, mida soovite konfigureerida
  3. Minge vahekaardile Connect (Ühenda)
  4. Leidke integratsioonide nimekirjast KWHotel ja klõpsake sellel

2. samm: sisestage ühenduse andmed

Täitke ühendusvorm:

  • Hotel ID (UUID) - teie KWHoteli hotelli GUID GuestSage'i broneerimismootori konfiguratsioonist
  • Default Currency - vestluse kasutajatele kuvatavate hindade vaikevaluuta (vaikimisi PLN)
  • Default Language - tubade kirjelduste ja pakkumiste teksti vaikekeel (vaikimisi poola keel)
  • Integrations Hotel ID - numbriline hotelli ID KWHotel Integrations API jaoks (erineb ülaltoodud UUID-st)
  • Integrations API Key - KWHoteli väljastatud salajane API-võti
  • Discount bot channel - valikuline. Kui see on määratud, päritakse pakkumised selle KWHoteli sooduskanali jaoks ja AI sordib need. Vaikimisi kanali kasutamiseks jätke tühjaks.

3. samm: ühendage

  1. Kui väljad on täidetud, muutub nupp Connect aktiivseks
  2. Konfiguratsiooni salvestamiseks klõpsake nuppu Connect. ChatLab testib nii GuestSage'i kui ka Integrations API ühendust.
  3. Eduka ühenduse korral kuvatakse kinnitusteade (toast).

Pärast edukat ühendamist muutub nupp Connect nupuks Update Chatbot (Uuenda chatbotit) ning ilmub nupp Disconnect (Katkesta ühendus), mille abil saate integratsiooni hiljem välja lülitada.

Kui Integrations API kontroll salvestamisel ebaõnnestub, lülitatakse toiming Get reservation automaatselt välja. Sisestage õiged andmed uuesti ja klõpsake selle aktiveerimiseks nuppu Update Chatbot.


AI toimingute konfigureerimine

Kui teie KWHoteli integratsioon on ühendatud, saate seadistada, milliseid AI toiminguid teie chatbot saab teha.

Saadaval olevad AI toimingud

  • KWHotel - get rooms - kuvab toatüüpide nimekirja koos kirjelduste, voodite paigutuse, pindala, mahutavuse ja fotodega
  • KWHotel - find available rooms - otsib vabu tube määratud kuupäevavahemikuks ja tagastab pakkumised koos hindadega
  • KWHotel - check room availability - kontrollib konkreetse toatüübi saadavust määratud kuupäevavahemikus
  • KWHotel - create reservation - loob uue broneeringu koos külalise andmete ja broneeringuinfoga
  • KWHotel - get reservation - otsib olemasolevaid broneeringuid

Toimingute lubamine ja kohandamine

  1. Pärast ühendamist klõpsake õnnestumise modaalis valikul Configure AI Actions (Konfigureeri AI toiminguid) või liikuge jaotisse Bot Settings > Actions (Boti seaded > Toimingud) ning leidke kategooria KWHotel
  2. Lülitage sisse toimingud, mida soovite lubada
  3. Kohandage vastavalt vajadusele toimingu silti (tekst, mida kasutajatele kuvatakse toimingu töötamise ajal) ja prompti juhiseid
  4. Muudatuste rakendamiseks klõpsake Save (Salvesta)

Parimad tavad

Chatboti vastuste optimeerimine

  • Treenige oma boti majutusasutuse infoga - lisage teadmusbaasi oma tubade ja hotellirajatiste kirjeldused, sealhulgas mugavused, asukoht, lähedal asuvad vaatamisväärsused ning sisse- ja väljaregistreerimise reeglid
  • Määrake selged vestlusvood - konfigureerige tervitussõnumid, mis suunavad külalisi saadavuse kohta küsima, ja kasutage soovitatud küsimusi, nagu "Kontrolli tubade saadavust" või "Vaata tube"
  • Lisage toaspetsiifilised lehed - looge oma veebisaidil iga toatüübi jaoks eraldi lehed ja treenige chatbotit nende URL-idega, et tagada põhjalikumad vastused

Broneerimismootori integreerimine

  • KWHoteli integratsioon toimib tubade saadavuse ja hindade osas GuestSage'i broneerimismootori kaudu
  • Otseste broneeringute lõpuleviimiseks väljaspool vestlust integreerige oma veebisaidile koos ChatLab chatbotiga ka GuestSage'i broneerimisvidin (widget) - kui külalised on valmis broneerima, saab chatbot suunata nad otse broneerimislehele

Tõrkeotsing

  • Ühendus ebaõnnestub - kontrollige, kas teie Hotel ID on GuestSage'i UUID (mitte numbriline Integrations ID) ja kas teie majutusasutus on GuestSage'i broneerimismootoris aktiivne
  • Toiming Get reservation jääb väljalülitatuks - kui Integrations API ühenduse test salvestamisel ebaõnnestub, deaktiveeritakse toiming automaatselt. Sisestage Integrations Hotel ID ja Integrations API Key uuesti ning klõpsake nuppu Update Chatbot.
  • Tubade andmeid ei tagastata - veenduge, et teie toatüübid on KWHotelis nõuetekohaselt koos kirjeldustega konfigureeritud ja et saadavus on GuestSage'is avaldatud
  • Valed hinnad või pakkumised puuduvad - hinnad pärinevad GuestSage'ist. Uuendage KWHotelis hindu ja pakkumiste seadeid, et need kajastaksid kehtivat hinnakirja. Kui määrasite soodustuste botikanali (Discount bot channel), veenduge, et sellel oleks aktiivseid pakkumisi.
  • Integratsioon pole halduspaneelis saadaval - KWHoteli integratsioon eeldab ChatLabi paketti STANDARD või PREMIUM või lisamoodulit Travel Integrations