Integratsioon IdoBookinguga

Ühendage oma ChatLab-i chatbot IdoBooking broneerimissüsteemiga, et pakkuda veebisaidi külastajatele reaalajas saadavusinfot ja abi broneerimisel.

Mida see integratsioon võimaldab

Kui IdoBooking integratsioon on sisse lülitatud, suudab teie chatbot:

• Kuvada nimekirja saadaolevatest korteritest ja majutuskohtadest koos kirjelduste ning fotodega
• Kontrollida saadavust kindlatel kuupäevadel
• Otsida saadaolevaid kortereid määratud ajavahemikuks koos hindadega
• Otsida olemasolevaid broneeringuid ID, oleku või kuupäevavahemiku järgi
• Luua uusi broneeringuid koos külalise andmetega

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

---

Valik A: Seadistamine IdoBooking Marketplace-i kaudu (soovitatav)

Kiireim viis ChatLab-i ühendamiseks IdoBookinguga on IdoBooking Marketplace-i kaudu. See meetod haldab API mandaate automaatselt ja lülitab teie chatbotil sisse kõik AI-tegevused.

1. samm: Paigaldage ChatLab IdoBooking Marketplace-ist

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

IdoBooking saadab teie API mandaadid automaatselt ChatLab-ile - eraldi API-kasutajat ei ole vaja luua ega mandaate käsitsi kopeerida.

2. samm: Looge ChatLab-i konto või logige sisse

Pärast ChatLab-i aktiveerimist marketplace-is suunatakse teid seadistusviisardisse. Kui teil on ChatLab-i konto juba olemas, logige sisse. Vastasel juhul looge uus konto.

3. samm: Valige tellimuspakett

Valige oma vajadustele vastav tellimuspakett. IdoBooking broneerimisintegratsiooni funktsioonid (korterite otsing, saadavuse kontroll, broneeringute tegemine) nõuavad paketti STANDARD või PREMIUM.

4. samm: Valige chatbot

Valige IdoBookinguga ühendamiseks olemasolev chatbot või looge uus. Viisard saab teie jaoks uue boti automaatselt luua.

5. samm: Viige seadistamine lõpule

Viisard teeb automaatselt järgmist:

• Ühendab teie IdoBookingu mandaadid valitud chatbotiga
• Lülitab sisse kõik saadaolevad AI-tegevused (korterite otsing, saadavuse kontroll, broneeringud)
• Suunab teid tagasi IdoBookingusse või ChatLab-i administreerimispaneeli

Pärast viisardi läbimist on teie chatbot valmis broneerimispäringuid haldama. Üksikuid AI-tegevusi saate täpsemalt häälestada jaotises Bot Settings > Actions (Boti seaded > Tegevused).

---

Valik B: Käsitsi seadistamine

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

1. osa: API-kasutaja loomine IdoBookingus

Enne ChatLab-i ühendamist oma IdoBooking süsteemiga peate oma IdoBookingu paneelis looma eraldi API-juurdepääsuga kasutaja.

1. samm: Navigeerige kasutajahaldusesse

1. Logige sisse oma IdoBookingu administreerimispaneeli
2. Minge jaotisse Settings > Users (Seaded > Kasutajad)
3. Klõpsake Add new user (Lisa uus kasutaja)

2. samm: Looge kasutajakonto

1. Sisestage uuele kasutajale login name (kasutajanimi; nt "chatlab-api")
2. Täitke ülejäänud nõutud väljad
3. Määrake sellele kontole turvaline password (parool)

3. samm: Seadistage API-juurdepääs

Seadistage uuele kasutajale järgmised juurdepääsuseaded:

1. Enable (Lülitage sisse) "Active API access" - see on integratsiooni toimimiseks kohustuslik
2. Disable (Lülitage välja) "Active panel access" - kasutajal ei ole vaja juurdepääsu administreerimispaneelile

4. samm: Määrake kasutajaroll ja õigused

Kasutajarolli seadistamiseks on kaks võimalust:

Valik A: Administraatori roll (lihtsam)

• Valige rolliks Administrator
• Kuna kasutajal puudub paneelipääs, on see turvaline lahendus, mis annab täielikud API-õigused

Valik B: Kohandatud kasutajaroll (täpsem)

Kui eelistate detailsemat kontrolli, valige Custom user ja seadistage järgmised mooduliõigused:

• Reservations - Ainult lugemisõigus (Read-only), kui chatbot peab ainult broneeringuinfot pärima, või täisõigus (Full access), kui chatbot hakkab broneeringuid looma
• Customers - Read-only
• Offers - Read-only

Kohandatud kasutajate puhul tuleb seadistada ka asukohaõigused:

1. Kerige jaotiseni Location and accommodation permissions
2. Soovitame valida Select all, et anda juurdepääs kõigile majutuskohtadele

5. samm: Lülitage välja mittevajalikud teavitused

Vältimaks olukorda, kus API-kasutaja saab operatiivseid teavitusi, lülitage välja järgmised valikud:

• Notifications for property staff - Lülitage välja (Disable)
• Automatic email notifications - Lülitage välja (Disable)

6. samm: Salvestage ja koguge ühenduse andmed

1. Kasutajakonto loomiseks klõpsake Save (Salvesta)
2. Kirjutage üles järgmine info - seda läheb vaja ChatLab-i seadistamisel:

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

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

2. osa: Integratsiooni seadistamine ChatLab-is

1. samm: Navigeerige vahekaardile Connect

1. Logige sisse oma ChatLab-i administreerimispaneeli
2. Valige bot, mida soovite seadistada
3. Minge vahekaardile Connect (Ühenda)
4. Otsige integratsioonide nimekirjast üles IdoBooking ja klõpsake sellel

2. samm: Sisestage ühenduse andmed

Täitke ühenduse vorm IdoBookingust kogutud andmetega:

• Client Subdomain - Sisestage oma IdoBookingu alamdomeen (ilma täieliku URL-ita). Näide: client3760 (mitte https://client3760.idosell.com)
• System Login - Sisestage IdoBookingus loodud API-kasutaja kasutajanimi
• System Password - Sisestage API-kasutaja parool
• Default Currency - Valige hinnainfo jaoks vaikevaluuta
• Default Language - Valige majutuskohtade kirjelduste jaoks vaiekeel

3. samm: Ühendage

1. Pärast kõigi nõutud väljade täitmist muutub nupp Connect (Ühenda) aktiivseks
2. Ühenduse loomiseks klõpsake Connect
3. Oodake kinnitussõnumit
4. Kui ühendus on loodud, kuvatakse õnnestumise teavitus

Pärast edukat ühendamist muutub nupp tekstist "Connect" tekstiks "Update Chatbot", samuti ilmub nupp "Disconnect", kui soovite integratsiooni hiljem eemaldada.

---

AI-tegevuste seadistamine

Kui teie IdoBooking integratsioon on (ükskõik kumma meetodiga) ühendatud, saate seadistada, milliseid AI-tegevusi teie chatbot teha tohib. Kui kasutasite marketplace-i kaudu seadistamist, on kõik tegevused vaikimisi sisse lülitatud.

Saadaolevad AI-tegevused

• Get Apartments - Kuvab nimekirja saadaolevatest korteritest ja majutuskohtadest koos kirjelduste, voodite jaotuse ning fotodega
• Find Available Apartments - Otsib saadaolevaid kortereid määratud ajavahemikuks koos hinnainfoga
• Check Apartment Availability - Kontrollib kindla korteri saadavust valitud kuupäevavahemikus
• Get Reservations - Otsib olemasolevaid broneeringuid ID, oleku või kuupäevavahemiku järgi
• Create Reservation - Loob uusi broneeringuid koos külalise andmete ja broneeringuinfoga

Tegevuste sisselülitamine ja kohandamine

1. Pärast ühendamist klõpsake õnnestumise modaalaknas nupule Configure AI Actions (Seadista AI-tegevusi) või navigeerige jaotisse Bot Settings > Actions ja otsige üles kategooria IdoBooking
2. Lülitage sisse tegevused, mida soovite kasutada
3. Kohandage vajadusel tegevuse silti (action label - kasutajale tegevuse käivitumisel kuvatav tekst) ja juhiseid
4. Muudatuste rakendamiseks klõpsake Save

Tegevuse "Find available apartments" seadistamine

Tegevusel Find available apartments on kaks lisavalikut, mis määravad, kui palju kortereid chatbot saadavuse küsimisel kuvab ja millised korterid valikusse pääsevad. Nende avamiseks minge jaotisse Bot Settings > Actions > IdoBooking - find available apartments.

Number of offers to show (Kuvatavate pakkumiste arv)

Liugur vahemikus 3-10 (vaikeväärtus 6). See määrab, mitu korterit chatbot kasutajale ühes vastuses esitab.

• Väiksemad väärtused (3-4) hoiavad vastuse lühikese ja konkreetsena, mis on hea siis, kui enamik külalisi valib vaid paari lemmiku vahel.
• Suuremad väärtused (8-10) pakuvad külalistele võrdlemiseks rohkem valikuid, mis sobib laia kataloogiga majutuskohtadele.

Offer selection strategy (Pakkumiste valikustrateegia)

Rippmenüü, mis otsustab, millised korterid valitakse pärast kuupäevade ja külaliste arvu järgi filtreerimist terviklikust saadaolevate tulemuste nimekirjast. Saadaval on neli valikut:

• Cheapest offers (Vaikimisi: Odavaimad pakkumised) - tagastab madalaima miinimumhinnaga korterid, sorteerituna odavaimast kallimani. Hea lahendus hinnatundlike külaliste puhul või kui soovite alustada kõige taskukohasematest variantidest.
• Evenly distributed by price (Hinna järgi ühtlaselt jaotatud) - valib korterid, mis jaotuvad hinnavahemikus ühtlaselt. Näiteks 9 pakkumise puhul tagastatakse umbes 3 odavaimat, 3 keskmise hinnaga ja 3 kõige kallimat. Kasulik siis, kui soovite külalistele näidata kogu saadavuse skaalat, mitte ainult soodsaimat otsa.
• Most expensive offers (Kõige kallimad pakkumised) - tagastab kõrgeima hinnaga korterid, sorteerituna kallimast odavamani. Sobib hästi premium-klassi majutuskohtadele või kui soovite esile tõsta tipptasemel pakkumisi.
• Random selection (Juhuslik valik) - valib filtreeritud tulemustest korterid juhuslikult. Kasulik juhul, kui soovite vestluste vahel esile tõstetavaid kortereid varieerida ja vältida pidevalt samade korterite soovitamist.

Mõlemad seaded salvestatakse boti tasemel koos kohandatud prompti ja tegevuse sildiga.

---

Parimad tavad

Turvalisuse soovitused (käsitsi seadistamisel)

• Kasutage eraldi API-kasutajat - Looge spetsiaalselt ChatLab-i integratsiooni jaoks eraldi kasutaja, mitte ärge kasutage oma isiklikku administraatorikontot
• Minimaalsed õigused - Andke ainult need õigused, mis on teie kasutusjuhu jaoks hädavajalikud. Kasutage lugemisõigust (read-only), kui chatbot peab ainult infot pärima
• Regulaarne mandaatide uuendamine - Uuendage perioodiliselt API-kasutaja parooli ning seejärel värskendage mandaate ChatLab-is

Chatboti vastuste optimeerimine

• Treenige oma boti majutuskoha infoga - Lisage teadmusbaasi oma majutuskohtade kirjeldused, sh mugavused, tubade omadused ja asukoha üksikasjad
• Kujundage selged vestlusvood - Seadistage tervitussõnumid, mis suunavad kasutajaid saadavuse kohta küsima, ning kasutage soovitatud küsimusi, näiteks "Kontrolli saadavust" või "Vaata tube"

---

Veaotsing

• Ühendus ebaõnnestub - Veenduge, et kasutajale on IdoBookingus sisse lülitatud "Active API access"
• "Access denied" vead - Kontrollige, kas kasutajale on määratud õiged mooduliõigused
• Andmeid ei tagastata - Veenduge, et kasutajal on juurdepääs vastavatele asukohtadele ja majutuskohtadele
• Vale alamdomeen - Kontrollige oma IdoBookingu URL-i ja eraldage sellest ainult alamdomeeni osa (nt client3760 aadressist https://client3760.idosell.com)

---