Integracija sa IdoBooking sistemom

Povežite svoj ChatLab chatbot sa svojim IdoBooking sistemom za rezervacije kako biste posetiocima veb-sajta pružili informacije o dostupnosti u realnom vremenu i pomoć pri rezervaciji.

Šta integracija pruža

Kada je IdoBooking integracija omogućena, Vaš chatbot može da:

• Prikazuje dostupne apartmane i smeštajne jedinice sa opisima i fotografijama
• Proverava dostupnost za određene datume
• Pronalazi dostupne apartmane za zadati raspon datuma sa cenama
• Pretražuje postojeće rezervacije po ID-ju, statusu ili rasponu datuma
• Kreira nove rezervacije sa podacima o gostima

Postoje dva načina za podešavanje ove integracije - putem IdoBooking Marketplace (preporučeno) ili ručno putem ChatLab administratorskog panela.

---

Opcija A: Podešavanje putem IdoBooking Marketplace (preporučeno)

Najbrži način da povežete ChatLab sa IdoBooking sistemom je putem IdoBooking Marketplace-a. Ovaj metod automatski obrađuje API pristupne podatke i omogućava sve AI akcije za Vaš chatbot.

Korak 1: Instalirajte ChatLab sa IdoBooking Marketplace-a

1. Prijavite se na svoj IdoBooking administratorski panel
2. Idite na odeljak Marketplace
3. Pronađite ChatLab i kliknite na Install (Instaliraj)

IdoBooking automatski šalje Vaše API pristupne podatke u ChatLab - nema potrebe da kreirate zasebnog API korisnika ili ručno kopirate podatke.

Korak 2: Kreirajte ili se prijavite na svoj ChatLab nalog

Nakon aktiviranja ChatLab-a na marketplace-u, bićete preusmereni na čarobnjak za vođeno podešavanje. Ako već imate ChatLab nalog, prijavite se. U suprotnom, kreirajte novi nalog.

Korak 3: Izaberite plan pretplate

Izaberite plan pretplate koji odgovara Vašim potrebama. Funkcije IdoBooking integracije za rezervacije (pretraga apartmana, provera dostupnosti, rezervacije) zahtevaju plan STANDARD ili PREMIUM.

Korak 4: Izaberite chatbot

Izaberite postojeći chatbot koji želite da povežete sa IdoBooking sistemom ili kreirajte novi. Čarobnjak može automatski kreirati novog bota za Vas.

Korak 5: Završite podešavanje

Čarobnjak automatski:

• Povezuje Vaše IdoBooking pristupne podatke sa izabranim chatbotom
• Omogućava sve dostupne AI akcije (pretraga apartmana, provera dostupnosti, rezervacije)
• Preusmerava Vas nazad na IdoBooking ili na ChatLab administratorski panel

Nakon završetka čarobnjaka, Vaš chatbot je spreman za obradu upita za rezervaciju. Pojedinačne AI akcije možete detaljno podesiti u Bot Settings > Actions (Podešavanja bota > Akcije).

---

Opcija B: Ručno podešavanje

Ako više volite da integraciju konfigurišete ručno, pratite ove korake.

1. deo: Kreiranje API korisnika u IdoBooking-u

Pre povezivanja ChatLab-a sa Vašim IdoBooking sistemom, potrebno je da u svom IdoBooking panelu kreirate namenskog korisnika sa API pristupom.

Korak 1: Idite na upravljanje korisnicima

1. Prijavite se na svoj IdoBooking administratorski panel
2. Idite na Settings > Users (Podešavanja > Korisnici)
3. Kliknite na Add new user (Dodaj novog korisnika)

Korak 2: Kreirajte korisnički nalog

1. Unesite login name (korisničko ime) za novog korisnika (npr. „chatlab-api”)
2. Popunite preostale obavezne podatke
3. Postavite bezbednu password (lozinku) za ovaj nalog

Korak 3: Konfigurišite API pristup

Podesite sledeća podešavanja pristupa za novog korisnika:

1. Omogućite „Active API access” (Aktivan API pristup) - ovo je neophodno da bi integracija radila
2. Onemogućite „Active panel access” (Aktivan pristup panelu) - korisniku nije potreban pristup administratorskom panelu

Korak 4: Postavite ulogu korisnika i dozvole

Imate dve opcije za konfigurisanje korisničke uloge:

Opcija A: Uloga Administrator (jednostavnija)

• Izaberite Administrator kao ulogu
• Pošto korisnik neće imati pristup panelu, ovo je bezbedna opcija koja dodeljuje pune API dozvole

Opcija B: Prilagođena korisnička uloga (preciznija kontrola)

Ako više volite detaljniju kontrolu, izaberite Custom user (Prilagođeni korisnik) i konfigurišite sledeće dozvole za module:

• Reservations (Rezervacije) - Samo za čitanje (ako chatbot treba samo da preuzima informacije o rezervacijama) ili Pun pristup (ako će chatbot kreirati rezervacije)
• Customers (Klijenti) - Samo za čitanje
• Offers (Ponude) - Samo za čitanje

Za prilagođene korisnike takođe morate konfigurisati dozvole za lokacije:

1. Pomaknite se do odeljka Location and accommodation permissions (Dozvole za lokacije i smeštaj)
2. Preporučujemo da izaberete Select all (Izaberi sve) kako biste odobrili pristup svim objektima

Korak 5: Onemogućite nepotrebna obaveštenja

Da biste sprečili da API korisnik prima operativna obaveštenja, onemogućite sledeće opcije:

• Notifications for property staff (Obaveštenja za osoblje objekta) - Onemogućite
• Automatic email notifications (Automatska obaveštenja putem e-pošte) - Onemogućite

Korak 6: Sačuvajte i prikupite podatke za povezivanje

1. Kliknite na Save (Sačuvaj) da kreirate korisnički nalog
2. Zabeležite sledeće informacije - biće Vam potrebne za konfiguraciju ChatLab-a:

• Login - Korisničko ime koje ste kreirali (npr. chatlab-api)
• Password - Lozinka koju ste postavili
• Subdomain - Vaš IdoBooking poddomen (npr. client3760)

Pronalaženje poddomena: Pogledajte URL adresu svog IdoBooking panela. Na primer, ako je Vaša URL adresa https://client3760.idosell.com, Vaš poddomen je client3760.

2. deo: Podešavanje integracije u ChatLab-u

Korak 1: Idite na karticu Connect

1. Prijavite se na svoj ChatLab administratorski panel
2. Izaberite bota kojeg želite da konfigurišete
3. Idite na karticu Connect (Poveži)
4. Pronađite i kliknite na IdoBooking na listi integracija

Korak 2: Unesite podatke za povezivanje

Popunite obrazac za povezivanje podacima prikupljenim iz IdoBooking-a:

• Client Subdomain (Poddomen klijenta) - Unesite svoj IdoBooking poddomen (bez punog URL-a). Primer: client3760 (ne https://client3760.idosell.com)
• System Login (Sistemsko korisničko ime) - Unesite korisničko ime API korisnika kojeg ste kreirali u IdoBooking-u
• System Password (Sistemska lozinka) - Unesite lozinku za API korisnika
• Default Currency (Podrazumevana valuta) - Izaberite valutu za informacije o cenama
• Default Language (Podrazumevani jezik) - Izaberite jezik za opise objekata

Korak 3: Povežite se

1. Nakon popunjavanja svih obaveznih polja, dugme Connect (Poveži) postaje aktivno
2. Kliknite na Connect da uspostavite vezu
3. Sačekajte poruku potvrde
4. Kada se poveže, videćete obaveštenje o uspehu

Nakon uspešnog povezivanja, dugme se menja iz „Connect” u „Update Chatbot” (Ažuriraj chatbot), a pojavljuje se i dugme „Disconnect” (Prekini vezu) ako kasnije budete želeli da onemogućite integraciju.

---

Konfigurisanje AI akcija

Kada se Vaša IdoBooking integracija poveže (bilo kojim metodom), možete konfigurisati koje AI akcije Vaš chatbot može da izvršava. Ako ste koristili podešavanje putem marketplace-a, sve akcije su podrazumevano omogućene.

Dostupne AI akcije

• Get Apartments - Prikazuje dostupne apartmane i smeštajne jedinice sa opisima, rasporedom kreveta i fotografijama
• Find Available Apartments - Pretražuje dostupne apartmane za zadati raspon datuma sa informacijama o cenama
• Check Apartment Availability - Proverava dostupnost za određeni apartman i raspon datuma
• Get Reservations - Pretražuje postojeće rezervacije po ID-ju, statusu ili rasponu datuma
• Create Reservation - Kreira nove rezervacije sa podacima o gostima i informacijama o rezervaciji

Omogućavanje i prilagođavanje akcija

1. Nakon povezivanja, kliknite na Configure AI Actions (Konfiguriši AI akcije) u prozoru za potvrdu uspeha, ili idite na Bot Settings > Actions i pronađite kategoriju IdoBooking
2. Uključite akcije koje želite da omogućite
3. Prilagodite oznaku akcije (tekst koji se prikazuje korisnicima dok se akcija izvršava) i uputstva po potrebi
4. Kliknite na Save (Sačuvaj) da primenite promene

Konfigurisanje akcije „Find available apartments”

Akcija Find available apartments ima dve dodatne kontrole koje određuju koliko apartmana chatbot prikazuje kada gost pita za dostupnost i koji apartmani ulaze u izbor. Otvorite akciju iz Bot Settings > Actions > IdoBooking - find available apartments da biste im pristupili.

Number of offers to show (Broj ponuda za prikaz)

Klizač u rasponu od 3 do 10 (podrazumevano 6). Kontroliše koliko apartmana chatbot vraća korisniku u jednom odgovoru.

• Manje vrednosti (3-4) održavaju odgovor kratkim i fokusiranim, što je korisno kada se većina gostiju odlučuje između samo nekoliko favorita.
• Veće vrednosti (8-10) daju gostima veći izbor za poređenje, što je korisno za objekte sa širim katalogom.

Offer selection strategy (Strategija izbora ponuda)

Padajući meni koji određuje koji se apartmani biraju sa kompletne liste dostupnih rezultata nakon filtriranja po datumu i broju gostiju. Dostupne su četiri opcije:

• Cheapest offers (Najjeftinije ponude - podrazumevano) - vraća apartmane sa najnižom minimalnom cenom, sortirane od najjeftinijih ka najskupljim. Dobro kada su gosti osetljivi na cene ili kada želite da prvo ponudite najpristupačnije opcije.
• Evenly distributed by price (Ravnomerno raspoređeno po ceni) - bira apartmane ravnomerno raspoređene u celom rasponu cena. Na primer, sa 9 ponuda to daje otprilike 3 najjeftinije, 3 srednje cene i 3 najskuplje. Korisno kada želite da gosti vide pun raspon onoga što je dostupno, a ne samo najpovoljniju ponudu.
• Most expensive offers (Najskuplje ponude) - vraća apartmane sa najvišom cenom, sortirane od najskupljih ka najjeftinijim. Dobro za premijum objekte ili kada želite da istaknete svoju ponudu najvišeg nivoa.
• Random selection (Nasumičan izbor) - nasumično bira apartmane iz filtriranih rezultata. Korisno kada želite da promenite koji se apartmani ističu između različitih razgovora i izbegnete stalno preporučivanje istih.

Oba podešavanja se čuvaju pojedinačno za svakog bota, zajedno sa postojećim prilagođenim promptom i oznakom akcije.

---

Najbolje prakse

Bezbednosne preporuke (ručno podešavanje)

• Koristite namenskog API korisnika - Kreirajte zasebnog korisnika specifično za ChatLab integraciju, umesto da koristite svoj lični administratorski nalog
• Minimalne dozvole - Dodelite samo one dozvole koje su neophodne za Vaš slučaj upotrebe. Koristite pristup samo za čitanje ako chatbot treba samo da preuzima informacije
• Redovna promena pristupnih podataka - Povremeno ažurirajte lozinku API korisnika, a zatim ažurirajte pristupne podatke u ChatLab-u

Optimizacija odgovora chatbota

• Trenirajte svog bota podacima o objektu - Dodajte opise svojih smeštajnih jedinica u bazu znanja, uključujući pogodnosti, karakteristike soba i detalje o lokaciji
• Postavite jasne tokove razgovora - Konfigurišite pozdravne poruke koje vode korisnike da pitaju o dostupnosti i koristite predložena pitanja kao što su „Proveri dostupnost” ili „Pogledaj sobe”

---

Rešavanje problema

• Povezivanje ne uspeva - Proverite da li je „Active API access” omogućen za korisnika u IdoBooking-u
• Greške „Access denied” (Pristup odbijen) - Proverite da li korisnik ima ispravne dozvole za module
• Nema vraćenih podataka - Uverite se da korisnik ima pristup relevantnim lokacijama i objektima
• Netačan poddomen - Proverite svoju IdoBooking URL adresu i izdvojite samo deo poddomena (npr. client3760 iz https://client3760.idosell.com)

---