Integrácia s IdoBooking

Prepojte svojho ChatLab chatbota s rezervačným systémom IdoBooking a poskytujte návštevníkom svojho webu informácie o dostupnosti v reálnom čase aj asistenciu pri rezervácii.

Čo integrácia prináša

So zapnutou integráciou IdoBooking dokáže váš chatbot:

• Zobraziť zoznam dostupných apartmánov a ubytovacích jednotiek s popismi a fotografiami
• Overiť dostupnosť pre konkrétne termíny
• Vyhľadať voľné apartmány pre zadané časové obdobie vrátane cien
• Vyhľadať existujúce rezervácie podľa ID, stavu alebo rozsahu dátumov
• Vytvárať nové rezervácie s údajmi o hosťoch

Túto integráciu môžete nastaviť dvoma spôsobmi - cez IdoBooking Marketplace (odporúčané) alebo manuálne v administračnom paneli ChatLab.

---

Možnosť A: Nastavenie cez IdoBooking Marketplace (odporúčané)

Najrýchlejším spôsobom prepojenia ChatLab s IdoBooking je použitie IdoBooking Marketplace. Tento postup automaticky prenesie prihlasovacie údaje k API a aktivuje všetky AI akcie pre vášho chatbota.

Krok 1: Inštalácia ChatLab z IdoBooking Marketplace

1. Prihláste sa do svojho administračného panelu IdoBooking
2. Prejdite do sekcie Marketplace (Trhovisko)
3. Vyhľadajte ChatLab a kliknite na Install (Inštalovať)

IdoBooking odošle vaše API prístupy do ChatLab automaticky - nie je potrebné vytvárať samostatného API používateľa ani kopírovať údaje ručne.

Krok 2: Vytvorenie alebo prihlásenie do účtu ChatLab

Po aktivácii ChatLab v marketplace budete presmerovaní do sprievodcu nastavením. Ak už účet v ChatLab máte, prihláste sa. V opačnom prípade si vytvorte nový účet.

Krok 3: Výber predplatného

Vyberte si plán predplatného, ktorý vyhovuje vašim potrebám. Funkcie rezervačnej integrácie IdoBooking (vyhľadávanie apartmánov, kontrola dostupnosti, vytváranie rezervácií) vyžadujú plán STANDARD alebo PREMIUM.

Krok 4: Výber chatbota

Vyberte existujúceho chatbota, ktorého chcete prepojiť s IdoBooking, alebo vytvorte nového. Sprievodca môže nového bota vytvoriť automaticky.

Krok 5: Dokončenie nastavenia

Sprievodca automaticky:

• Prepojí vaše prístupové údaje IdoBooking so zvoleným chatbotom
• Aktivuje všetky dostupné AI akcie (vyhľadávanie apartmánov, kontrola dostupnosti, rezervácie)
• Presmeruje vás späť do IdoBooking alebo do administračného panelu ChatLab

Po dokončení sprievodcu je váš chatbot pripravený odpovedať na otázky týkajúce sa rezervácií. Jednotlivé AI akcie môžete doladiť v časti Bot Settings > Actions (Nastavenia bota > Akcie).

---

Možnosť B: Manuálne nastavenie

Ak preferujete manuálnu konfiguráciu integrácie, postupujte podľa nasledujúcich krokov.

Časť 1: Vytvorenie API používateľa v IdoBooking

Pred prepojením ChatLab so systémom IdoBooking musíte v paneli IdoBooking vytvoriť vyhradeného používateľa s prístupom k API.

Krok 1: Prejdite do správy používateľov

1. Prihláste sa do svojho administračného panelu IdoBooking
2. Prejdite na Settings > Users (Nastavenia > Používatelia)
3. Kliknite na Add new user (Pridať nového používateľa)

Krok 2: Vytvorenie používateľského účtu

1. Zadajte login name (prihlasovacie meno) pre nového používateľa (napr. "chatlab-api")
2. Vyplňte zvyšné požadované údaje
3. Nastavte pre tento účet bezpečné password (heslo)

Krok 3: Konfigurácia prístupu k API

Pre nového používateľa nastavte nasledujúce prístupové práva:

1. Povoľte (Enable) "Active API access" - toto nastavenie je nevyhnutné pre fungovanie integrácie
2. Zakážte (Disable) "Active panel access" - používateľ nepotrebuje prístup do administračného panelu

Krok 4: Nastavenie používateľskej roly a oprávnení

Pri konfigurácii roly používateľa máte dve možnosti:

Možnosť A: Rola administrátora (jednoduchšia)

• Ako rolu vyberte Administrator (Administrátor)
• Keďže používateľ nebude mať prístup do panelu, ide o bezpečnú možnosť, ktorá udelí plné API oprávnenia

Možnosť B: Vlastná používateľská rola (detailnejšie nastavenie)

Ak uprednostňujete presnejšiu kontrolu, zvoľte Custom user (Vlastný používateľ) a nastavte nasledujúce oprávnenia pre moduly:

• Reservations (Rezervácie) - Read-only (len na čítanie, ak má chatbot iba získavať informácie o rezerváciách) alebo Full access (plný prístup, ak bude chatbot rezervácie aj vytvárať)
• Customers (Zákazníci) - Read-only
• Offers (Ponuky) - Read-only

Pri vlastnom používateľovi musíte nastaviť aj oprávnenia pre lokality:

1. Prejdite do sekcie Location and accommodation permissions (Oprávnenia pre lokality a ubytovanie)
2. Odporúčame vybrať Select all (Vybrať všetko), čím udelíte prístup ku všetkým objektom

Krok 5: Vypnutie nepotrebných notifikácií

Aby API používateľ nedostával prevádzkové oznámenia, vypnite nasledujúce možnosti:

• Notifications for property staff (Upozornenia pre personál ubytovacieho zariadenia) - Disable (Zakázať)
• Automatic email notifications (Automatické e-mailové notifikácie) - Disable (Zakázať)

Krok 6: Uloženie a zhromaždenie údajov na pripojenie

1. Kliknutím na Save (Uložiť) vytvorte používateľský účet
2. Poznačte si nasledujúce informácie - budete ich potrebovať pri konfigurácii v ChatLab:

• Login - Používateľské meno, ktoré ste vytvorili (napr. chatlab-api)
• Password - Heslo, ktoré ste nastavili
• Subdomain - Vaša IdoBooking subdoména (napr. client3760)

Ako zistiť svoju subdoménu: Pozrite sa na URL adresu svojho IdoBooking panelu. Ak je vaša URL napríklad https://client3760.idosell.com, vaša subdoména je client3760.

Časť 2: Nastavenie integrácie v ChatLab

Krok 1: Prejdite na kartu Connect

1. Prihláste sa do svojho administračného panelu ChatLab
2. Vyberte bota, ktorého chcete konfigurovať
3. Prejdite na kartu Connect (Pripojiť)
4. V zozname integrácií vyhľadajte a kliknite na IdoBooking

Krok 2: Zadanie údajov na pripojenie

Vyplňte formulár údajmi získanými zo systému IdoBooking:

• Client Subdomain (Subdoména klienta) - Zadajte subdoménu IdoBooking (bez celej URL adresy). Príklad: client3760 (nie https://client3760.idosell.com)
• System Login (Systémový login) - Zadajte prihlasovacie meno API používateľa, ktorého ste vytvorili v IdoBooking
• System Password (Systémové heslo) - Zadajte heslo daného API používateľa
• Default Currency (Predvolená mena) - Vyberte menu pre zobrazovanie cien
• Default Language (Predvolený jazyk) - Vyberte jazyk pre popisy ubytovania

Krok 3: Pripojenie

1. Po vyplnení všetkých povinných polí sa tlačidlo Connect (Pripojiť) aktivuje
2. Kliknite na Connect a nadviažte spojenie
3. Počkajte na potvrdzujúcu správu
4. Po úspešnom pripojení sa zobrazí potvrdzovacie oznámenie

Po úspešnom prepojení sa nápis na tlačidle zmení z "Connect" na "Update Chatbot" (Aktualizovať chatbota) a pribudne tlačidlo "Disconnect" (Odpojiť), ak by ste v budúcnosti potrebovali integráciu zrušiť.

---

Konfigurácia AI akcií

Akonáhle je vaša integrácia s IdoBooking pripojená (akýmkoľvek zo spôsobov), môžete nastaviť, ktoré AI akcie má chatbot vykonávať. Ak ste využili inštaláciu cez marketplace, všetky akcie sú predvolene aktivované.

Dostupné AI akcie

• Get Apartments - Zobrazí zoznam dostupných apartmánov a ubytovaní s popismi, konfiguráciou postelí a fotografiami
• Find Available Apartments - Vyhľadá voľné apartmány pre zadaný rozsah dátumov spolu s informáciami o cenách
• Check Apartment Availability - Overí dostupnosť konkrétneho apartmánu v zadanom termíne
• Get Reservations - Vyhľadá existujúce rezervácie podľa ID, stavu alebo rozsahu dátumov
• Create Reservation - Vytvorí nové rezervácie s údajmi o hosťoch a rezervačnými detailmi

Aktivácia a prispôsobenie akcií

1. Po pripojení kliknite na Configure AI Actions (Konfigurovať AI akcie) v potvrdzovacom dialógu, prípadne prejdite do Bot Settings > Actions a vyhľadajte kategóriu IdoBooking
2. Zapnite prepínače pri akciách, ktoré chcete povoliť
3. Podľa potreby upravte štítok akcie (text, ktorý sa používateľom zobrazuje počas vykonávania akcie) a inštrukcie
4. Zmeny uložte kliknutím na Save (Uložiť)

Nastavenie akcie "Find available apartments"

Akcia Find available apartments ponúka dve dodatočné nastavenia, ktoré určujú, koľko apartmánov chatbot hosťovi pri otázke na dostupnosť ponúkne a ktoré z nich vyberie. Otvorte akciu v časti Bot Settings > Actions > IdoBooking - find available apartments, kde tieto voľby nájdete.

Number of offers to show (Počet zobrazovaných ponúk)

Posuvník s rozsahom od 3 do 10 (predvolená hodnota je 6). Určuje, koľko apartmánov chatbot vráti používateľovi v rámci jednej odpovede.

• Nižšie hodnoty (3-4) udržujú odpoveď stručnú a cielenú, čo je ideálne, ak sa väčšina hostí rozhoduje medzi niekoľkými favoritmi.
• Vyššie hodnoty (8-10) poskytujú hosťom širší výber na porovnanie, čo oceníte pri zariadeniach s rozsiahlejšou ponukou.

Offer selection strategy (Stratégia výberu ponúk)

Rozbaľovacia ponuka, ktorá riadi, ktoré apartmány sa vyberú z celkového zoznamu voľných výsledkov po vyfiltrovaní podľa termínu a počtu hostí. K dispozícii sú štyri možnosti:

• Cheapest offers (Najlacnejšie ponuky - predvolené) - vráti apartmány s najnižšou minimálnou cenou, zoradené od najlacnejších po najdrahšie. Vhodné, ak hostia hľadia primárne na cenu alebo chcete v prvom rade prezentovať cenovo najdostupnejšie ubytovanie.
• Evenly distributed by price (Rovnomerne rozložené podľa ceny) - vyberie apartmány naprieč celým cenovým rozpätím. Napríklad pri 9 ponukách vyberie približne 3 najlacnejšie, 3 v strednej kategórii a 3 najdrahšie. Užitočné, ak chcete hosťom ukázať celú šírku ponuky a nielen lacnejší segment.
• Most expensive offers (Najdrahšie ponuky) - vráti apartmány s najvyššou cenou, zoradené od najdrahších po najlacnejšie. Ideálne pre prémiové ubytovacie zariadenia alebo v prípade, že chcete uprednostniť najvyššiu kategóriu izieb.
• Random selection (Náhodný výber) - vyberie apartmány z vyfiltrovaných výsledkov náhodne. Vhodné, ak chcete v jednotlivých konverzáciách ponuku obmieňať a neodporúčať neustále tie isté izby.

Obe nastavenia sa ukladajú pre každého bota samostatne, spolu s existujúcim vlastným promptom a štítkom akcie.

---

Osvedčené postupy

Bezpečnostné odporúčania (manuálne nastavenie)

• Používajte vyhradeného API používateľa - Vytvorte samostatného používateľa výhradne pre integráciu ChatLab namiesto použitia osobného administrátorského účtu
• Minimálne oprávnenia - Udeľte iba tie oprávnenia, ktoré sú pre váš scenár nevyhnutné. Ak má chatbot informácie iba vyhľadávať, nastavte prístup len na čítanie (read-only)
• Pravidelná obmena prihlasovacích údajov - Pravidelne meňte heslo API používateľa a následne ho aktualizujte aj v ChatLab

Optimalizácia odpovedí chatbota

• Natrénujte bota informáciami o ubytovaní - Pridajte do vedomostnej bázy podrobné popisy vašich ubytovacích jednotiek vrátane vybavenia, vlastností izieb a detailov o lokalite
• Nastavte zrozumiteľné toky konverzácie - Nastavte uvítacie správy tak, aby naviedli používateľov na otázky o dostupnosti, a využite navrhované otázky ako "Skontrolovať dostupnosť" alebo "Zobraziť izby"

---

Riešenie problémov

• Spojenie zlyhalo - Overte, či má používateľ v systéme IdoBooking povolenú možnosť "Active API access"
• Chyby typu "Access denied" (Prístup odmietnutý) - Skontrolujte, či má používateľ správne nastavené oprávnenia pre jednotlivé moduly
• Nevracajú sa žiadne údaje - Uistite sa, že používateľ má prístup k príslušným lokalitám a objektom
• Nesprávna subdoména - Skontrolujte URL adresu svojho IdoBooking systému a vyberte z nej iba časť subdomény (napr. client3760 z https://client3760.idosell.com)

---