Свържете своя ChatLab чатбот със системата за управление на имоти KWHotel, за да осигурите на посетителите на уебсайта си информация за наличността на стаите в реално време, резервации и справка за съществуващи резервации. Интеграцията използва модула за резервации GuestSage booking engine за данни относно стаите и наличността, както и KWHotel Integrations API за проверка на резервации.
Какво осигурява интеграцията
При активирана интеграция с KWHotel Вашият чатбот може да:
- Показва списък с типовете стаи с описания, капацитет, площ и снимки
- Търси свободни стаи за определен период от дати с актуални цени
- Проверява наличността за конкретна стая и избран период от дати
- Създава нови резервации с данните на гостите
- Прави справка за съществуващи резервации
Предварителни изисквания
Преди да конфигурирате интеграцията, уверете се, че разполагате със:
- Профил в KWHotel с активиран модул за резервации GuestSage booking engine
- Вашия Hotel ID (UUID) от модула за резервации GuestSage booking engine
- Вашия Integrations Hotel ID (числов) и Integrations API Key, издадени от KWHotel
- Профил в ChatLab с план STANDARD или PREMIUM, или с добавка Travel Integrations
Намиране на Вашия Hotel ID (UUID)
Hotel ID е UUID, присвоен на Вашия обект в модула за резервации GuestSage booking engine.
- Влезте в cloud.kwhotel.com
- Отидете на Modules (Модули) > Booking Engine (Модул за резервации)
- В раздела General (Общи) намерете полето Booking engine link
- Копирайте UUID от адреса (URL)
Например в линка https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 идентификаторът Hotel ID е 82b0085d-da1b-4443-8fde-d5d569a859e6.
Намиране на данните за достъп до Integrations API
KWHotel Integrations API използва различен идентификатор от GuestSage UUID:
- Integrations Hotel ID - числов идентификатор (например
292) - Integrations API Key - секретен ключ, който генерирате в KWHotel
Числов Hotel ID
Можете да намерите числовия Hotel ID в горния десен ъгъл на административния панел на KWHotel.
Генериране на API ключ
Генерирате API ключа самостоятелно в KWHotel:
- Влезте в KWHotel и отворете модула Synchronization (Синхронизация)
- Кликнете върху бутона Reset API key (Нулиране на API ключ)
- Копирайте генерирания ключ и го поставете във формата за свързване в ChatLab
Кликването върху Reset API key премахва предишния ключ (ако вече е бил генериран такъв) и създава нов. Всяка друга система, използваща предишния ключ, ще спре да работи, докато не я актуализирате с новата стойност.
Настройване на интеграцията в ChatLab
Стъпка 1: Отидете в раздела Connect
- Влезте в административния панел на ChatLab
- Изберете бота, който искате да конфигурирате
- Отидете в раздела Connect (Свързване)
- Намерете и кликнете върху KWHotel в списъка с интеграции
Стъпка 2: Въведете данните за връзка
Попълнете формата за свързване:
- Hotel ID (UUID) - Вашият KWHotel hotel GUID от конфигурацията на GuestSage booking engine
- Default Currency - валутата, използвана за цените, показвани на потребителите в чата (по подразбиране е PLN)
- Default Language - езикът, използван за описанията на стаите и текста на офертите (по подразбиране е полски)
- Integrations Hotel ID - числовият идентификатор на хотела за KWHotel Integrations API (различен от посочения по-горе UUID)
- Integrations API Key - секретният API ключ, издаден от KWHotel
- Discount bot channel - по избор. Когато е зададен, офертите се извличат за този канал за отстъпки на KWHotel и се сортират от AI. Оставете празно, за да използвате канала по подразбиране.
Стъпка 3: Свързване
- След като попълните полетата, бутонът Connect (Свързване) ще стане активен
- Кликнете върху Connect, за да запазите конфигурацията. ChatLab ще тества връзката с GuestSage и връзката с Integrations API.
- При успех ще видите потвърждаващо съобщение.
След успешно свързване бутонът Connect се променя на Update Chatbot (Актуализиране на чатбота), и се появява бутон Disconnect (Прекъсване на връзката), за да можете да деактивирате интеграцията по-късно.
Ако проверката на Integrations API е неуспешна при запазване, действието Get reservation се деактивира автоматично. Въведете отново правилните данни и кликнете върху Update Chatbot, за да го активирате.
Конфигуриране на AI действия (AI Actions)
След като интеграцията с KWHotel е свързана, можете да конфигурирате кои AI действия да изпълнява Вашият чатбот.
Налични AI действия
- KWHotel - get rooms - извежда типовете стаи с описания, разположение на леглата, площ, капацитет и снимки
- KWHotel - find available rooms - търси свободни стаи за определен период от дати и връща оферти с цени
- KWHotel - check room availability - проверява наличността за конкретен тип стая и период от дати
- KWHotel - create reservation - създава нова резервация с данни за гостите и детайли за престоя
- KWHotel - get reservation - прави справка за съществуващи резервации
Активиране и персонализиране на действия
- След като се свържете, кликнете върху Configure AI Actions (Конфигуриране на AI действия) в модалния прозорец за успех или отидете на Bot Settings > Actions (Настройки на бота > Действия) и намерете категорията KWHotel
- Включете действията, които искате да активирате
- Персонализирайте етикета на действието (текста, който се показва на потребителите, докато действието се изпълнява) и инструкциите в системния промпт според Вашите нужди
- Кликнете върху Save (Запазване), за да приложите промените
Добри практики
Оптимизиране на отговорите на чатбота
- Обучете бота си с информация за обекта - добавете описания на стаите и удобствата на хотела към базата от знания, включително екстри, локация, близки забележителности и правила за настаняване и напускане
- Задайте ясни сценарии на разговор - конфигурирайте приветствени съобщения, които насочват гостите да попитат за наличност, и използвайте предложени въпроси като „Провери наличност на стаи“ или „Разгледай стаите“
- Добавете страници за отделните стаи - създайте отделни страници за всеки тип стая на уебсайта си и обучете чатбота с техните адреси (URL), за да предоставя по-изчерпателни отговори
Интеграция с модула за резервации
- Интеграцията с KWHotel работи чрез модула за резервации GuestSage booking engine за наличностите и цените
- За директно завършване на резервацията извън чата, вградете уиджета за резервации на GuestSage във Вашия уебсайт заедно с чатбота на ChatLab - чатботът може да насочва гостите към страницата за резервации, когато са готови да резервират
Отстраняване на неизправности
- Неуспешно свързване - проверете дали Вашият Hotel ID е GuestSage UUID (а не числовият Integrations ID) и дали Вашият обект е активен в GuestSage booking engine
- Действието Get reservation остава изключено - ако тестът на връзката с Integrations API е неуспешен при запазване, действието се деактивира автоматично. Въведете отново Integrations Hotel ID и Integrations API Key и кликнете върху Update Chatbot.
- Не се зареждат данни за стаите - проверете дали типовете стаи са правилно конфигурирани в KWHotel с описания и дали наличността е публикувана в GuestSage
- Неточни цени или липса на оферти - цените идват от GuestSage. Актуализирайте тарифите и настройките на офертите в KWHotel, за да отразяват актуалните цени. Ако сте задали Discount bot channel, уверете се, че по него има активни оферти.
- Интеграцията не е налична в административния панел - интеграцията с KWHotel изисква план STANDARD или PREMIUM в ChatLab, или добавка Travel Integrations