Integracija su IdoBooking

Prijunkite savo ChatLab pokalbių robotą prie IdoBooking rezervacijų sistemos, kad svetainės lankytojams realiuoju laiku teiktumėte informaciją apie užimtumą ir pagalbą atliekant užsakymus.

Ką suteikia ši integracija

Įjungus IdoBooking integraciją, jūsų pokalbių robotas gali:

• Pateikti laisvų apartamentų ir apgyvendinimo vietų sąrašą su aprašymais bei nuotraukomis
• Patikrinti užimtumą konkrečioms datoms
• 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 variantas: nustatymas per IdoBooking Marketplace (rekomenduojama)

Greičiausias būdas prijungti ChatLab prie IdoBooking yra per IdoBooking Marketplace. Naudojant šį metodą, API prisijungimo duomenys apdorojami automatiškai ir jūsų pokalbių robotui įjungiamos visos DI funkcijos.

1 žingsnis: įdiekite ChatLab iš IdoBooking Marketplace

1. Prisijunkite prie savo IdoBooking administravimo skydelio
2. Eikite į skiltį Marketplace (Prekyvietė)
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 ChatLab paskyrą arba prisijunkite prie esamos

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

3 žingsnis: pasirinkite prenumeratos planą

Pasirinkite jūsų poreikius atitinkantį prenumeratos planą. IdoBooking rezervacijų integracijos funkcijoms (apartamentų paieškai, užimtumo tikrinimui, rezervacijoms) reikalingas STANDARD arba PREMIUM planas.

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 sąranką

Vedlys automatiškai:

• Prijungia jūsų IdoBooking prisijungimo duomenis prie pasirinkto pokalbių roboto
• Įjungia visus galimus DI veiksmus (apartamentų paiešką, užimtumo tikrinimą, rezervacijas)
• 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 DI veiksmus galite tiksliau suderinti skiltyje Bot Settings > Actions (Roboto nustatymai > Veiksmai).

---

B variantas: rankinis nustatymas

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

1 dalis: API naudotojo sukūrimas sistemoje IdoBooking

Prieš prijungdami ChatLab prie savo IdoBooking sistemos, 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ą

Naujam naudotojui nustatykite šiuos prieigos parametrus:

1. Įjunkite parinktį „Active API access“ (Aktyvi API prieiga) - tai būtina integracijos veikimui
2. Išjunkite parinktį „Active panel access“ (Aktyvi prieiga prie skydelio) - naudotojui nereikia prieigos prie administravimo skydelio

4 žingsnis: nustatykite naudotojo vaidmenį ir teises

Turite dvi parinktis naudotojo vaidmeniui konfigūruoti:

A variantas: administratoriaus vaidmuo (paprasčiau)

• Kaip vaidmenį pasirinkite Administrator (Administratorius)
• Kadangi naudotojas neturės prieigos prie skydelio, tai yra saugus pasirinkimas, suteikiantis visas API teises

B variantas: pritaikytas naudotojo vaidmuo (išsamiau detalizuotas)

Jei norite tikslesnio valdymo, pasirinkite Custom user (Pritaikytas naudotojas) ir sukonfigūruokite šių modulių teises:

• Reservations (Rezervacijos) - Read-only (Tik skaitymas, jei pokalbių robotas turi tik gauti rezervacijų informaciją) arba Full access (Visiška prieiga, jei pokalbių robotas kurs rezervacijas)
• Customers (Klientai) - Read-only (Tik skaitymas)
• Offers (Pasiūlymai) - Read-only (Tik skaitymas)

Pritaikytiems naudotojams taip pat turite sukonfigūruoti vietovių teises:

1. Slinkite iki skilties Location and accommodation permissions (Vietovių ir apgyvendinimo vietų teisės)
2. Rekomenduojame pasirinkti Select all (Pasirinkti viską), kad suteiktumėte prieigą prie visų objektų

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šjungti
• Automatic email notifications (Automatiniai el. pašto pranešimai) - Išjungti

6 žingsnis: išsaugokite ir surinkite prisijungimo duomenis

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

• Login (Prisijungimo vardas) - jūsų sukurtas naudotojo vardas (pvz., chatlab-api)
• Password (Slaptažodis) - jūsų nustatytas slaptažodis
• Subdomain (Polapis) - jūsų IdoBooking polapis (pvz., client3760)

Kaip rasti savo polapį: pažiūrėkite į savo IdoBooking skydelio URL adresą. Pavyzdžiui, jei jūsų URL yra https://client3760.idosell.com, jūsų polapis yra client3760.

2 dalis: integracijos nustatymas sistemoje ChatLab

1 žingsnis: eikite į skirtuką Connect

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

2 žingsnis: įveskite prisijungimo duomenis

Užpildykite prijungimo formą duomenimis, kuriuos surinkote iš IdoBooking:

• Client Subdomain (Kliento polapis) - įveskite savo IdoBooking polapį (be pilno URL adreso). Pavyzdys: client3760 (ne https://client3760.idosell.com)
• System Login (Sistemos prisijungimo vardas) - įveskite IdoBooking sistemoje sukurto API naudotojo vardą
• System Password (Sistemos slaptažodis) - įveskite API naudotojo slaptažodį
• Default Currency (Numatytoji valiuta) - pasirinkite kainų informacijos valiutą
• Default Language (Numatytoji kalba) - pasirinkite apgyvendinimo vietų aprašymų kalbą

3 žingsnis: prisijunkite

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

Sėkmingai prisijungus, mygtukas pasikeičia iš „Connect“ į „Update Chatbot“ (Atnaujinti pokalbių robotą), taip pat atsiranda mygtukas „Disconnect“ (Atsijungti), jei vėliau prireiktų išjungti integraciją.

---

DI veiksmų konfigūravimas

Prijungus IdoBooking integraciją (bet kuriuo iš būdų), galite konfigūruoti, kokius DI veiksmus jūsų pokalbių robotas gali atlikti. Jei naudojote prekyvietės sąranką, visi veiksmai yra įjungti pagal numatytuosius nustatymus.

Galimi DI veiksmai

• Get Apartments - pateikia laisvų apartamentų ir apgyvendinimo vietų sąrašą su aprašymais, lovų išdėstymu ir nuotraukomis
• Find Available Apartments - ieško laisvų apartamentų nurodytam datų intervalui kartu su kainų informacija
• Check Apartment Availability - tikrina konkretaus apartamentų objekto užimtumą nurodytam datų intervalui
• Get Reservations - ieško esamų rezervacijų pagal ID, būseną arba datų intervalą
• Create Reservation - sukuria naujas rezervacijas su svečių duomenimis ir užsakymo informacija

Veiksmų įjungimas ir pritaikymas

1. Prisijungę sėkmės lange spustelėkite Configure AI Actions (Konfigūruoti DI veiksmus) arba eikite į Bot Settings > Actions ir raskite IdoBooking kategoriją
2. Įjunkite norimus veiksmus
3. Prireikus pritaikykite veiksmo etiketę (tekstą, rodomą naudotojams veiksmo vykdymo metu) ir instrukcijas
4. Spustelėkite Save (Išsaugoti), kad pritaikytumėte pakeitimus

Veiksmo „Find available apartments“ konfigūravimas

Veiksmas Find available apartments (Rasti laisvus apartamentus) turi du papildomus valdiklius, kurie nustato, kiek apartamentų pokalbių robotas rodo svečiui pasiteiravus apie užimtumą ir kurie apartamentai patenka į atranką. Norėdami juos pasiekti, atidarykite veiksmą pasirinkę Bot Settings > Actions > IdoBooking - find available apartments.

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

Šliaužiklis, kurio reikšmė svyruoja nuo 3 iki 10 (numatytoji reikšmė - 6). Jis nustato, kiek apartamentų pokalbių robotas pateikia naudotojui viename atsakyme.

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

Offer selection strategy (Pasiūlymų atrankos strategija)

Išskleidžiamasis meniu, lemiantis, kurie apartamentai atrenkami iš viso laisvų rezultatų sąrašo, pritaikius datų ir svečių skaičiaus filtrus. Galimi keturi variantai:

• Cheapest offers (Pigiausi pasiūlymai, 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.
• Evenly distributed by price (Tolygiai paskirstyti pagal kainą) - atrenka apartamentus, tolygiai pasiskirsčiusius visame kainų rėžyje. Pavyzdžiui, pasirinkus 9 pasiūlymus, pateikiami maždaug 3 pigiausi, 3 vidutinės kainos ir 3 brangiausi. Naudinga, kai norite, kad svečiai matytų visą prieinamų variantų spektrą, o ne tik biudžetinius pasiūlymus.
• Most expensive offers (Brangiausi pasiūlymai) - pateikia brangiausius apartamentus, surikiuotus nuo brangiausių iki pigiausių. Tinka aukščiausios klasės objektams arba kai norite pirmiausia pristatyti savo prabangiausius apartamentus.
• Random selection (Atsitiktinė atranka) - atrenka apartamentus atsitiktine tvarka iš filtruotų rezultatų. Naudinga, kai norite paįvairinti skirtinguose pokalbiuose siūlomus apartamentus ir išvengti tų pačių objektų rekomendavimo.

Abu nustatymai išsaugomi kiekvienam robotui atskirai, kartu su esamu pasirinktiniu nurodymu (prompt) ir veiksmo etikete.

---

Geriausios praktikos

Saugumo rekomendacijos (rankinis nustatymas)

• Naudokite atskirą API naudotoją - sukurkite atskirą naudotoją specialiai ChatLab integracijai, užuot naudoję asmeninę administratoriaus paskyrą
• Minimalios teisės - suteikite tik tas teises, kurios yra būtinos jūsų poreikiams. 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 prisijungimo duomenis ChatLab sistemoje

Pokalbių roboto atsakymų optimizavimas

• Apmokykite savo robotą naudodami informaciją apie objektą - įtraukite į žinių bazę savo apgyvendinimo vietų aprašymus, patogumus, kambarių ypatybes ir informaciją apie vietovę
• Nustatykite aiškią pokalbio eigą - sukonfigūruokite pasveikinimo žinutes, kurios nukreiptų 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 - įsitikinkite, kad IdoBooking sistemoje naudotojui įjungta parinktis „Active API access“
• Klaidos „Access denied“ (Prieiga uždrausta) - patikrinkite, ar naudotojui suteiktos teisingos modulių teisės
• Nepateikiami jokie duomenys - įsitikinkite, kad naudotojas turi prieigą prie atitinkamų vietovių ir objektų
• Neteisingas polapis - patikrinkite savo IdoBooking URL adresą ir išskirkite tik polapio dalį (pvz., client3760 iš adreso https://client3760.idosell.com)

---