Integracija su IdoBooking

Sujunkite savo „ChatLab“ pokalbių robotą su „IdoBooking“ rezervavimo sistema, kad savo svetainės lankytojams teiktumėte informaciją apie užimtumą realiuoju laiku ir pagalbą atliekant rezervacijas.

Pokalbio pavyzdys

Pavyzdys parodo kliento patirtį. Galimi veiksmai ir pateikiama informacija priklauso nuo šios integracijos bei Jūsų konfigūracijos.

Prieš pradedant

Pirmiausia sukurkite arba pasirinkite pokalbių robotą. Jums reikia leidimo tvarkyti jo integracijas ir prieigos prie išorinės paskyros ryšio nustatymų. Jei plytelėje „Connect“ rodomas raginimas atnaujinti planą arba susisiekti, patikrinkite, ar Jūsų prenumerata apima šią integraciją. Laikykite API prisijungimo duomenis paslaptyje; niekada neįklijuokite jų į svetainės įterpimo kodą.

Ką suteikia integracija

Įgalinus „IdoBooking“ integraciją, Jūsų pokalbių robotas gali:

• Pateikti pasiekiamų apartamentų ir apgyvendinimo vietų sąrašą su aprašymais ir nuotraukomis
• Tikrinti užimtumą konkrečiomis datomis
• Rasti laisvus apartamentus nurodytam datų intervalui kartu su kainomis
• Ieškoti esamų rezervacijų pagal ID, būseną arba datų intervalą
• Kurti naujas rezervacijas su svečių duomenimis

Šią integraciją galima nustatyti dviem būdais - per IdoBooking Marketplace (rekomenduojama) arba rankiniu būdu per „ChatLab“ valdymo skydelį.

---

A parinktis: nustatymas per „IdoBooking Marketplace“ (rekomenduojama)

Greičiausias būdas sujungti „ChatLab“ su „IdoBooking“ yra per „IdoBooking Marketplace“. Šis metodas automatiškai sutvarko API prisijungimo duomenis ir įgalina skaitymo veiksmus Jūsų pokalbių robotui.

1 žingsnis: įdiekite „ChatLab“ iš „IdoBooking Marketplace“

1. Prisijunkite prie savo „IdoBooking“ administravimo skydelio
2. Eikite į skiltį Marketplace
3. Raskite ChatLab ir spustelėkite Install (įdiegti)

„IdoBooking“ automatiškai nusiunčia Jūsų API prisijungimo duomenis į „ChatLab“ - nereikia kurti atskiro API naudotojo ar rankiniu būdu kopijuoti duomenų.

2 žingsnis: sukurkite arba prisijunkite prie savo „ChatLab“ paskyros

Suaktyvinę „ChatLab“ prekyvietėje, būsite nukreipti į nuoseklų sąrankos vedlį. Jei jau turite „ChatLab“ paskyrą, prisijunkite. Kitu atveju sukurkite naują paskyrą.

3 žingsnis: pasirinkite prenumeratos planą

Pasirinkite Jūsų poreikius atitinkantį prenumeratos planą. „IdoBooking“ rezervavimo integracijos funkcijoms (apartamentų paieškai, užimtumo tikrinimui, rezervacijoms) reikalinga „IdoBooking“ integracijos funkcija. Jei Jūsų prenumerata jos neapima, vadovaukitės raginimu atnaujinti planą arba susisiekti.

4 žingsnis: pasirinkite pokalbių robotą

Pasirinkite esamą pokalbių robotą, kurį norite prijungti prie „IdoBooking“, arba sukurkite naują. Vedlys gali automatiškai sukurti naują robotą už Jus.

5 žingsnis: užbaikite nustatymą

Vedlys automatiškai:

• Prijungia Jūsų „IdoBooking“ prisijungimo duomenis prie pasirinkto pokalbių roboto
• Įgalina apartamentų paiešką, užimtumo patikras ir rezervacijų peržiūrą. Rezervacijų kūrimas automatiškai neįgalinamas.
• Nukreipia Jus atgal į „IdoBooking“ arba į „ChatLab“ valdymo skydelį

Užbaigus vedlio veiksmus, Jūsų pokalbių robotas yra paruoštas apdoroti užklausas dėl rezervacijų. Atskirus dirbtinio intelekto veiksmus galite tiksliai sureguliuoti skiltyje Settings > Actions (nustatymai > veiksmai).

---

B parinktis: rankinis nustatymas

Jei integraciją norite sukonfigūruoti rankiniu būdu, atlikite šiuos veiksmus.

1 dalis: API naudotojo sukūrimas sistemoje „IdoBooking“

Prieš prijungdami „ChatLab“ prie savo „IdoBooking“ sistemos, savo „IdoBooking“ skydelyje turite sukurti specialų naudotoją su API prieiga.

1 žingsnis: eikite į naudotojų valdymą

1. Prisijunkite prie savo „IdoBooking“ administravimo skydelio
2. Eikite į Settings > Users (nustatymai > naudotojai)
3. Spustelėkite Add new user (pridėti naują naudotoją)

2 žingsnis: sukurkite naudotojo paskyrą

1. Įveskite naujo naudotojo login name (prisijungimo vardą) (pvz., „chatlab-api“)
2. Užpildykite likusią privalomą informaciją
3. Nustatykite saugų šios paskyros password (slaptažodį)

3 žingsnis: sukonfigūruokite API prieigą

Sukonfigūruokite šiuos naujojo naudotojo prieigos nustatymus:

1. Enable (įgalinkite) „Active API access“ - tai būtina, kad integracija veiktų
2. Disable (išjunkite) „Active panel access“ - naudotojui nereikia prieigos prie administravimo skydelio

4 žingsnis: nustatykite naudotojo vaidmenį ir leidimus

Turite dvi parinktis naudotojo vaidmeniui konfigūruoti:

A parinktis: administratoriaus vaidmuo (paprasčiau)

• Kaip vaidmenį pasirinkite Administrator (administratorius)
• Tai suteikia plačius API leidimus net ir tada, kai prieiga prie skydelio yra išjungta. Pasirinktinį vaidmenį naudokite, jei integracijai reikalingos tik tam tikros skaitymo operacijos.

B parinktis: pasirinktinis naudotojo vaidmuo (tikslesnis valdymas)

Jei pageidaujate tikslesnio valdymo, pasirinkite Custom user (pasirinktinis naudotojas) ir sukonfigūruokite šiuos modulių leidimus:

• Reservations (rezervacijos) - tik skaitymas (Read-only), jei pokalbių robotas turi tik gauti rezervacijos informaciją, arba visa prieiga (Full access), jei robotas kurs rezervacijas
• Customers (klientai) - tik skaitymas (Read-only)
• Offers (pasiūlymai) - tik skaitymas (Read-only)

Pasirinktiniams naudotojams taip pat reikia sukonfigūruoti vietos leidimus:

1. Slinkite iki skilties Location and accommodation permissions (vietos ir apgyvendinimo leidimai)
2. Pasirinkite apgyvendinimo objektus, kuriuos šis pokalbių robotas turėtų apimti; prieigą prie visų suteikite tik tuo atveju, jei tai yra Jūsų numatyta taikymo sritis.

5 žingsnis: išjunkite nereikalingus pranešimus

Kad API naudotojas negautų operacinių pranešimų, išjunkite šias parinktis:

• Notifications for property staff (pranešimai objekto personalui) - išjunkite (Disable)
• Automatic email notifications (automatiniai el. pašto pranešimai) - išjunkite (Disable)

6 žingsnis: išsaugokite ir surinkite ryšio duomenis

1. Spustelėkite Save (išsaugoti), kad sukurtumėte naudotojo paskyrą
2. Užsirašykite šią informaciją - jos prireiks konfigūruojant „ChatLab“:

• Login - Jūsų sukurtas naudotojo vardas (pvz., chatlab-api)
• Password - Jūsų nustatytas slaptažodis
• Subdomain - Jūsų „IdoBooking“ subdomenas (pvz., client3760)

Subdomeno paieška: pažiūrėkite į savo „IdoBooking“ skydelio URL adresą. Pavyzdžiui, jei Jūsų URL yra https://client3760.idosell.com, Jūsų subdomenas yra client3760.

2 dalis: integracijos nustatymas sistemoje „ChatLab“

1 žingsnis: eikite į kortelę „Connect“

1. Prisijunkite prie savo „ChatLab“ valdymo skydelio
2. Pasirinkite robotą, kurį norite sukonfigūruoti
3. Eikite į kortelę Connect (prijungti)
4. Integracijų sąraše raskite ir spustelėkite IdoBooking

2 žingsnis: įveskite ryšio duomenis

Užpildykite ryšio formą iš „IdoBooking“ surinkta informacija:

• Client Subdomain - įveskite savo „IdoBooking“ subdomeną (be pilno URL adreso). Pavyzdys: client3760 (ne https://client3760.idosell.com)
• System Login - įveskite „IdoBooking“ sistemoje sukurto API naudotojo vardą
• System Password - įveskite API naudotojo slaptažodį
• Default Currency - pasirinkite valiutą kainų informacijai
• Default Language - pasirinkite kalbą apgyvendinimo objektų aprašymams

3 žingsnis: prijunkite

1. Užpildžius visus privalomus laukus, mygtukas Connect tampa aktyvus
2. Spustelėkite Connect, kad užmegztumėte ryšį
3. Palaukite patvirtinimo pranešimo
4. Sėkmingai prisijungus, pamatysite sėkmės pranešimą

Sėkmingai prisijungus, mygtukas pasikeičia iš „Connect“ į „Update Chatbot“, o jei vėliau prireiktų išjungti integraciją, atsiranda mygtukas „Disconnect“.

---

Dirbtinio intelekto veiksmų konfigūravimas

Prijungę „IdoBooking“ integraciją (bet kuriuo iš būdų), galite sukonfigūruoti, kokius dirbtinio intelekto veiksmus Jūsų pokalbių robotas gali atlikti. Peržiūrėkite aktyvius veiksmus po bet kurio nustatymo metodo. Rezervacijų kūrimas automatiškai neįgalinamas.

Galimi dirbtinio intelekto veiksmai

• Get Apartments - pateikia pasiekiamų apartamentų ir apgyvendinimo vietų sąrašą su aprašymais, lovų konfigūracijomis ir nuotraukomis
• Find Available Apartments - ieško laisvų apartamentų nurodytam datų intervalui kartu su kainų informacija
• Check Apartment Availability - tikrina konkrečių apartamentų užimtumą nurodytam datų intervalui
• Get Reservations - ieško esamų rezervacijų pagal ID, būseną arba datų intervalą
• Create Reservation - kuria naujas rezervacijas su svečių duomenimis ir užsakymo informacija
• AI room search - suderina svečio poreikių aprašymą su Jūsų kambarių aprašymais, užuot tikrinęs datas

„AI room search“ ir Get Apartments yra alternatyvos, o ne papildymai. Įjungus „AI room search“, jis pakeičia paprastą sąrašo pateikimo įrankį, o veiksmas Get Apartments pašalinamas iš pokalbių roboto, todėl vienu metu visada aktyvus tik vienas kambarių sąrašo pateikimo įrankis. Datų pagrindu veikiantiems veiksmams tai įtakos neturi.

Veiksmų įgalinimas ir pritaikymas

1. Prisijungę sėkmės lange spustelėkite Configure AI Actions (konfigūruoti DI veiksmus) arba eikite į Settings > Actions ir raskite „IdoBooking“ kategoriją
2. Perjunkite veiksmus, kuriuos norite įgalinti
3. Prireikus pritaikykite veiksmo etiketę (tekstą, rodomą naudotojams, kol veiksmas vykdomas) ir nurodymus
4. Veiksmo dialogo lange spustelėkite Enable (įgalinti) naujam veiksmui arba Update (atnaujinti) esamam veiksmui.

Veiksmo „Find available apartments“ konfigūravimas

Veiksmas Find available apartments turi du papildomus valdiklius, kurie nulemia, kiek apartamentų pokalbių robotas rodo svečiui pasiteiravus apie užimtumą ir kurie apartamentai patenka į pasirinkimą. Norėdami juos pasiekti, atidarykite veiksmą skiltyje Settings > Actions > IdoBooking - find available apartments.

Rodomų pasiūlymų skaičius (Number of offers to show)

Slankiklis, kurio reikšmės svyruoja nuo 3 iki 10 (numatytoji reikšmė 6). Jis valdo, kiek apartamentų pokalbių robotas grąžina naudotojui viename atsakyme.

• Mažesnės reikšmės (3-4) užtikrina trumpą ir koncentruotą atsakymą, o tai naudinga, kai dauguma svečių renkasi tik iš kelių variantų.
• Didesnės reikšmės (8-10) suteikia svečiams didesnę įvairovę palyginimui, kas praverčia platesnį katalogą turintiems objektams.

Pasiūlymų atrankos strategija (Offer selection strategy)

Išskleidžiamasis meniu, kuris nulemia, kurie apartamentai pasirenkami iš viso pasiekiamų rezultatų sąrašo, pritaikius datų ir svečių skaičiaus filtrus. Galimos keturios parinktys:

• Pigiausi pasiūlymai (Cheapest offers) (numatytoji) - pateikia apartamentus su mažiausia minimalia kaina, surikiuotus nuo pigiausių iki brangiausių. Tinka, kai svečiams svarbi kaina arba norite pirmiausia parodyti prieinamiausius variantus.
• Tolygiai paskirstyti pagal kainą (Evenly distributed by price) - parenka apartamentus, tolygiai pasiskirsčiusius visame kainų diapazone. Pavyzdžiui, pasirinkus 9 pasiūlymus, bus pateikti maždaug 3 pigiausi, 3 vidutinės kainos ir 3 brangiausi. Naudinga, kai norite, kad svečiai matytų visą pasiekiamą spektrą, o ne tik biudžetinius variantus.
• Brangiausi pasiūlymai (Most expensive offers) - pateikia brangiausius apartamentus, surikiuotus nuo didžiausios iki mažiausios kainos. Tinka aukščiausios klasės apgyvendinimo įstaigoms arba kai norite pirmiausia pasiūlyti aukščiausio lygio numerius.
• Atsitiktinė atranka (Random selection) - parenka apartamentus atsitiktine tvarka iš filtruotų rezultatų. Naudinga, kai norite pokalbiuose paįvairinti rodomus apartamentus ir išvengti nuolatinio tų pačių parinkčių siūlymo.

Abu nustatymai išsaugomi kiekvienam robotui atskirai, kartu su esamomis pasirinktinėmis prompt instrukcijomis ir veiksmo etikete.

---

Užbaigto nustatymo išbandymas

Atidarykite Overview (apžvalga) ir pradėkite naują bandomąjį pokalbį. Paprašykite kambarių būsimam datų intervalui ir konkrečiam svečių skaičiui, tada atidarykite pateiktą rezervavimo nuorodą ir palyginkite datas, valiutą bei kainą su „IdoBooking“. Išbandykite rezervacijos paiešką naudodami rezervaciją, kurią turite teisę tikrinti. Įgalinkite ir bandykite Create Reservation tik tada, kai tikrai ketinate sukurti tikrą rezervaciją; pokalbio bandymas gali atlikti įrašus Jūsų rezervavimo sistemoje.

Geriausia praktika

Saugumo rekomendacijos (rankinis nustatymas)

• Naudokite atskirą API naudotoją - sukurkite atskirą naudotoją specialiai „ChatLab“ integracijai, užuot naudoję asmeninę administratoriaus paskyrą
• Minimalūs leidimai - suteikite tik tuos leidimus, kurie būtini Jūsų naudojimo atvejui. Naudokite tik skaitymo prieigą, jei pokalbių robotui reikia tik gauti informaciją
• Reguliarus prisijungimo duomenų keitimas - periodiškai atnaujinkite API naudotojo slaptažodį, o tada atnaujinkite duomenis „ChatLab“ sistemoje

Pokalbių roboto atsakymų optimizavimas

• Apmokykite savo robotą naudodami informaciją apie apgyvendinimo vietą - įtraukite į žinių bazę apgyvendinimo vietų aprašymus, patogumus, kambarių ypatybes ir išsamią informaciją apie vietovę
• Nustatykite aiškią pokalbio eigą - sukonfigūruokite pasveikinimo pranešimus, kurie paskatintų naudotojus teirautis apie užimtumą, ir naudokite siūlomus klausimus, tokius kaip „Patikrinti užimtumą“ arba „Peržiūrėti kambarius“

---

Trikčių šalinimas

• Nepavyksta prisijungti - patikrinkite, ar naudotojui sistemoje „IdoBooking“ įgalinta parinktis „Active API access“
• Klaidos „Access denied“ (prieiga uždrausta) - patikrinkite, ar naudotojas turi tinkamus modulių leidimus
• Negrąžinami duomenys - įsitikinkite, kad naudotojas turi prieigą prie atitinkamų vietų ir apgyvendinimo objektų
• Neteisingas subdomenas - patikrinkite savo „IdoBooking“ URL adresą ir paimkite tik subdomeno dalį (pvz., client3760 iš https://client3760.idosell.com)

---

Kambarių katalogas ir viešbučio apžvalga

Jei Jūsų paskyroje rodoma kortelė Hotel (viešbutis), eikite į Hotel > Rooms (viešbutis > kambariai), kad peržiūrėtumėte kambarių katalogą ir apmokymo būseną. AI room search yra atskirtas nuo užimtumo patikrų pagal datas: jis ieško atitikmenų pagal kambarių aprašymus, o užimtumo veiksmai tikrina pageidaujamą viešnagės laikotarpį. Automatinis kambarių indeksavimas priklauso nuo automatinio katalogo indeksavimo ir priskirto indeksuojamų kambarių limito; kitu atveju naudokite Train rooms (apmokyti kambarius), kai ši parinktis pasiekiama. Prieš pasikliaudami „AI room search“, peržiūrėkite įgalintus veiksmus ir palaukite, kol apmokymas bus baigtas.

Susiję straipsniai

• Pokalbių roboto pridėjimas į Jūsų svetainę
• Pokalbių roboto apmokymas
• Nuorodos į pokalbių robotą siuntimas