Prepojte svojho ChatLab chatbota so systémom na správu ubytovacích zariadení KWHotel a poskytnite návštevníkom svojho webu informácie o dostupnosti izieb v reálnom čase, možnosť rezervácie a vyhľadávanie rezervácií. Integrácia využíva rezervačný systém GuestSage booking engine na získavanie údajov o izbách a dostupnosti a rozhranie KWHotel Integrations API na vyhľadávanie rezervácií.
Čo integrácia poskytuje
S povolenou integráciou KWHotel dokáže váš chatbot:
- Zobraziť zoznam typov izieb s popismi, kapacitou, rozlohou a fotografiami
- Vyhľadať dostupné izby pre zadaný rozsah dátumov vrátane cien
- Overiť dostupnosť konkrétnej izby a rozsahu dátumov
- Vytvoriť nové rezervácie s údajmi o hosťovi
- Vyhľadávať existujúce rezervácie
Požiadavky
Pred nastavením integrácie sa uistite, že máte:
- Účet KWHotel s povoleným rezervačným systémom GuestSage booking engine
- Svoje Hotel ID (UUID) z rezervačného systému GuestSage booking engine
- Svoje Integrations Hotel ID (číselné) a kľúč Integrations API Key vystavené systémom KWHotel
- Účet ChatLab v pláne STANDARD alebo PREMIUM, prípadne s doplnkom Travel Integrations
Ako nájsť Hotel ID (UUID)
Hotel ID je kód UUID priradený vášmu zariadeniu v rezervačnom systéme GuestSage booking engine.
- Prihláste sa na cloud.kwhotel.com
- Prejdite do Modules (Moduly) > Booking Engine (Rezervačný systém)
- Na karte General (Všeobecné) nájdite pole Booking engine link (Odkaz na rezervačný systém)
- Skopírujte UUID z adresy URL
Napríklad v odkaze https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 je Hotel ID hodnota 82b0085d-da1b-4443-8fde-d5d569a859e6.
Ako nájsť prihlasovacie údaje pre Integrations API
Rozhranie KWHotel Integrations API používa iný identifikátor než GuestSage UUID:
- Integrations Hotel ID - číselné ID (napríklad
292) - Integrations API Key - tajný kľúč, ktorý si vygenerujete v systéme KWHotel
Číselné Hotel ID
Číselné Hotel ID nájdete v pravom hornom rohu administračného panelu KWHotel.
Generovanie kľúča API
Kľúč API si vygenerujete priamo v systéme KWHotel:
- Prihláste sa do KWHotel a otvorte modul Synchronization (Synchronizácia)
- Kliknite na tlačidlo Reset API key (Obnoviť kľúč API)
- Skopírujte vygenerovaný kľúč a vložte ho do formulára pripojenia v aplikácii ChatLab
Kliknutím na Reset API key odstránite predchádzajúci kľúč (ak už bol vygenerovaný) a vytvoríte nový. Akýkoľvek iný systém, ktorý používa predchádzajúci kľúč, prestane fungovať, kým ho neaktualizujete novou hodnotou.
Nastavenie integrácie v aplikácii ChatLab
Krok 1: Prejdite na kartu Connect
- Prihláste sa do administračného panelu ChatLab
- Vyberte bota, ktorého chcete konfigurovať
- Prejdite na kartu Connect (Pripojiť)
- V zozname integrácií nájdite a kliknite na KWHotel
Krok 2: Zadajte podrobnosti o pripojení
Vyplňte formulár pripojenia:
- Hotel ID (UUID) - GUID vášho hotela v KWHotel z konfigurácie rezervačného systému GuestSage booking engine
- Default Currency (Predvolená mena) - mena použitá pre ceny zobrazované používateľom chatu (predvolene PLN)
- Default Language (Predvolený jazyk) - jazyk použitý pre popisy izieb a text ponuky (predvolene poľština)
- Integrations Hotel ID - číselné ID hotela pre KWHotel Integrations API (odlišné od vyššie uvedeného UUID)
- Integrations API Key - tajný kľúč API vydaný systémom KWHotel
- Discount bot channel (Zľavový kanál bota) - voliteľné. Po nastavení sa ponuky načítavajú pre tento zľavový kanál KWHotel a zoraďujú ich AI. Nechajte prázdne, ak chcete použiť predvolený kanál.
Krok 3: Pripojenie
- Po vyplnení polí sa aktivuje tlačidlo Connect (Pripojiť)
- Kliknutím na Connect uložte konfiguráciu. ChatLab otestuje pripojenie k systému GuestSage a pripojenie k Integrations API.
- Po úspešnom dokončení sa zobrazí potvrdzujúce hlásenie (toast).
Po úspešnom pripojení sa tlačidlo Connect zmení na Update Chatbot (Aktualizovať chatbota) a zobrazí sa tlačidlo Disconnect (Odpojiť), pomocou ktorého môžete integráciu neskôr deaktivovať.
Ak kontrola Integrations API pri ukladaní zlyhá, akcia Get reservation (Získať rezerváciu) sa automaticky zakáže. Znova zadajte správne prihlasovacie údaje a kliknite na Update Chatbot, aby ste ju povolili.
Konfigurácia AI akcií
Po pripojení integrácie KWHotel môžete nakonfigurovať, ktoré AI akcie môže váš chatbot vykonávať.
Dostupné AI akcie
- KWHotel - get rooms - Vypíše typy izieb s popismi, konfiguráciou postelí, rozlohou, kapacitou a fotografiami
- KWHotel - find available rooms - Vyhľadá dostupné izby pre zadaný rozsah dátumov a vráti ponuky s cenami
- KWHotel - check room availability - Skontroluje dostupnosť pre konkrétny typ izby a rozsah dátumov
- KWHotel - create reservation - Vytvorí novú rezerváciu s údajmi o hosťovi a informáciami o pobyte
- KWHotel - get reservation - Vyhľadá existujúce rezervácie
Povolenie a prispôsobenie akcií
- Po pripojení kliknite na Configure AI Actions (Konfigurovať AI akcie) v potvrdzovacom modálnom okne, alebo prejdite do Bot Settings > Actions (Nastavenia bota > Akcie) a vyhľadajte kategóriu KWHotel
- Prepnite prepínač pri akciách, ktoré chcete povoliť
- Podľa potreby upravte označenie akcie (text zobrazený používateľom počas vykonávania akcie) a inštrukcie pre prompt
- Zmeny uložte kliknutím na Save (Uložiť)
Osvedčené postupy
Optimalizácia odpovedí chatbota
- Trénujte svojho bota informáciami o zariadení - Do vedomostnej bázy pridajte popisy izieb a vybavenia hotela vrátane služieb, polohy, atrakcií v okolí a pravidiel príchodu a odchodu (check-in/check-out)
- Nastavte jasné priebehy konverzácie - Nakonfigurujte uvítacie správy, ktoré hostí navedú na otázky o dostupnosti, a použite navrhované otázky ako „Skontrolovať dostupnosť izieb“ alebo „Zobraziť izby“
- Pridajte stránky konkrétnych izieb - Vytvorte na svojom webe samostatné stránky pre každý typ izby a natrénujte chatbota pomocou ich URL adries, aby boli jeho odpovede podrobnejšie
Integrácia s rezervačným systémom
- Integrácia KWHotel funguje prostredníctvom rezervačného systému GuestSage booking engine na správu kapacít a cien
- Pre priame dokončenie rezervácie mimo chatu vložte na svoj web rezervačný widget GuestSage vedľa chatbota ChatLab - chatbot môže hostí naviesť priamo na rezervačnú stránku, keď sú pripravení rezervovať
Riešenie problémov
- Pripojenie zlyháva - Skontrolujte, či je vaše Hotel ID skutočne hodnota UUID zo systému GuestSage (nie číselné Integrations ID) a či je vaše ubytovacie zariadenie aktívne v rezervačnom systéme GuestSage booking engine
- Akcia Get reservation zostáva vypnutá - Ak test pripojenia Integrations API pri ukladaní zlyhá, akcia sa automaticky vypne. Znova zadajte Integrations Hotel ID a Integrations API Key a kliknite na Update Chatbot.
- Nenačítavajú sa žiadne údaje o izbách - Skontrolujte, či sú vaše typy izieb v KWHotel správne nakonfigurované s popismi a či je dostupnosť zverejnená v systéme GuestSage
- Nesprávne ceny alebo chýbajúce ponuky - Ceny pochádzajú zo systému GuestSage. Aktualizujte cenníky a nastavenia ponúk v KWHotel, aby odrážali aktuálne ceny. Ak ste nastavili Discount bot channel, uistite sa, že má aktívne ponuky.
- Integrácia nie je v administračnom paneli dostupná - Integrácia KWHotel vyžaduje plán ChatLab STANDARD alebo PREMIUM, prípadne doplnok Travel Integrations