Integratsioon IdoBookinguga

Ühendage oma ChatLabi vestlusrobot IdoBooking broneerimissüsteemiga, et pakkuda oma veebisaidi külastajatele reaalajas saadavusinfot ja abi broneerimisel.

Näidisvestlus

Näide illustreerib kliendikogemust. Saadaolevad toimingud ja tagastatav teave sõltuvad sellest integratsioonist ja teie seadistusest.

Enne alustamist

Kõigepealt looge või valige vestlusrobot. Vajate õigust hallata selle integratsioone ning juurdepääsu välise konto ühendusseadetele. Kui Connect (ühenda) paanil kuvatakse uuendamise või kontakteerumise teade, kontrollige, kas teie tellimus sisaldab seda integratsiooni. Hoidke API mandaadid privaatsena; ärge kunagi kleepige neid veebisaidi manuskoodi.

Mida integratsioon võimaldab

Kui IdoBooking integratsioon on lubatud, saab teie vestlusrobot:

• kuvada vabade korterite ja majutuskohtade nimekirja koos kirjelduste ja fotodega;
• kontrollida saadavust konkreetseteks kuupäevadeks;
• leida määratud kuupäevavahemikuks vabu kortereid koos hindadega;
• otsida olemasolevaid broneeringuid ID, staatuse või kuupäevavahemiku järgi;
• luua uusi broneeringuid koos külalise andmetega.

Selle integratsiooni seadistamiseks on kaks võimalust - läbi IdoBooking Marketplace'i (soovitatav) või käsitsi ChatLabi administreerimispaneeli kaudu.

---

Variant A: seadistamine IdoBooking Marketplace'i kaudu (soovitatav)

Kiireim viis ChatLabi ja IdoBooking ühendamiseks on IdoBooking Marketplace. See meetod haldab API mandaate automaatselt ja lubab teie vestlusroboti jaoks lugemistoimingud.

Samm 1: installige ChatLab IdoBooking Marketplace'ist

1. Logige sisse oma IdoBooking administreerimispaneeli
2. Minge jaotisse Marketplace
3. Leidke ChatLab ja klõpsake Install (installi)

IdoBooking saadab teie API mandaadid ChatLabi automaatselt - eraldi API kasutajat luua või mandaate käsitsi kopeerida pole vaja.

Samm 2: looge ChatLabi konto või logige sisse

Pärast ChatLabi aktiveerimist turuplatsil suunatakse teid samm-sammulisse seadistusviisardisse. Kui teil on ChatLabi konto juba olemas, logige sisse. Vastasel juhul looge uus konto.

Samm 3: valige tellimuspakett

Valige oma vajadustele vastav tellimuspakett. IdoBooking broneerimisfunktsioonid (korterite otsing, saadavuse kontroll, broneeringud) vajavad IdoBooking integratsiooni funktsiooni. Kui teie tellimus seda ei sisalda, järgige paketi uuendamise või kontakteerumise viipa.

Samm 4: valige vestlusrobot

Valige olemasolev vestlusrobot, mida IdoBooking süsteemiga ühendada, või looge uus. Viisard saab luua teie jaoks uue roboti ka automaatselt.

Samm 5: viige seadistamine lõpule

Viisard teeb automaatselt järgmist:

• ühendab teie IdoBooking mandaadid valitud vestlusrobotiga;
• lubab korterite otsingu, saadavuse kontrolli ja broneeringute otsingu. Broneeringute loomist ei lubata automaatselt;
• suunab teid tagasi IdoBooking keskkonda või ChatLabi administreerimispaneeli.

Pärast viisardi läbimist on teie vestlusrobot valmis broneeringupäringuid haldama. Üksikuid tehisintellekti toiminguid saate peenhäälestada jaotises Settings > Actions (seaded > toimingud).

---

Variant B: käsitsi seadistamine

Kui eelistate integratsiooni käsitsi seadistada, järgige neid samme.

Osa 1: API kasutaja loomine IdoBooking süsteemis

Enne ChatLabi ühendamist oma IdoBooking süsteemiga peate oma IdoBooking paneelis looma spetsiaalse API juurdepääsuga kasutaja.

Samm 1: minge kasutajahalduse juurde

1. Logige sisse oma IdoBooking administreerimispaneeli
2. Minge jaotisse Settings > Users
3. Klõpsake Add new user (lisa uus kasutaja)

Samm 2: looge kasutajakonto

1. Sisestage uue kasutaja jaoks login name (kasutajatunnus, nt "chatlab-api")
2. Täitke ülejäänud nõutud andmed
3. Määrake sellele kontole turvaline password (parool)

Samm 3: konfigureerige API juurdepääs

Konfigureerige uue kasutaja jaoks järgmised juurdepääsuseaded:

1. Lubage (Enable) "Active API access" - see on integratsiooni toimimiseks vajalik
2. Keelake (Disable) "Active panel access" - kasutaja ei vaja juurdepääsu halduspaneelile

Samm 4: määrake kasutajaroll ja õigused

Kasutajarolli konfigureerimiseks on kaks võimalust:

Variant A: administraatori roll (lihtsam)

• Valige rolliks Administrator
• See tagab laialdased API õigused ka siis, kui paneeli juurdepääs on keelatud. Kasutage kohandatud rolli, kui integratsioon vajab ainult valitud lugemistoiminguid.

Variant B: kohandatud kasutajaroll (täpsemalt piiritletud)

Kui eelistate täpsemat kontrolli, valige Custom user ja konfigureerige järgmised moodulite õigused:

• Reservations - Read-only (ainult lugemine, kui vestlusrobot peab vaid broneeringuinfot pärima) või Full access (täielik juurdepääs, kui vestlusrobot hakkab broneeringuid looma)
• Customers - Read-only (ainult lugemine)
• Offers - Read-only (ainult lugemine)

Kohandatud kasutajate puhul peate seadistama ka asukohaõigused:

1. Kerige jaotiseni Location and accommodation permissions
2. Valige majutusüksused, mida see vestlusrobot peaks hõlmama; andke juurdepääs kõigile vaid siis, kui see on teie teadlik eesmärk.

Samm 5: keelake mittevajalikud teavitused

Vältimaks API kasutajale operatiivteavituste saabumist, lülitage välja järgmised valikud:

• Notifications for property staff - keelake (Disable)
• Automatic email notifications - keelake (Disable)

Samm 6: salvestage ja koguge ühenduse andmed

1. Kasutajakonto loomiseks klõpsake Save (salvesta)
2. Märkige üles järgmised andmed - vajate neid ChatLabi seadistamisel:

• Login - teie loodud kasutajanimi (nt chatlab-api)
• Password - teie määratud parool
• Subdomain - teie IdoBooking alamdomeen (nt client3760)

Alamdomeeni leidmine: vaadake oma IdoBooking paneeli URL-i. Näiteks kui teie URL on https://client3760.idosell.com, on teie alamdomeen client3760.

Osa 2: integratsiooni seadistamine ChatLabis

Samm 1: minge vahekaardile Connect

1. Logige sisse oma ChatLabi halduspaneeli
2. Valige robot, mida soovite konfigureerida
3. Minge vahekaardile Connect (ühenda)
4. Otsige integratsioonide nimekirjast üles IdoBooking ja klõpsake sellel

Samm 2: sisestage ühenduse andmed

Täitke ühenduse vorm IdoBooking süsteemist kogutud andmetega:

• Client Subdomain - sisestage oma IdoBooking alamdomeen (ilma täieliku URL-ita). Näide: client3760 (mitte https://client3760.idosell.com)
• System Login - sisestage IdoBooking süsteemis loodud API kasutajanimi
• System Password - sisestage API kasutaja parool
• Default Currency - valige hinnainfo jaoks vaikimisi valuuta
• Default Language - valige majutusüksuste kirjelduste jaoks vaikimisi keel

Samm 3: ühendage

1. Pärast kõigi kohustuslike väljade täitmist muutub nupp Connect (ühenda) aktiivseks
2. Ühenduse loomiseks klõpsake Connect
3. Oodake kinnitussõnumit
4. Pärast ühenduse loomist näete õnnestumise teavitust

Pärast edukat ühendamist muutub nupp "Connect" nupuks "Update Chatbot" ning ilmub nupp "Disconnect", kui soovite integratsiooni hiljem välja lülitada.

---

AI toimingute konfigureerimine

Kui IdoBooking integratsioon on ühendatud (kumbagi meetodit kasutades), saate seadistada, milliseid tehisintellekti toiminguid teie vestlusrobot saab teha. Vaadake aktiivsed toimingud üle pärast kummagi meetodi läbimist. Broneeringute loomist ei lubata automaatselt.

Saadaolevad AI toimingud

• Get Apartments - kuvab vabade korterite ja majutuskohtade nimekirja koos kirjelduste, voodite paigutuse ja fotodega
• Find Available Apartments - otsib määratud kuupäevavahemikuks vabu kortereid koos hinnainfoga
• Check Apartment Availability - kontrollib konkreetse korteri saadavust kindlas kuupäevavahemikus
• Get Reservations - otsib olemasolevaid broneeringuid ID, staatuse või kuupäevavahemiku järgi
• Create Reservation - loob uusi broneeringuid koos külalise andmete ja broneeringuinfoga
• AI room search - viib külalise kirjelduse tema soovidest kokku teie tubade kirjeldustega, selle asemel et kontrollida kuupäevi

AI room search ja Get Apartments on alternatiivid, mitte täiendused. Kui AI room search on sisse lülitatud, asendab see tavalise nimekirjatööriista ja Get Apartments eemaldatakse vestlusrobotilt, tagades, et korraga on aktiivne ainult üks tubade nimekirja tööriist. Kuupäevapõhiseid toiminguid see ei mõjuta.

Toimingute lubamine ja kohandamine

1. Pärast ühendamist klõpsake õnnestumise modaalaknas nupule Configure AI Actions (seadista AI toiminguid) või liikuge jaotisse Settings > Actions (seaded > toimingud) ja leidke kategooria IdoBooking
2. Lülitage sisse toimingud, mida soovite lubada
3. Kohandage vastavalt vajadusele toimingu silti (tekst, mida kasutajatele toimingu käivitamise ajal kuvatakse) ja juhiseid
4. Klõpsake toimingu dialoogiaknas uue toimingu puhul nupule Enable (luba) või olemasoleva toimingu puhul Update (uuenda).

Toimingu "Find available apartments" konfigureerimine

Toimingul Find available apartments on kaks lisaseadistust, mis määravad, mitut korterit vestlusrobot saadavuse küsimisel näitab ja millised korterid valikusse pääsevad. Nende avamiseks minge jaotisse Settings > Actions > IdoBooking - find available apartments.

Kuvatavate pakkumiste arv (Number of offers to show)

Liugur vahemikus 3-10 (vaikimisi 6). See määrab, mitu korterit vestlusrobot kasutajale ühes vastuses tagastab.

• Väiksemad väärtused (3-4) hoiavad vastuse lühikese ja fookuses, mis on kasulik siis, kui enamik külalisi valib vaid paari lemmiku vahel.
• Suuremad väärtused (8-10) pakuvad külalistele võrdlemiseks suuremat valikut, mis on kasulik laiema kataloogiga majutusasutuste puhul.

Pakkumiste valikustrateegia (Offer selection strategy)

Rippmenüü, mis otsustab, millised korterid valitakse saadavate tulemuste täisnimekirjast pärast kuupäeva ja külaliste arvu järgi filtreerimist. Saadaval on neli valikut:

• Odavaimad pakkumised (Cheapest offers) (vaikimisi) - tagastab madalaima miinimumhinnaga korterid, sorteerituna odavamast kallimani. Hea valik, kui külalised on hinnatundlikud või soovite esile tõsta kõige taskukohasemaid valikuid.
• Hinna järgi ühtlaselt jaotatud (Evenly distributed by price) - valib korterid, mis jaotuvad ühtlaselt üle kogu hinnaskaala. Näiteks 9 pakkumise puhul annab see ligikaudu 3 odavaimat, 3 keskmise hinnaga ja 3 kõige kallimat. Kasulik, kui soovite, et külalised näeksid kogu saadaolevat valikut, mitte ainult soodsaimat otsa.
• Kõige kallimad pakkumised (Most expensive offers) - tagastab kõrgeima hinnaga korterid, sorteerituna kallimast odavamani. Sobib esmaklassilistele majutuskohtadele või siis, kui soovite alustada oma tipptasemel valikust.
• Juhuslik valik (Random selection) - valib filtreeritud tulemustest korterid juhuslikult. Kasulik, kui soovite vestluste lõikes esiletõstetavaid kortereid varieerida ja vältida alati samade soovitamist.

Mõlemad seaded salvestatakse roboti põhiselt koos olemasoleva kohandatud prompti ja toimingu sildiga.

---

Valmis seadistuse testimine

Avage Overview (ülevaade) ja alustage uut testvestlust. Küsige tube tulevaseks kuupäevavahemikuks ja konkreetsele külaliste arvule, seejärel avage vastuses saadud broneerimislink ning võrrelge kuupäevi, valuutat ja hinda IdoBooking süsteemiga. Testige broneeringu otsingut broneeringuga, mida teil on õigus vaadata. Lubage ja testige toimingut Create Reservation ainult siis, kui kavatsete luua tegeliku broneeringu; vestluse test võib teha kirjeid otse teie broneerimissüsteemi.

Parimad tavad

Turvalisuse soovitused (käsitsi seadistamine)

• Kasutage eraldiseisvat API kasutajat - looge spetsiaalselt ChatLabi integratsiooni jaoks eraldi kasutaja, selle asemel et kasutada oma isiklikku administraatorikontot
• Minimaalsed õigused - andke ainult teie kasutusjuhu jaoks vajalikud õigused. Kasutage kirjutuskaitstud (read-only) juurdepääsu, kui vestlusrobot peab vaid infot pärima
• Regulaarne mandaatide uuendamine - uuendage perioodiliselt API kasutaja parooli ja seejärel värskendage mandaate ChatLabis

Vestlusroboti vastuste optimeerimine

• Treenige oma robotit majutuskoha infoga - lisage teadmusbaasi oma majutuskohtade kirjeldused, sealhulgas mugavused, tubade omadused ja asukoha üksikasjad
• Määrake selged vestlusvood - seadistage tervitussõnumid, mis suunavad kasutajaid saadavuse kohta küsima, ning kasutage soovitatud küsimusi nagu "Kontrolli saadavust" või "Vaata tube"

---

Veaotsing

• Ühendus ebaõnnestub - veenduge, et IdoBooking keskkonnas on kasutajale lubatud valik "Active API access"
• Vead teatega "Access denied" (juurdepääs keelatud) - kontrollige, kas kasutajal on õiged moodulite õigused
• Andmeid ei tagastata - veenduge, et kasutajal on juurdepääs asjakohastele asukohtadele ja majutusüksustele
• Vale alamdomeen - kontrollige oma IdoBooking URL-i ja eraldage sealt ainult alamdomeeni osa (nt client3760 aadressist https://client3760.idosell.com)

---

Tubade kataloog ja hotelli ülevaade

Kui teie kontol kuvatakse vahekaart Hotel, minge jaotisse Hotel > Rooms, et vaadata üle tubade kataloog ja treenimise olek. AI room search on eraldiseisev funktsioon ega sõltu kuupäevapõhisest saadavuse kontrollist: see viib vastavusse tubade kirjeldusi, samal ajal kui saadavuse toimingud kontrollivad soovitud peatumist. Tubade automaatne indekseerimine sõltub kataloogi automaatsest indekseerimisest ja määratud indekseeritavate tubade limiidist; vastasel juhul kasutage võimaluse korral funktsiooni Train rooms (treeni tube). Enne AI room searchi peale lootmist vaadake üle lubatud toimingud ja oodake, kuni treenimine lõpeb.

Seotud artiklid

• Vestlusroboti lisamine oma veebisaidile
• Vestlusroboti treenimine
• Vestlusroboti lingi saatmine