Интеграция с IdoBooking

Свържете своя чатбот в ChatLab с резервационната система IdoBooking, за да предоставяте информация за наличността в реално време и помощ при резервации на посетителите на Вашия уебсайт.

Пример за разговор

Примерът илюстрира преживяването на клиента. Наличните действия и върнатата информация зависят от тази интеграция и Вашата конфигурация.

Преди да започнете

Първо създайте или изберете чатбот. Нуждаете се от разрешение за управление на неговите интеграции и достъп до настройките за връзка във външния акаунт. Ако плочката Connect показва подкана за надграждане на плана или контакт, проверете дали абонаментът Ви включва тази интеграция. Пазете данните за достъп до API поверителни; никога не ги поставяйте в кода за вграждане на уебсайта.

Какво предоставя интеграцията

С активирана интеграция с IdoBooking Вашият чатбот може да:

• Показва списък с наличните апартаменти и места за настаняване с описания и снимки
• Проверява наличността за конкретни дати
• Намира свободни апартаменти за даден период от време заедно с цените
• Търси съществуващи резервации по идентификатор (ID), статус или период от дати
• Създава нови резервации с данните на гостите

Има два начина за настройка на тази интеграция - чрез IdoBooking Marketplace (препоръчително) или ръчно чрез административния панел на ChatLab.

---

Опция A: Настройка чрез IdoBooking Marketplace (препоръчително)

Най-бързият начин да свържете ChatLab с IdoBooking е през IdoBooking Marketplace. Този метод обработва автоматично данните за достъп до API и активира действията за четене за Вашия чатбот.

Стъпка 1: Инсталирайте ChatLab от IdoBooking Marketplace

1. Влезте в административния панел на IdoBooking
2. Отидете в секцията Marketplace (Пазар)
3. Намерете ChatLab и щракнете върху Install (Инсталиране)

IdoBooking изпраща Вашите данни за достъп до API към ChatLab автоматично - не е необходимо да създавате отделен API потребител или да копирате данните ръчно.

Стъпка 2: Създайте профил или влезте в своя акаунт в ChatLab

След като активирате ChatLab в каталога, ще бъдете пренасочени към съветник за първоначална настройка. Ако вече имате профил в ChatLab, влезте в него. В противен случай създайте нов профил.

Стъпка 3: Изберете абонаментен план

Изберете абонаментен план, който отговаря на Вашите нужди. Функциите за интеграция на резервации с IdoBooking (търсене на апартаменти, проверка на наличност, резервации) изискват функцията за интеграция с IdoBooking. Ако Вашият абонамент не я включва, последвайте подканата за надграждане или за контакт.

Стъпка 4: Изберете чатбот

Изберете съществуващ чатбот, който да свържете с IdoBooking, или създайте нов. Съветникът може да създаде нов бот автоматично вместо Вас.

Стъпка 5: Завършете настройката

Съветникът автоматично:

• Свързва Вашите данни за достъп от IdoBooking с избрания чатбот
• Активира търсенето на апартаменти, проверките за наличност и търсенето на резервации. Създаването на резервации не се активира автоматично.
• Пренасочва Ви обратно към IdoBooking или към административния панел на ChatLab

След като завършите съветника, Вашият чатбот е готов да обработва запитвания за резервации. Можете да прецизирате отделните действия с изкуствен интелект в Settings > Actions (Настройки > Действия).

---

Опция B: Ръчна настройка

Ако предпочитате да конфигурирате интеграцията ръчно, следвайте тези стъпки.

Част 1: Създаване на API потребител в IdoBooking

Преди да свържете ChatLab към Вашата система IdoBooking, трябва да създадете специален потребител с API достъп в панела на IdoBooking.

Стъпка 1: Отидете до управлението на потребители

1. Влезте в административния панел на IdoBooking
2. Отидете на Settings > Users (Настройки > Потребители)
3. Щракнете върху Add new user (Добавяне на нов потребител)

Стъпка 2: Създайте потребителски профил

1. Въведете login name (потребителско име) за новия потребител (напр. „chatlab-api")
2. Попълнете останалата задължителна информация
3. Задайте сигурна парола за този профил

Стъпка 3: Конфигурирайте API достъпа

Конфигурирайте следните настройки за достъп на новия потребител:

1. Активирайте „Active API access" (Активен достъп до API) - това е задължително за работата на интеграцията
2. Деактивирайте „Active panel access" (Активен достъп до панела) - потребителят не се нуждае от достъп до административния панел

Стъпка 4: Задайте потребителска роля и разрешения

Имате две възможности за конфигуриране на ролята на потребителя:

Вариант A: Роля Administrator (по-лесен начин)

• Изберете Administrator (Администратор) като роля
• Това дава обширни права за API, дори когато достъпът до панела е изключен. Използвайте персонализирана роля, ако интеграцията се нуждае само от избрани операции за четене.

Вариант B: Персонализирана потребителска роля (по-детайлен контрол)

Ако предпочитате по-прецизен контрол, изберете Custom user (Персонализиран потребител) и конфигурирайте следните разрешения за модули:

• Reservations (Резервации) - Read-only (само за четене, ако чатботът само ще извлича информация за резервации) или Full access (пълен достъп, ако чатботът ще създава резервации)
• Customers (Клиенти) - Read-only (само за четене)
• Offers (Оферти) - Read-only (само за четене)

За персонализираните потребители трябва също така да конфигурирате разрешенията за локации:

1. Превъртете до секцията Location and accommodation permissions (Разрешения за локации и места за настаняване)
2. Изберете обектите, които този чатбот трябва да обслужва; дайте достъп до всички само ако това е целеният от Вас обхват.

Стъпка 5: Изключете ненужните известия

За да предотвратите получаването на оперативни известия от API потребителя, изключете следните опции:

• Notifications for property staff (Известия за персонала на обекта) - Disable (Деактивиране)
• Automatic email notifications (Автоматични имейл известия) - Disable (Деактивиране)

Стъпка 6: Запазете и съберете данните за връзка

1. Щракнете върху Save (Запазване), за да създадете потребителския профил
2. Запишете си следната информация - ще Ви е необходима за конфигурирането на ChatLab:

• Login (Потребителско име) - потребителското име, което създадохте (напр. chatlab-api)
• Password (Парола) - паролата, която зададохте
• Subdomain (Поддомейн) - Вашият поддомейн в IdoBooking (напр. client3760)

Как да намерите своя поддомейн: Погледнете адреса (URL) на Вашия панел в IdoBooking. Например, ако адресът Ви е https://client3760.idosell.com, Вашият поддомейн е client3760.

Част 2: Настройка на интеграцията в ChatLab

Стъпка 1: Отидете в раздела Connect

1. Влезте в административния панел на ChatLab
2. Изберете бота, който искате да конфигурирате
3. Отидете в раздела Connect (Свързване)
4. Намерете и щракнете върху IdoBooking в списъка с интеграции

Стъпка 2: Въведете данните за връзка

Попълнете формуляра за връзка с информацията, събрана от IdoBooking:

• Client Subdomain - въведете Вашия поддомейн в IdoBooking (без пълния URL адрес). Пример: client3760 (а не https://client3760.idosell.com)
• System Login - въведете потребителското име на API потребителя, когото създадохте в IdoBooking
• System Password - въведете паролата за API потребителя
• Default Currency - изберете валутата за информацията за цените
• Default Language - изберете езика за описанията на обектите

Стъпка 3: Свързване

1. След като попълните всички задължителни полета, бутонът Connect (Свързване) става активен
2. Щракнете върху Connect, за да установите връзката
3. Изчакайте съобщението за потвърждение
4. След като връзката е осъществена, ще видите известие за успех

След успешно свързване бутонът се променя от „Connect" на „Update Chatbot" (Актуализиране на чатбота), и се появява бутон „Disconnect" (Прекъсване на връзката), ако по-късно се наложи да деактивирате интеграцията.

---

Конфигуриране на действия с изкуствен интелект

След като Вашата интеграция с IdoBooking е свързана (чрез някой от двата метода), можете да конфигурирате кои действия с изкуствен интелект да изпълнява чатботът. Прегледайте активните действия и при двата метода на настройка. Създаването на резервации не се активира автоматично.

Налични действия с изкуствен интелект

• Get Apartments - показва списък с наличните апартаменти и места за настаняване с описания, разпределение на леглата и снимки
• Find Available Apartments - търси свободни апартаменти за даден период от дати с информация за цените
• Check Apartment Availability - проверява наличността за конкретен апартамент и период от дати
• Get Reservations - търси съществуващи резервации по идентификатор (ID), статус или период от дати
• Create Reservation - създава нови резервации с данните на гостите и информация за резервацията
• AI room search - съпоставя описанието на госта за това какво търси с описанията на Вашите стаи, вместо да проверява дати

AI room search и Get Apartments са алтернативи, а не допълващи се функции. Когато AI room search е включен, той заменя инструмента за стандартен списък и Get Apartments се премахва от чатбота, така че да е активен само един инструмент за показване на стаи. Действията, базирани на дати, остават незасегнати.

Активиране и персонализиране на действия

1. След свързването щракнете върху Configure AI Actions (Конфигуриране на действия с AI) в модалния прозорец за успех или отидете в Settings > Actions (Настройки > Действия) и намерете категорията IdoBooking
2. Включете действията, които искате да активирате
3. Персонализирайте етикета на действието (текста, който се показва на потребителите, докато действието се изпълнява) и инструкциите според нуждите
4. В диалоговия прозорец на действието щракнете върху Enable (Активиране) за ново действие или Update (Актуализиране) за съществуващо действие.

Конфигуриране на „Find available apartments"

Действието Find available apartments има две допълнителни настройки, които определят колко апартамента показва чатботът, когато гост попита за наличност, и кои апартаменти да бъдат избрани. Отворете действието от Settings > Actions > IdoBooking - find available apartments, за да получите достъп до тях.

Number of offers to show (Брой показвани оферти)

Плъзгач с диапазон от 3 до 10 (по подразбиране 6). Той определя колко апартамента връща чатботът на потребителя в един отговор.

• По-ниските стойности (3-4) правят отговора кратък и фокусиран, което е полезно, когато повечето гости избират между няколко предпочитани варианта.
• По-високите стойности (8-10) дават на гостите повече разнообразие за сравнение, което е подходящо за обекти с по-богат каталог.

Offer selection strategy (Стратегия за избор на оферти)

Падащо меню, което определя кои апартаменти да се изберат от пълния списък с налични резултати, след като бъдат филтрирани по дата и брой гости. Налични са четири опции:

• Cheapest offers (Най-евтини оферти, по подразбиране) - връща апартаментите с най-ниска минимална цена, сортирани от най-евтините към най-скъпите. Подходящо е, когато гостите са чувствителни към цената или искате да акцентирате на най-достъпните опции.
• Evenly distributed by price (Равномерно разпределени по цена) - избира апартаменти, разпределени равномерно в ценовия диапазон. Например при 9 оферти това дава приблизително 3 най-евтини, 3 в средния клас и 3 най-скъпи. Полезно е, когато искате гостите да видят пълния спектър от възможности, а не само бюджетните предложения.
• Most expensive offers (Най-скъпи оферти) - връща апартаментите с най-високи цени, сортирани от най-скъпите към най-евтините. Подходящо е за премиум обекти или когато искате да акцентирате върху най-високия си клас места за настаняване.
• Random selection (Случаен избор) - избира апартаменти на случаен принцип от филтрираните резултати. Полезно е, когато искате да разнообразите показваните апартаменти в отделните разговори и да избегнете препоръчването на едни и същи предложения всеки път.

И двете настройки се запазват индивидуално за всеки бот, заедно с персонализирания prompt и етикета на действието.

---

Тестване на завършената настройка

Отворете Overview (Преглед) и започнете нов тестов разговор. Поискайте стаи за бъдещ период от дати и конкретен брой гости, след което отворете върнатата връзка за резервация и сравнете датите, валутата и цената с IdoBooking. Тествайте търсенето на резервация с резервация, която имате право да проверявате. Активирайте и тествайте Create Reservation само тогава, когато действително възнамерявате да създадете реална резервация; тестът през чата може да запише данни във Вашата резервационна система.

Добри практики

Препоръки за сигурност (ръчна настройка)

• Използвайте отделен API потребител - създайте отделен потребител специално за интеграцията с ChatLab, вместо да използвате личния си администраторски профил
• Минимални разрешения - давайте само разрешенията, които са необходими за Вашия случай. Използвайте достъп само за четене, ако чатботът трябва единствено да извлича информация
• Редовна подмяна на данните за достъп - периодично актуализирайте паролата на API потребителя, след което актуализирайте данните за вход и в ChatLab

Оптимизиране на отговорите на чатбота

• Обучете бота си с информация за обекта - добавете описания на Вашите места за настаняване в базата от знания, включително удобства, характеристики на стаите и подробности за местоположението
• Задайте ясни потоци на разговорите - конфигурирайте приветствени съобщения, които насочват потребителите да питат за наличност, и използвайте предложени въпроси като „Проверка за наличност" или „Преглед на стаите"

---

Отстраняване на неизправности

• Неуспешно свързване - проверете дали „Active API access" е активиран за потребителя в IdoBooking
• Грешки „Access denied" (Отказан достъп) - уверете се, че потребителят има правилните разрешения за съответните модули
• Не се връщат данни - уверете се, че потребителят има достъп до съответните локации и обекти
• Неправилен поддомейн - проверете Вашия URL адрес в IdoBooking и извлечете само частта с поддомейна (напр. client3760 от https://client3760.idosell.com)

---

Каталог със стаи и общ преглед на хотела

Ако Вашият профил показва раздела Hotel (Хотел), използвайте Hotel > Rooms (Хотел > Стаи), за да прегледате каталога със стаи и статуса на обучение. AI room search е отделна функция от проверката на наличност по дати: тя намира съвпадения по описанията на стаите, докато действията за наличност проверяват конкретно заявения престой. Автоматичното индексиране на стаи зависи от автоматичното индексиране на каталога и зададения лимит за индексирани стаи; в противен случай използвайте Train rooms (Обучи стаи), когато опцията е налична. Прегледайте активираните действия и изчакайте обучението да приключи, преди да разчитате на AI room search.

Свързани статии

• Добавяне на чатбот към Вашия уебсайт
• Обучение на Вашия чатбот
• Изпращане на връзка към Вашия чатбот