Integrace s IdoBooking

Propojte svého chatbota ChatLab s rezervačním systémem IdoBooking a poskytujte návštěvníkům svého webu informace o dostupnosti v reálném čase i asistenci při rezervaci.

Co integrace nabízí

S aktivovanou integrací IdoBooking může váš chatbot:

• Zobrazovat dostupné apartmány a ubytování včetně popisů a fotografií
• Ověřovat dostupnost pro konkrétní termíny
• Vyhledávat volné apartmány pro zadané časové období včetně cen
• Vyhledávat existující rezervace podle ID, stavu nebo časového období
• Vytvářet nové rezervace s údaji o hostech

Tuto integraci lze nastavit dvěma způsoby - prostřednictvím IdoBooking Marketplace (doporučeno), nebo ručně v administračním panelu ChatLab.

---

Možnost A: Nastavení přes IdoBooking Marketplace (doporučeno)

Nejrychlejším způsobem, jak propojit ChatLab s IdoBooking, je právě IdoBooking Marketplace. Tento způsob vyřídí přihlašovací údaje k API automaticky a aktivuje všechny AI akce pro vašeho chatbota.

Krok 1: Instalace ChatLab z IdoBooking Marketplace

1. Přihlaste se do svého administračního panelu IdoBooking
2. Přejděte do sekce Marketplace
3. Vyhledejte ChatLab a klikněte na Install (Instalovat)

IdoBooking odešle vaše přihlašovací údaje k API do ChatLab automaticky - není nutné vytvářet samostatného API uživatele ani údaje ručně kopírovat.

Krok 2: Vytvoření nebo přihlášení k účtu ChatLab

Po aktivaci ChatLab v marketplace budete přesměrováni do průvodce nastavením. Pokud již účet ChatLab máte, přihlaste se. V opačném případě si vytvořte nový účet.

Krok 3: Výběr plánu předplatného

Vyberte si plán předplatného, který vyhovuje vašim potřebám. Funkce rezervační integrace s IdoBooking (vyhledávání apartmánů, kontrola dostupnosti, rezervace) vyžadují plán STANDARD nebo PREMIUM.

Krok 4: Výběr chatbota

Vyberte existujícího chatbota, kterého chcete propojit s IdoBooking, nebo vytvořte nového. Průvodce vám může nového bota vytvořit automaticky.

Krok 5: Dokončení nastavení

Průvodce automaticky:

• Propojí vaše přihlašovací údaje IdoBooking se zvoleným chatbotem
• Aktivuje všechny dostupné AI akce (vyhledávání apartmánů, kontroly dostupnosti, rezervace)
• Přesměruje vás zpět do IdoBooking nebo do administračního panelu ChatLab

Po dokončení průvodce je váš chatbot připraven odbavovat dotazy týkající se rezervací. Jednotlivé AI akce můžete detailně doladit v části Bot Settings > Actions (Nastavení bota > Akce).

---

Možnost B: Ruční nastavení

Pokud dáváte přednost ruční konfiguraci integrace, postupujte podle následujících kroků.

Část 1: Vytvoření API uživatele v IdoBooking

Před propojením systému ChatLab s vaším systémem IdoBooking musíte v panelu IdoBooking vytvořit vyhrazeného uživatele s přístupem k API.

Krok 1: Přechod do správy uživatelů

1. Přihlaste se do svého administračního panelu IdoBooking
2. Přejděte do Settings > Users (Nastavení > Uživatelé)
3. Klikněte na Add new user (Přidat nového uživatele)

Krok 2: Vytvoření uživatelského účtu

1. Zadejte login name (přihlašovací jméno) pro nového uživatele (např. „chatlab-api")
2. Vyplňte zbývající povinné údaje
3. Nastavte pro tento účet bezpečné password (heslo)

Krok 3: Konfigurace přístupu k API

Pro nového uživatele nakonfigurujte následující nastavení přístupu:

1. Aktivujte možnost „Active API access" - toto nastavení je nezbytné pro fungování integrace
2. Deaktivujte možnost „Active panel access" - uživatel přístup do administračního panelu nepotřebuje

Krok 4: Nastavení role uživatele a oprávnění

Pro konfiguraci role uživatele máte dvě možnosti:

Možnost A: Role administrátora (jednodušší)

• Zvolte roli Administrator (Administrátor)
• Vzhledem k tomu, že uživatel nebude mít přístup do panelu, jedná se o bezpečné řešení, které udělí plná oprávnění k API

Možnost B: Vlastní uživatelská role (detailnější nastavení)

Pokud preferujete detailnější kontrolu, zvolte Custom user (Vlastní uživatel) a nakonfigurujte následující oprávnění k modulům:

• Reservations (Rezervace) - Read-only (pouze pro čtení, pokud má chatbot informace o rezervacích pouze vyhledávat) nebo Full access (plný přístup, pokud bude chatbot rezervace i vytvářet)
• Customers (Zákazníci) - Read-only (pouze pro čtení)
• Offers (Nabídky) - Read-only (pouze pro čtení)

U vlastních uživatelů je také nutné nastavit oprávnění k lokalitám:

1. Přejděte do sekce Location and accommodation permissions (Oprávnění k lokalitám a ubytování)
2. Doporučujeme zvolit Select all (Vybrat vše), aby byl udělen přístup ke všem nemovitostem

Krok 5: Deaktivace nepotřebných oznámení

Aby API uživatel nedostával provozní oznámení, deaktivujte následující možnosti:

• Notifications for property staff (Oznámení pro personál zařízení) - Deaktivovat
• Automatic email notifications (Automatická e-mailová oznámení) - Deaktivovat

Krok 6: Uložení a shromáždění údajů pro připojení

1. Kliknutím na Save (Uložit) vytvořte uživatelský účet
2. Poznamenejte si následující informace - budete je potřebovat pro konfiguraci v ChatLab:

• Login - Uživatelské jméno, které jste vytvořili (např. chatlab-api)
• Password - Heslo, které jste nastavili
• Subdomain - Vaše subdoména v IdoBooking (např. client3760)

Kde najít subdoménu: Podívejte se na URL adresu svého panelu IdoBooking. Pokud je vaše adresa například https://client3760.idosell.com, vaše subdoména je client3760.

Část 2: Nastavení integrace v ChatLab

Krok 1: Přechod na záložku Connect

1. Přihlaste se do svého administračního panelu ChatLab
2. Vyberte bota, kterého chcete konfigurovat
3. Přejděte na záložku Connect (Připojit)
4. V seznamu integrací vyhledejte a klikněte na IdoBooking

Krok 2: Zadání údajů pro připojení

Vyplňte formulář pro připojení údaji získanými z IdoBooking:

• Client Subdomain - Zadejte svou subdoménu v IdoBooking (bez celé URL adresy). Příklad: client3760 (nikoli https://client3760.idosell.com)
• System Login - Zadejte uživatelské jméno API uživatele vytvořeného v IdoBooking
• System Password - Zadejte heslo tohoto API uživatele
• Default Currency - Vyberte měnu pro informace o cenách
• Default Language - Vyberte jazyk pro popisy ubytování

Krok 3: Propojení

1. Po vyplnění všech povinných polí se aktivuje tlačítko Connect (Připojit)
2. Kliknutím na Connect navažte spojení
3. Počkejte na potvrzující zprávu
4. Po úspěšném propojení se zobrazí oznámení o úspěchu

Po úspěšném propojení se nápis na tlačítku změní z „Connect" na „Update Chatbot" (Aktualizovat chatbota) a objeví se tlačítko „Disconnect" (Odpojit), pokud budete potřebovat integraci později zrušit.

---

Konfigurace AI akcí

Jakmile je integrace s IdoBooking připojena (kterýmkoli ze způsobů), můžete nastavit, které AI akce smí váš chatbot provádět. Pokud jste použili nastavení přes marketplace, jsou ve výchozím stavu aktivní všechny akce.

Dostupné AI akce

• Get Apartments - Vypíše dostupné apartmány a ubytování včetně popisů, uspořádání lůžek a fotografií
• Find Available Apartments - Vyhledá volné apartmány pro zadané časové období včetně informací o cenách
• Check Apartment Availability - Ověří dostupnost konkrétního apartmánu pro vybrané termíny
• Get Reservations - Vyhledá existující rezervace podle ID, stavu nebo časového období
• Create Reservation - Vytvoří nové rezervace s údaji o hostech a podrobnostmi o pobytu

Povolení a přizpůsobení akcí

1. Po propojení klikněte na Configure AI Actions (Nakonfigurovat AI akce) v potvrzovacím okně, nebo přejděte do Bot Settings > Actions (Nastavení bota > Akce) a vyhledejte kategorii IdoBooking
2. Přepínači aktivujte akce, které chcete povolit
3. Podle potřeby upravte popisek akce (text zobrazovaný uživatelům během provádění akce) a pokyny
4. Kliknutím na Save (Uložit) uložte změny

Konfigurace akce „Find available apartments"

Akce Find available apartments nabízí dva doplňující ovládací prvky, které určují, kolik apartmánů chatbot zobrazí, když se host zeptá na dostupnost, a které apartmány se do výběru dostanou. Otevřete tuto akci v Bot Settings > Actions > IdoBooking - find available apartments, abyste k nim získali přístup.

Number of offers to show

Posuvník v rozsahu 3-10 (výchozí hodnota 6). Určuje, kolik apartmánů chatbot vrátí uživateli v jedné odpovědi.

• Nižší hodnoty (3-4) udržují odpověď stručnou a cílenou, což je praktické, pokud se většina hostů rozhoduje jen mezi několika málo favority.
• Vyšší hodnoty (8-10) poskytnou hostům více variant k porovnání, což je vhodné pro objekty s rozsáhlejší nabídkou.

Offer selection strategy

Rozbalovací nabídka, která určuje, jaké apartmány se z celkového seznamu dostupných výsledků po vyfiltrování podle data a počtu hostů vyberou. K dispozici jsou čtyři možnosti:

• Cheapest offers (výchozí) - vrátí apartmány s nejnižší minimální cenou, seřazené od nejlevnějších po nejdražší. Vhodné, pokud hosté hledí na cenu nebo chcete přednostně nabízet nejdostupnější varianty.
• Evenly distributed by price - vybere apartmány rovnoměrně rozložené v celém cenovém rozpětí. Například při 9 nabídkách nabídne přibližně 3 nejlevnější, 3 střední a 3 nejdražší. Užitečné, pokud chcete, aby hosté viděli celý rozsah nabídky, nejen její nejlevnější část.
• Most expensive offers - vrátí apartmány s nejvyšší cenou, seřazené od nejdražších po nejlevnější. Vhodné pro prémiová zařízení nebo pokud chcete v první řadě nabídnout své nejluxusnější kapacity.
• Random selection - vybírá apartmány z vyfiltrovaných výsledků náhodně. Praktické, pokud chcete mezi jednotlivými konverzacemi obměňovat doporučované apartmány a vyhnout se neustálému nabízení týchž položek.

Obě nastavení se ukládají zvlášť pro každého bota, společně s existujícím vlastním promptem a popiskem akce.

---

Osvědčené postupy

Doporučení k zabezpečení (ruční nastavení)

• Používejte vyhrazeného API uživatele - Pro integraci s ChatLab vytvořte samostatného uživatele, nepoužívejte svůj osobní administrátorský účet
• Minimální oprávnění - Udělujte pouze ta oprávnění, která jsou nezbytná pro váš účel. Pokud má chatbot data pouze vyhledávat, použijte přístup jen pro čtení (read-only)
• Pravidelná obměna přihlašovacích údajů - Pravidelně měňte heslo API uživatele a následně tyto údaje aktualizujte v prostředí ChatLab

Optimalizace odpovědí chatbota

• Trénujte svého bota informacemi o ubytování - Přidejte do znalostní báze popisy svých zařízení včetně vybavení, specifikací pokojů a informací o lokalitě
• Nastavte jasný průběh konverzace - Nakonfigurujte uvítací zprávy, které uživatele navedou k dotazům na dostupnost, a využijte navrhované otázky jako „Zjistit dostupnost" nebo „Zobrazit pokoje"

---

Řešení problémů

• Připojení selhává - Ověřte, zda má uživatel v IdoBooking aktivovanou volbu „Active API access"
• Chyby typu „Access denied" (Přístup odepřen) - Zkontrolujte, zda má uživatel správná oprávnění k modulům
• Nejsou vracena žádná data - Ujistěte se, že má uživatel přístup k příslušným lokalitám a nemovitostem
• Nesprávná subdoména - Zkontrolujte URL adresu svého systému IdoBooking a zadejte pouze její subdoménovou část (např. client3760 z adresy https://client3760.idosell.com)

---