Integrace s IdoBooking

Propojte svého chatbota v ChatLabu 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 s rezervacemi.

Příklad konverzace

Příklad ilustruje zákaznickou zkušenost. Dostupné akce a vrácené informace závisí na této integraci a vaší konfiguraci.

Než začnete

Nejprve vytvořte nebo vyberte chatbota. Potřebujete oprávnění ke správě jeho integrací a přístup k nastavení propojení v externím účtu. Pokud se na dlaždici Connect (Propojit) zobrazuje výzva k upgradu nebo ke kontaktování podpory, zkontrolujte, zda vaše předplatné tuto integraci zahrnuje. Přihlašovací údaje k API uchovávejte v tajnosti; nikdy je nevkládejte do kódu widgetu pro vložení na web.

Co integrace nabízí

S aktivovanou integrací IdoBooking váš chatbot zvládne:

• Zobrazit seznam dostupných apartmánů a ubytování včetně popisů a fotografií
• Zkontrolovat dostupnost pro konkrétní termíny
• Vyhledat dostupné apartmány pro dané časové rozmezí včetně cen
• Vyhledat existující rezervace podle ID, stavu nebo časového rozmezí
• Vytvářet nové rezervace s údaji o hostech

Tuto integraci lze nastavit dvěma způsoby - přes IdoBooking Marketplace (doporučeno) nebo ručně prostřednictvím administračního 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. Tato metoda automaticky zpracuje přihlašovací údaje k API a aktivuje pro vašeho chatbota akce pro čtení.

Krok 1: Instalace aplikace 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 ChatLabu 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 ChatLabu na tržišti budete přesměrováni do průvodce nastavením. Pokud již účet v ChatLabu 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

Zvolte 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í funkci integrace IdoBooking. Pokud ji vaše předplatné nezahrnuje, postupujte podle výzvy k upgradu nebo kontaktování podpory.

Krok 4: Výběr chatbota

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

Krok 5: Dokončení nastavení

Průvodce automaticky:

• Propojí vaše přihlašovací údaje IdoBooking s vybraným chatbotem
• Aktivuje vyhledávání apartmánů, kontrolu dostupnosti a vyhledávání rezervací. Vytváření rezervací se automaticky neaktivuje.
• 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 vyřizovat dotazy na rezervace. Jednotlivé akce umělé inteligence můžete detailně upravit v Settings > Actions (Nastavení > 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

Než ChatLab propojíte se systémem IdoBooking, musíte ve svém 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) 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

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

1. Aktivujte možnost „Active API access" - toto 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 a oprávnění uživatele

Pro nastavení uživatelské role máte dvě možnosti:

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

• Jako roli vyberte Administrator (Administrátor)
• Tím udělíte rozsáhlá oprávnění k API, i když je přístup do panelu vypnutý. Vlastní roli použijte v případě, že integrace potřebuje pouze vybrané operace pro čtení.

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

Pokud dáváte přednost detailnější kontrole, vyberte Custom user (Vlastní uživatel) a nakonfigurujte následující oprávnění modulů:

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

U vlastních uživatelů musíte také nakonfigurovat oprávnění k lokalitám:

1. Přejděte k sekci Location and accommodation permissions (Oprávnění k lokalitám a ubytováním)
2. Vyberte ubytovací zařízení, která má tento chatbot pokrývat; přístup ke všem udělte pouze v případě, že je to váš záměr.

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

Chcete-li zabránit tomu, aby API uživatel dostá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 ChatLabu:

• 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)

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

Část 2: Nastavení integrace v ChatLabu

Krok 1: Přechod na kartu Connect

1. Přihlaste se do administračního panelu ChatLab
2. Vyberte bota, kterého chcete konfigurovat
3. Přejděte na kartu Connect (Propojit)
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 (Subdoména klienta) - Zadejte svou subdoménu IdoBooking (bez celé URL adresy). Příklad: client3760 (nikoli https://client3760.idosell.com)
• System Login (Systémový login) - Zadejte uživatelské jméno API uživatele, kterého jste vytvořili v IdoBooking
• System Password (Systémové heslo) - Zadejte heslo daného API uživatele
• Default Currency (Výchozí měna) - Vyberte měnu pro informace o cenách
• Default Language (Výchozí jazyk) - Vyberte jazyk pro popisy ubytování

Krok 3: Propojení

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

Po úspěšném propojení se text tlačítka změní z „Connect" na „Update Chatbot" (Aktualizovat chatbota) a zobrazí se také tlačítko „Disconnect" (Odpojit), pokud budete potřebovat integraci později vypnout.

---

Konfigurace AI akcí

Jakmile je integrace s IdoBooking propojena (jakoukoli z obou metod), můžete nastavit, které AI akce může váš chatbot provádět. Po dokončení obou způsobů nastavení aktivní akce zkontrolujte. Vytváření rezervací se automaticky neaktivuje.

Dostupné AI akce

• Get Apartments (Získat apartmány) - Zobrazí seznam dostupných apartmánů a ubytování s popisy, uspořádáním lůžek a fotografiemi
• Find Available Apartments (Najít dostupné apartmány) - Vyhledá dostupné apartmány pro dané časové rozmezí včetně informací o cenách
• Check Apartment Availability (Zkontrolovat dostupnost apartmánu) - Zkontroluje dostupnost konkrétního apartmánu pro zadané časové rozmezí
• Get Reservations (Získat rezervace) - Vyhledá existující rezervace podle ID, stavu nebo časového rozmezí
• Create Reservation (Vytvořit rezervaci) - Vytvoří nové rezervace s údaji o hostech a informacemi o pobytu
• AI room search - Porovnává představu hosta z jeho popisu s vašimi popisy pokojů, namísto kontroly termínů

AI room search a Get Apartments představují alternativy, nikoli doplňky. Když je zapnuté AI room search, nahradí standardní nástroj pro výpis pokojů a akce Get Apartments se chatbotovi odebere, takže je vždy aktivní pouze jeden nástroj pro výpis pokojů. Akce založené na termínech tím nejsou ovlivněny.

Povolení a přizpůsobení akcí

1. Po připojení klikněte v modálním okně na Configure AI Actions (Nakonfigurovat AI akce), nebo přejděte do Settings > Actions (Nastavení > Akce) a vyhledejte kategorii IdoBooking
2. Přepínači aktivujte akce, které chcete povolit
3. Podle potřeby upravte popisek akce (text zobrazený uživatelům během provádění akce) a pokyny
4. V dialogovém okně akce klikněte na Enable (Povolit) u nové akce nebo na Update (Aktualizovat) u stávající akce.

Konfigurace akce „Find available apartments"

Akce Find available apartments nabízí dva dodatečné 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 přes Settings > Actions > IdoBooking - find available apartments, abyste k nim získali přístup.

Number of offers to show (Počet zobrazených nabídek)

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

• Nižší hodnoty (3-4) udržují odpověď stručnou a přehlednou, což je užitečné, pokud se většina hostů rozhoduje mezi několika málo favority.
• Vyšší hodnoty (8-10) poskytují hostům větší výběr k porovnání, což ocení zařízení s rozsáhlejší nabídkou.

Offer selection strategy (Strategie výběru nabídek)

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 (Nejlevnější nabídky) (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ídnout nejdostupnější varianty.
• Evenly distributed by price (Rovnoměrně rozdělené podle ceny) - vybere apartmány rovnoměrně rozložené napříč cenovým spektrem. Například při 9 nabídkách to znamená zhruba 3 nejlevnější, 3 ze střední cenové kategorie a 3 nejdražší. Užitečné, pokud chcete, aby hosté viděli celý rozsah nabídky, nikoli pouze nízkorozpočtovou variantu.
• Most expensive offers (Nejdražší nabídky) - vrátí apartmány s nejvyšší cenou seřazené od nejdražších po nejlevnější. Skvělá volba pro prémiová ubytování nebo pokud chcete v prvé řadě prezentovat svou nejvyšší kategorii.
• Random selection (Náhodný výběr) - vybírá apartmány z vyfiltrovaných výsledků náhodně. Hodí se v situaci, kdy chcete skladbu nabízených apartmánů v různých konverzacích obměňovat a nedoporučovat stále tytéž.

Obě nastavení se ukládají pro každého bota zvlášť, spolu se stávajícím vlastním promptem a popiskem akce.

---

Testování hotového nastavení

Otevřete Overview (Přehled) a zahajte novou testovací konverzaci. Požádejte o pokoje pro budoucí termín a konkrétní počet hostů, poté otevřete vrácený rezervační odkaz a porovnejte termíny, měnu i cenu s údaji v IdoBooking. Vyzkoušejte vyhledání rezervace s rezervací, k jejímuž zobrazení máte oprávnění. Akci Create Reservation povolte a testujte pouze tehdy, když máte v úmyslu vytvořit skutečnou rezervaci; test v chatu může provést zápis do vašeho rezervačního systému.

Osvědčené postupy

Bezpečnostní doporučení (ruční nastavení)

• Používejte vyhrazeného API uživatele - Vytvořte samostatného uživatele určeného výhradně pro integraci s ChatLabem, nepoužívejte svůj osobní administrátorský účet
• Minimální oprávnění - Udělujte pouze oprávnění nezbytná pro váš případ použití. Pokud má chatbot pouze načítat informace, použijte přístup pouze pro čtení
• Pravidelná obměna přihlašovacích údajů - Pravidelně aktualizujte heslo API uživatele a následně tyto údaje upravte i v ChatLabu

Optimalizace odpovědí chatbota

• Trénujte svého bota na informacích o ubytování - Přidejte do báze znalostí popisy svých ubytovacích kapacit, včetně vybavení, vlastností pokojů a detailů o lokalitě
• Nastavte přehledné toky konverzace - Nakonfigurujte uvítací zprávy, které uživatele navedou k dotazu na dostupnost, a využijte navrhované otázky jako „Zkontrolovat dostupnost" nebo „Zobrazit pokoje"

---

Řešení problémů

• Připojení se nezdařilo - Ověřte, zda má uživatel v IdoBooking povolen přístup „Active API access"
• Chyby „Access denied" (Přístup odepřen) - Zkontrolujte, zda má uživatel správně nastavená oprávnění k modulům
• Nejsou vrácena žádná data - Ujistěte se, že má uživatel přístup k příslušným lokalitám a ubytovacím zařízením
• Nesprávná subdoména - Zkontrolujte svou URL adresu v IdoBooking a zadejte pouze část se subdoménou (např. client3760 z https://client3760.idosell.com)

---

Katalog pokojů a přehled hotelu

Pokud se ve vašem účtu zobrazuje karta Hotel, přejděte do Hotel > Rooms (Pokoje) a zkontrolujte katalog pokojů a stav trénování. AI room search funguje nezávisle na kontrole dostupnosti podle termínu: páruje popisy pokojů, zatímco akce dostupnosti ověřují poptávaný termín pobytu. Automatické indexování pokojů závisí na automatickém indexování katalogu a přiřazené kapacitě pokojů; v opačném případě použijte Train rooms (Trénovat pokoje), je-li tato možnost dostupná. Zkontrolujte povolené akce a počkejte na dokončení trénování, než se na AI room search začnete spoléhat.

Související články

• Přidání chatbota na váš web
• Trénování chatbota
• Odeslání odkazu na vašeho chatbota