Integrācija ar IdoBooking

Savienojiet savu ChatLab tērzēšanas robotu ar savu IdoBooking rezervāciju sistēmu, lai vietnes apmeklētājiem nodrošinātu reāllaika informāciju par pieejamību un palīdzību rezervēšanā.

Ko sniedz integrācija

Kad IdoBooking integrācija ir iespējota, jūsu tērzēšanas robots var:

• Parādīt pieejamos dzīvokļus un naktsmītnes ar aprakstiem un fotoattēliem
• Pārbaudīt pieejamību konkrētiem datumiem
• Atrast pieejamos dzīvokļus norādītajam datumu diapazonam ar cenām
• Atrast esošās rezervācijas pēc ID, statusa vai datumu diapazona
• Izveidot jaunas rezervācijas ar viesu datiem

Šo integrāciju var iestatīt divos veidos - izmantojot IdoBooking Marketplace (ieteicams) vai manuāli ChatLab administratora panelī.

---

A variants: Iestatīšana, izmantojot IdoBooking Marketplace (ieteicams)

Ātrākais veids, kā savienot ChatLab ar IdoBooking, ir izmantot IdoBooking Marketplace. Šī metode automātiski apstrādā API akreditācijas datus un iespējo visas mākslīgā intelekta darbības jūsu tērzēšanas robotam.

1. darbība: Instalējiet ChatLab no IdoBooking Marketplace

1. Piesakieties savā IdoBooking administrācijas panelī
2. Dodieties uz sadaļu Marketplace (Tirgus)
3. Atrodiet ChatLab un noklikšķiniet uz Install (Instalēt)

IdoBooking automātiski nosūta jūsu API akreditācijas datus uz ChatLab - nav nepieciešams izveidot atsevišķu API lietotāju vai manuāli kopēt akreditācijas datus.

2. darbība: Izveidojiet savu ChatLab kontu vai piesakieties tajā

Pēc ChatLab aktivizēšanas tirgū jūs tiksiet novirzīts uz iestatīšanas vedni. Ja jums jau ir ChatLab konts, piesakieties. Pretējā gadījumā izveidojiet jaunu kontu.

3. darbība: Izvēlieties abonēšanas plānu

Izvēlieties savām vajadzībām atbilstošu abonēšanas plānu. IdoBooking rezervāciju integrācijas funkcijām (dzīvokļu meklēšana, pieejamības pārbaude, rezervācijas) ir nepieciešams STANDARD vai PREMIUM plāns.

4. darbība: Izvēlieties tērzēšanas robotu

Izvēlieties esošu tērzēšanas robotu, ko savienot ar IdoBooking, vai izveidojiet jaunu. Vednis var automātiski izveidot jaunu robotu jūsu vietā.

5. darbība: Pabeidziet iestatīšanu

Vednis automātiski:

• Piesaista jūsu IdoBooking akreditācijas datus izvēlētajam tērzēšanas robotam
• Iespējo visas pieejamās mākslīgā intelekta darbības (dzīvokļu meklēšana, pieejamības pārbaude, rezervācijas)
• Novirza jūs atpakaļ uz IdoBooking vai uz ChatLab administratora paneli

Pēc vedņa pabeigšanas jūsu tērzēšanas robots ir gatavs apstrādāt rezervāciju vaicājumus. Atsevišķas mākslīgā intelekta darbības varat precīzi pielāgot sadaļā Bot Settings > Actions (Robota iestatījumi > Darbības).

---

B variants: Manuāla iestatīšana

Ja vēlaties konfigurēt integrāciju manuāli, veiciet šīs darbības.

1. daļa: API lietotāja izveide sistēmā IdoBooking

Pirms ChatLab savienošanas ar savu IdoBooking sistēmu, IdoBooking panelī ir jāizveido īpašs lietotājs ar API piekļuvi.

1. darbība: Dodieties uz lietotāju pārvaldību

1. Piesakieties savā IdoBooking administrācijas panelī
2. Dodieties uz Settings > Users (Iestatījumi > Lietotāji)
3. Noklikšķiniet uz Add new user (Pievienot jaunu lietotāju)

2. darbība: Izveidojiet lietotāja kontu

1. Ievadiet jaunā lietotāja login name (pieteikšanās vārdu, piemēram, "chatlab-api")
2. Aizpildiet pārējo nepieciešamo informāciju
3. Iestatiet šim kontam drošu password (paroli)

3. darbība: Konfigurējiet API piekļuvi

Konfigurējiet šādus piekļuves iestatījumus jaunajam lietotājam:

1. Iespējojiet "Active API access" - tas ir nepieciešams, lai integrācija darbotos
2. Atspējojiet "Active panel access" - lietotājam nav nepieciešama piekļuve administratora panelim

4. darbība: Iestatiet lietotāja lomu un atļaujas

Lietotāja lomas konfigurēšanai ir divas iespējas:

A variants: Administratora loma (vienkāršāk)

• Izvēlieties lomu Administrator
• Tā kā lietotājam nebūs piekļuves panelim, šī ir droša iespēja, kas piešķir pilnas API atļaujas

B variants: Pielāgota lietotāja loma (detalizētāk)

Ja vēlaties detalizētāku kontroli, izvēlieties Custom user un konfigurējiet šādas moduļu atļaujas:

• Reservations - Read-only (tikai lasīšanai, ja tērzēšanas robotam ir tikai jāiegūst informācija par rezervācijām) vai Full access (pilna piekļuve, ja tērzēšanas robots veidos rezervācijas)
• Customers - Read-only (tikai lasīšanai)
• Offers - Read-only (tikai lasīšanai)

Pielāgotiem lietotājiem ir jākonfigurē arī atrašanās vietu atļaujas:

1. Ritiniet līdz sadaļai Location and accommodation permissions
2. Iesakām izvēlēties Select all, lai piešķirtu piekļuvi visiem objektiem

5. darbība: Atspējojiet nevajadzīgos paziņojumus

Lai API lietotājs nesaņemtu operatīvos paziņojumus, atspējojiet šādas opcijas:

• Notifications for property staff - Atspējot
• Automatic email notifications - Atspējot

6. darbība: Saglabājiet un apkopojiet savienojuma informāciju

1. Noklikšķiniet uz Save (Saglabāt), lai izveidotu lietotāja kontu
2. Piefiksējiet šādu informāciju - tā būs nepieciešama ChatLab konfigurēšanai:

• Login - Jūsu izveidotais lietotājvārds (piemēram, chatlab-api)
• Password - Jūsu iestatītā parole
• Subdomain - Jūsu IdoBooking apakšdomēns (piemēram, client3760)

Kā atrast savu apakšdomēnu: Apskatiet sava IdoBooking paneļa URL. Piemēram, ja jūsu URL ir https://client3760.idosell.com, jūsu apakšdomēns ir client3760.

2. daļa: Integrācijas iestatīšana sistēmā ChatLab

1. darbība: Dodieties uz cilni Connect

1. Piesakieties savā ChatLab administratora panelī
2. Izvēlieties robotu, kuru vēlaties konfigurēt
3. Dodieties uz cilni Connect (Savienot)
4. Integrāciju sarakstā atrodiet un noklikšķiniet uz IdoBooking

2. darbība: Ievadiet savienojuma datus

Aizpildiet savienojuma veidlapu ar informāciju, kas iegūta no IdoBooking:

• Client Subdomain - Ievadiet savu IdoBooking apakšdomēnu (bez pilnā URL). Piemērs: client3760 (nevis https://client3760.idosell.com)
• System Login - Ievadiet sistēmā IdoBooking izveidotā API lietotāja lietotājvārdu
• System Password - Ievadiet API lietotāja paroli
• Default Currency - Izvēlieties valūtu cenu informācijai
• Default Language - Izvēlieties valodu objektu aprakstiem

3. darbība: Izveidojiet savienojumu

1. Pēc visu nepieciešamo lauku aizpildīšanas poga Connect (Savienot) kļūst aktīva
2. Noklikšķiniet uz Connect, lai izveidotu savienojumu
3. Sagaidiet apstiprinājuma ziņojumu
4. Pēc savienojuma izveides redzēsiet paziņojumu par veiksmīgu darbību

Pēc veiksmīgas savienošanas pogas nosaukums mainās no "Connect" uz "Update Chatbot", un parādās poga "Disconnect", ja vēlāk integrāciju vajadzēs atspējot.

---

Mākslīgā intelekta darbību konfigurēšana

Kad IdoBooking integrācija ir pievienota (izmantojot jebkuru no metodēm), varat konfigurēt, kuras mākslīgā intelekta darbības jūsu tērzēšanas robots var veikt. Ja izmantojāt tirgus iestatīšanu, visas darbības ir iespējotas pēc noklusējuma.

Pieejamās mākslīgā intelekta darbības

• Get Apartments - Parāda pieejamos dzīvokļus un naktsmītnes ar aprakstiem, gultu konfigurācijām un fotoattēliem
• Find Available Apartments - Meklē pieejamos dzīvokļus norādītajam datumu diapazonam ar cenu informāciju
• Check Apartment Availability - Pārbauda konkrēta dzīvokļa pieejamību norādītajā datumu diapazonā
• Get Reservations - Atrod esošās rezervācijas pēc ID, statusa vai datumu diapazona
• Create Reservation - Izveido jaunas rezervācijas ar viesu datiem un rezervācijas informāciju

Darbību iespējošana un pielāgošana

1. Pēc savienojuma izveides sekmīgā rezultāta modālajā logā noklikšķiniet uz Configure AI Actions (Konfigurēt AI darbības) vai dodieties uz Bot Settings > Actions un atrodiet IdoBooking kategoriju
2. Iespējojiet darbības, kuras vēlaties aktivizēt
3. Pielāgojiet darbības nosaukumu (tekstu, kas tiek rādīts lietotājiem darbības izpildes laikā) un instrukcijas pēc nepieciešamības
4. Noklikšķiniet uz Save (Saglabāt), lai lietotu izmaiņas

Darbības "Find available apartments" konfigurēšana

Darbībai Find available apartments ir divi papildu iestatījumi, kas nosaka, cik daudz dzīvokļu tērzēšanas robots rāda, kad viesis jautā par pieejamību, un kuri dzīvokļi tiek atlasīti. Lai tiem piekļūtu, atveriet darbību no Bot Settings > Actions > IdoBooking - find available apartments.

Number of offers to show (Rādāmo piedāvājumu skaits)

Slīdnis ar diapazonu no 3 līdz 10 (pēc noklusējuma 6). Tas nosaka, cik daudz dzīvokļu tērzēšanas robots parāda lietotājam vienā atbildē.

• Mazākas vērtības (3-4) saglabā atbildi īsu un mērķtiecīgu, kas ir noderīgi, ja lielākā daļa viesu izvēlas starp dažiem variantiem.
• Lielākas vērtības (8-10) sniedz viesiem lielāku izvēli salīdzināšanai, kas ir noderīgi objektiem ar plašāku katalogu.

Offer selection strategy (Piedāvājumu atlases stratēģija)

Nolaižamā izvēlne, kas nosaka, kuri dzīvokļi tiek atlasīti no pilnā pieejamo rezultātu saraksta pēc tam, kad tie ir filtrēti pēc datuma un viesu skaita. Ir pieejamas četras iespējas:

• Cheapest offers (pēc noklusējuma) - atlasa dzīvokļus ar zemāko minimālo cenu, sakārtotus no lētākā līdz dārgākajam. Noderīgi, ja viesiem ir svarīga cena vai ja vēlaties vispirms piedāvāt pieejamākos variantus.
• Evenly distributed by price - atlasa dzīvokļus, kas vienmērīgi sadalīti visā cenu diapazonā. Piemēram, ar 9 piedāvājumiem tas sniedz aptuveni 3 lētākos, 3 vidējas cenas un 3 dārgākos dzīvokļus. Noderīgi, ja vēlaties, lai viesi redzētu visu pieejamo klāstu, nevis tikai budžeta segmentu.
• Most expensive offers - atlasa dzīvokļus ar augstākajām cenām, sakārtotus no dārgākā līdz lētākajam. Noderīgi luksusa klases naktsmītnēm vai gadījumos, kad vēlaties piedāvāt savus augstākās klases numurus.
• Random selection - nejauši izvēlas dzīvokļus no filtrētajiem rezultātiem. Noderīgi, ja vēlaties dažādot sarunās izceltos dzīvokļus un izvairīties no vienu un to pašu variantu atkārtotas ieteikšanas.

Abi iestatījumi tiek saglabāti katram robotam atsevišķi, līdzās esošajam pielāgotajam vaicājumam un darbības nosaukumam.

---

Labā prakse

Drošības ieteikumi (manuālai iestatīšanai)

• Izmantojiet īpašu API lietotāju - Izveidojiet atsevišķu lietotāju tieši ChatLab integrācijai, nevis izmantojiet savu personīgo administratora kontu
• Minimālās atļaujas - Piešķiriet tikai tās atļaujas, kas nepieciešamas jūsu lietošanas gadījumam. Izmantojiet tikai lasīšanas piekļuvi, ja tērzēšanas robotam ir tikai jāiegūst informācija
• Regulāra akreditācijas datu maiņa - Periodiski atjauniniet API lietotāja paroli un pēc tam atjauniniet akreditācijas datus sistēmā ChatLab

Tērzēšanas robota atbilžu optimizēšana

• Apmāciet savu robotu ar informāciju par naktsmītnēm - Pievienojiet zināšanu bāzei savu naktsmītņu aprakstus, tostarp ērtības, numuru funkcijas un atrašanās vietas informāciju
• Iestatiet skaidru sarunas gaitu - Konfigurējiet sagaidīšanas ziņojumus, kas mudina lietotājus jautāt par pieejamību, un izmantojiet ieteiktos jautājumus, piemēram, "Pārbaudīt pieejamību" vai "Apskatīt numurus"

---

Problēmu novēršana

• Neizdodas izveidot savienojumu - Pārbaudiet, vai sistēmā IdoBooking lietotājam ir iespējota opcija "Active API access"
• Kļūda "Access denied" (Piekļuve liegta) - Pārbaudiet, vai lietotājam ir piešķirtas pareizās moduļu atļaujas
• Netiek atgriezti dati - Pārliecinieties, vai lietotājam ir piekļuve attiecīgajām atrašanās vietām un objektiem
• Nepareizs apakšdomēns - Pārbaudiet savu IdoBooking URL un izmantojiet tikai apakšdomēna daļu (piemēram, client3760 no https://client3760.idosell.com)

---