Propojte svého chatbota ChatLab se systémem pro správu ubytovacích zařízení KWHotel a poskytněte návštěvníkům svého webu informace o dostupnosti pokojů v reálném čase, možnost rezervace i vyhledávání existujících rezervací. Integrace využívá rezervační systém GuestSage pro data o pokojích a dostupnosti a KWHotel Integrations API pro vyhledávání rezervací.
Co integrace nabízí
S aktivovanou integrací KWHotel může váš chatbot:
- Zobrazovat seznam typů pokojů s popisy, kapacitou, rozlohou a fotografiemi
- Vyhledávat dostupné pokoje pro zadané časové období včetně cen
- Ověřovat dostupnost pro konkrétní pokoj a časové období
- Vytvářet nové rezervace s údaji o hostech
- Vyhledávat existující rezervace
Požadavky
Před nastavením integrace se ujistěte, že máte:
- Účet v KWHotel s aktivovaným rezervačním systémem GuestSage
- Své Hotel ID (UUID) z rezervačního systému GuestSage
- Své Integrations Hotel ID (číselné) a Integrations API Key vystavené systémem KWHotel
- Účet v ChatLab s tarifem Standard nebo Premium, případně s doplňkem Travel Integrations
Jak zjistit Hotel ID (UUID)
Hotel ID je UUID přiřazené vašemu ubytovacímu zařízení v rezervačním systému GuestSage.
- Přihlaste se na cloud.kwhotel.com
- Přejděte do Modules (Moduly) > Booking Engine (Rezervační systém)
- Na kartě General (Obecné) vyhledejte pole Booking engine link (Odkaz na rezervační systém)
- Zkopírujte UUID z adresy URL
Například v odkazu https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 je Hotel ID 82b0085d-da1b-4443-8fde-d5d569a859e6.
Jak zjistit přihlašovací údaje k Integrations API
KWHotel Integrations API používá jiný identifikátor než UUID systému GuestSage:
- Integrations Hotel ID - číselné ID (například
292) - Integrations API Key - tajný klíč, který si vygenerujete v systému KWHotel
Číselné Hotel ID
Číselné Hotel ID najdete v pravém horním rohu administrátorského panelu KWHotel.
Vygenerování klíče API
Klíč API si vygenerujete přímo v systému KWHotel:
- Přihlaste se do KWHotel a otevřete modul Synchronization (Synchronizace)
- Klikněte na tlačítko Reset API key (Resetovat klíč API)
- Zkopírujte vygenerovaný klíč a vložte jej do propojovacího formuláře v ChatLab
Kliknutím na Reset API key odstraníte předchozí klíč (pokud již byl vygenerován) a vytvoříte nový. Jakýkoli jiný systém využívající předchozí klíč přestane fungovat, dokud jej neaktualizujete novou hodnotou.
Nastavení integrace v ChatLab
Krok 1: Přejděte na kartu Connect
- Přihlaste se do administrátorského panelu ChatLab
- Vyberte bota, kterého chcete konfigurovat
- Přejděte na kartu Connect (Připojit)
- V seznamu integrací vyhledejte a klikněte na KWHotel
Krok 2: Zadejte údaje o připojení
Vyplňte propojovací formulář:
- Hotel ID (UUID) - GUID vašeho hotelu v KWHotel z konfigurace rezervačního systému GuestSage
- Default Currency - měna použitá pro ceny zobrazované uživatelům chatu (výchozí je PLN)
- Default Language - jazyk použitý pro popisy pokojů a texty nabídek (výchozí je polština)
- Integrations Hotel ID - číselné ID hotelu pro KWHotel Integrations API (liší se od výše uvedeného UUID)
- Integrations API Key - tajný klíč API vystavený systémem KWHotel
- Discount bot channel - volitelné. Pokud je pole vyplněno, nabídky se načítají pro tento slevový kanál KWHotel a jsou řazeny pomocí AI. Chcete-li použít výchozí kanál, ponechte pole prázdné.
Krok 3: Připojení
- Po vyplnění polí se aktivuje tlačítko Connect (Připojit)
- Kliknutím na Connect konfiguraci uložte. ChatLab otestuje spojení s GuestSage a s Integrations API.
- V případě úspěchu se zobrazí potvrzovací oznámení.
Po úspěšném propojení se tlačítko Connect změní na Update Chatbot (Aktualizovat chatbota) a objeví se tlačítko Disconnect (Odpojit), pomocí kterého můžete integraci později vypnout.
Pokud kontrola Integrations API při ukládání selže, akce Get reservation se automaticky deaktivuje. Znovu zadejte správné údaje a kliknutím na Update Chatbot ji povolte.
Konfigurace AI akcí
Jakmile je integrace KWHotel připojena, můžete nastavit, které AI akce může váš chatbot provádět.
Dostupné AI akce
- KWHotel - get rooms - zobrazí seznam typů pokojů s popisy, uspořádáním lůžek, rozlohou, kapacitou a fotografiemi
- KWHotel - find available rooms - vyhledá dostupné pokoje pro zadané časové období a vrátí nabídky s cenami
- KWHotel - check room availability - ověří dostupnost pro konkrétní typ pokoje a časové období
- KWHotel - create reservation - vytvoří novou rezervaci s údaji o hostech a informacemi o pobytu
- KWHotel - get reservation - vyhledá existující rezervace
Povolení a přizpůsobení akcí
- Po připojení klikněte na Configure AI Actions (Konfigurovat AI akce) v potvrzovacím okně, nebo přejděte do Bot Settings (Nastavení bota) > Actions (Akce) a najděte kategorii KWHotel
- Aktivujte akce, které chcete povolit
- Podle potřeby upravte popisek akce (text zobrazovaný uživatelům během provádění akce) a pokyny v promptu
- Kliknutím na Save (Uložit) změny použijte
Osvědčené postupy
Optimalizace odpovědí chatbota
- Trénujte svého bota informacemi o ubytovacím zařízení - přidejte do báze znalostí popisy pokojů a vybavení hotelu včetně doplňkových služeb, polohy, zajímavostí v okolí a pravidel pro check-in/check-out
- Nastavte jasné toky konverzace - nakonfigurujte uvítací zprávy, které hosty navedou k dotazům na dostupnost, a použijte navrhované otázky jako například „Ověřit dostupnost pokojů" nebo „Zobrazit pokoje"
- Přidejte stránky konkrétních pokojů - vytvořte na svém webu samostatné stránky pro každý typ pokoje a natrénujte chatbota na jejich URL adresách, aby poskytoval podrobnější odpovědi
Integrace s rezervačním systémem
- Integrace KWHotel využívá pro správu kapacit a cen rezervační systém GuestSage
- Pro přímé dokončení rezervace mimo chat vložte rezervační widget GuestSage na svůj web vedle chatbota ChatLab - chatbot pak může hosty navést na rezervační stránku, jakmile budou připraveni rezervaci provést
Řešení problémů
- Připojení se nezdařilo - ověřte, že zadané Hotel ID je UUID ze systému GuestSage (nikoli číselné ID pro integrace) a že je vaše ubytovací zařízení v rezervačním systému GuestSage aktivní
- Akce Get reservation zůstává vypnutá - pokud test připojení k Integrations API při ukládání selže, akce se automaticky deaktivuje. Znovu zadejte Integrations Hotel ID a Integrations API Key a klikněte na Update Chatbot.
- Nenačítají se žádná data o pokojích - zkontrolujte, zda máte v KWHotel správně nakonfigurovány typy pokojů včetně popisů a zda je dostupnost publikována v GuestSage
- Nesprávné ceny nebo žádné nabídky - ceny se načítají z GuestSage. Upravte ceníky a nastavení nabídek v KWHotel tak, aby odpovídaly aktuálním cenám. Pokud jste nastavili slevový kanál (Discount bot channel), ujistěte se, že obsahuje aktivní nabídky.
- Integrace není v administrátorském panelu dostupná - integrace KWHotel vyžaduje ChatLab plán Standard či Premium, případně doplněk Travel Integrations