Integracija sa IdoBooking-om

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.

Primer razgovora

Primer ilustruje korisničko iskustvo. Dostupne akcije i vraćene informacije zavise od ove integracije i Vaše konfiguracije.

Pre nego što počnete

Najpre kreirajte ili izaberite chatbot. Potrebna Vam je dozvola za upravljanje njegovim integracijama i pristup podešavanjima veze spoljnog naloga. Ako kartica Connect prikazuje prompt za nadogradnju ili kontakt, proverite da li Vaša pretplata uključuje ovu integraciju. Čuvajte API akreditive kao privatne; nikada ih nemojte lepiti u kod za ugrađivanje na veb-sajt.

Šta integracija pruža

Kada je integracija sa sistemom IdoBooking 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
• Pronalazi postojeće rezervacije prema 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 sistemom IdoBooking jeste putem IdoBooking Marketplace. Ovaj metod automatski obrađuje API akreditive i omogućava akcije čitanja za Vaš chatbot.

Korak 1: Instalirajte ChatLab sa IdoBooking Marketplace

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

IdoBooking automatski šalje Vaše API akreditive platformi ChatLab - nema potrebe da kreirate posebnog API korisnika ili ručno kopirate akreditive.

Korak 2: Kreirajte ili se prijavite na svoj ChatLab nalog

Nakon aktiviranja aplikacije ChatLab na platformi Marketplace, bićete preusmereni na vođeni čarobnjak za 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 funkciju IdoBooking integracije. Ako je Vaša pretplata ne uključuje, pratite prompt za nadogradnju ili kontakt.

Korak 4: Izaberite chatbot

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

Korak 5: Završite podešavanje

Čarobnjak automatski:

• Povezuje Vaše IdoBooking akreditive sa izabranim chatbotom
• Omogućava pretragu apartmana, provere dostupnosti i pregled rezervacija. Kreiranje rezervacija nije automatski omogućeno.
• Preusmerava Vas nazad na IdoBooking ili na ChatLab administratorski panel

Nakon završetka čarobnjaka, Vaš chatbot je spreman za obradu upita za rezervaciju. Možete fino podesiti pojedinačne AI akcije u Settings > Actions.

---

Opcija B: Ručno podešavanje

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

1. deo: Kreiranje API korisnika u sistemu IdoBooking

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

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

Konfigurišite sledeća podešavanja pristupa za novog korisnika:

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

Korak 4: Postavite korisničku ulogu i dozvole

Imate dve opcije za konfigurisanje korisničke uloge:

Opcija A: Uloga administratora (jednostavnije)

• Izaberite Administrator kao ulogu
• Ovo dodeljuje široke API dozvole čak i kada je pristup panelu onemogućen. Koristite prilagođenu ulogu ako su integraciji potrebne samo odabrane operacije čitanja.

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

Ako više volite detaljniju kontrolu, izaberite Custom user i konfigurišite sledeće dozvole modula:

• Reservations - Samo za čitanje (Read-only, ako chatbot treba samo da preuzima informacije o rezervaciji) ili Potpuni pristup (Full access, ako će chatbot kreirati rezervacije)
• Customers - Samo za čitanje (Read-only)
• Offers - Samo za čitanje (Read-only)

Za prilagođene korisnike takođe morate da konfigurišete dozvole za lokacije:

1. Pomerite se do odeljka Location and accommodation permissions (Dozvole za lokaciju i smeštaj)
2. Izaberite objekte koje ovaj chatbot treba da pokriva; dodelite pristup svima samo ako je to Vaš predviđeni obim.

Korak 5: Onemogućite nepotrebna obaveštenja

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

• Notifications for property staff - Onemogućite
• Automatic email notifications - Onemogućite

Korak 6: Sačuvajte i prikupite detalje o vezi

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

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

Pronalaženje Vašeg 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 platformi ChatLab

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 detalje o vezi

Popunite obrazac za povezivanje informacijama prikupljenim iz sistema IdoBooking:

• Client Subdomain - Unesite svoj IdoBooking poddomen (bez punog URL-a). Primer: client3760 (ne https://client3760.idosell.com)
• System Login - Unesite korisničko ime API korisnika kojeg ste kreirali u sistemu IdoBooking
• System Password - Unesite lozinku za API korisnika
• Default Currency - Izaberite valutu za informacije o cenama
• Default Language - 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 pojavljuje se i dugme "Disconnect" ako kasnije budete morali da onemogućite integraciju.

---

Konfigurisanje AI akcija

Kada se Vaša IdoBooking integracija poveže (bilo kojim metodom), možete da konfigurišete koje AI akcije Vaš chatbot može da izvršava. Pregledajte aktivne akcije nakon bilo kog metoda podešavanja. Kreiranje rezervacija nije automatski omogućeno.

Dostupne AI akcije

• Get Apartments - Prikazuje dostupne apartmane i smeštajne jedinice sa opisima, konfiguracijama kreveta i fotografijama
• Find Available Apartments - Traži dostupne apartmane za zadati raspon datuma sa informacijama o cenama
• Check Apartment Availability - Proverava dostupnost za određeni apartman i raspon datuma
• Get Reservations - Pronalazi postojeće rezervacije prema ID-ju, statusu ili rasponu datuma
• Create Reservation - Kreira nove rezervacije sa podacima o gostima i informacijama o rezervaciji
• AI room search - Upoređuje opis onoga što gost želi sa Vašim opisima soba, umesto provere datuma

AI room search i Get Apartments su alternative, a ne dopune. Kada je AI room search uključen, on zamenjuje običan alat za izlistavanje i Get Apartments se povlači iz chatbota, tako da je uvek aktivan samo jedan alat za izlistavanje soba. Akcije zasnovane na datumima ostaju nepromenjene.

Omogućavanje i prilagođavanje akcija

1. Nakon povezivanja, kliknite na Configure AI Actions (Konfiguriši AI akcije) u modalnom prozoru za uspeh, ili idite na Settings > Actions (Podešavanja > Akcije) 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. U dijalogu akcije kliknite na Enable (Omogući) za novu akciju ili Update (Ažuriraj) za postojeću akciju.

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 uži izbor. Otvorite akciju u Settings > Actions > IdoBooking - find available apartments da biste im pristupili.

Number of offers to show

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

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

Offer selection strategy

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

• Cheapest offers (podrazumevano) - vraća apartmane sa najnižom minimalnom cenom, sortirane od najjeftinijih do najskupljih. Dobro kada su gosti osetljivi na cene ili želite da ponudite najpristupačnije opcije.
• Evenly distributed by price - bira apartmane ravnomerno raspoređene po rasponu cena. Na primer, sa 9 ponuda ovo 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 budžetsku ponudu.
• Most expensive offers - vraća apartmane sa najvišim cenama, sortirane od najskupljih do najmanje skupih. Dobro za premijum objekte ili kada želite da istaknete svoj vrhunski asortiman.
• Random selection - nasumično bira apartmane iz filtriranih rezultata. Korisno kada želite da promenite koji su apartmani istaknuti u različitim razgovorima i izbegnete stalno preporučivanje istih.

Oba podešavanja se čuvaju po botu, zajedno sa postojećim prilagođenim promptom i oznakom akcije.

---

Testirajte završeno podešavanje

Otvorite Overview (Pregled) i započnite novi probni razgovor. Zatražite sobe za budući raspon datuma i određeni broj gostiju, a zatim otvorite vraćeni link za rezervaciju i uporedite datume, valutu i cenu sa sistemom IdoBooking. Testirajte pretragu rezervacija sa rezervacijom koju ste ovlašćeni da pregledate. Omogućite i testirajte Create Reservation samo kada nameravate da napravite pravu rezervaciju; test putem ćaskanja može da upisuje podatke u Vaš sistem rezervacija.

Najbolje prakse

Bezbednosne preporuke (ručno podešavanje)

• Koristite namenskog API korisnika - Kreirajte posebnog korisnika isključivo 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 rotacija akreditiva - Periodično ažurirajte lozinku API korisnika, a zatim ažurirajte akreditive u platformi ChatLab

Optimizacija odgovora chatbota

• Trenirajte svog bota podacima o objektu - Dodajte opise svojih smeštajnih jedinica u bazu znanja, uključujući sadržaje, karakteristike soba i detalje o lokaciji
• Postavite jasne tokove razgovora - Konfigurišite poruke dobrodošlice koje usmeravaju 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 opcija "Active API access" omogućena za korisnika u sistemu IdoBooking
• Greške tipa "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 svoj IdoBooking URL i izdvojite samo deo poddomena (npr. client3760 iz https://client3760.idosell.com)

---

Katalog soba i pregled hotela

Ako Vaš nalog prikazuje karticu Hotel, koristite Hotel > Rooms (Hotel > Sobe) da biste pregledali katalog soba i status treniranja. AI room search je odvojen od provera dostupnosti zasnovanih na datumima: on upoređuje opise soba, dok akcije dostupnosti proveravaju traženi boravak. Automatsko indeksiranje soba zavisi od automatskog indeksiranja kataloga i dodeljenog limita za indeksirane sobe; u suprotnom, koristite Train rooms (Treniraj sobe) kada je dostupno. Pregledajte omogućene akcije i sačekajte da se treniranje završi pre nego što se oslonite na AI room search.

Povezani članci

• Dodavanje chatbota na Vaš veb-sajt
• Treniranje Vašeg chatbota
• Slanje linka ka Vašem chatbotu