Свържете своя чатбот в ChatLab със системата за резервации IdoBooking, за да предоставите на посетителите на уебсайта си информация за наличността в реално време и съдействие при резервации.
Какво предоставя интеграцията
С активирана интеграция с IdoBooking Вашият чатбот може да:
- Извежда наличните апартаменти и места за настаняване с описания и снимки
- Проверява наличността за конкретни дати
- Намира налични апартаменти за даден период с цени
- Търси съществуващи резервации по ID, статус или период от време
- Създава нови резервации с данни за гостите
Има два начина за настройка на тази интеграция - чрез IdoBooking Marketplace (препоръчително) или ръчно през администраторския панел на ChatLab.
Вариант A: Настройка чрез IdoBooking Marketplace (препоръчително)
Най-бързият начин да свържете ChatLab с IdoBooking е през IdoBooking Marketplace. Този метод обработва данните за достъп до API автоматично и активира всички AI действия за Вашия чатбот.
Стъпка 1: Инсталирайте ChatLab от IdoBooking Marketplace
- Влезте в своя администраторски панел в IdoBooking
- Отидете в раздел Marketplace (Пазар)
- Намерете ChatLab и щракнете върху Install (Инсталиране)
IdoBooking изпраща Вашите данни за API автоматично към ChatLab - няма нужда да създавате отделен API потребител или да копирате данни за достъп ръчно.
Стъпка 2: Създайте профил в ChatLab или влезте в него
След като активирате ChatLab в каталога marketplace, ще бъдете пренасочени към помощен съветник за настройка. Ако вече имате профил в ChatLab, влезте в него. В противен случай създайте нов профил.
Стъпка 3: Изберете абонаментен план
Изберете абонаментен план, който отговаря на Вашите нужди. Функциите за интеграция на резервации с IdoBooking (търсене на апартаменти, проверка на наличност, резервации) изискват план Standard или Premium.
Стъпка 4: Изберете чатбот
Изберете съществуващ чатбот, който да свържете с IdoBooking, или създайте нов. Помощният съветник може да създаде нов бот за Вас автоматично.
Стъпка 5: Завършете настройката
Помощният съветник автоматично:
- Свързва Вашите данни за достъп от IdoBooking с избрания чатбот
- Активира всички налични AI действия (търсене на апартаменти, проверки на наличност, резервации)
- Пренасочва Ви обратно към IdoBooking или към администраторския панел на ChatLab
След завършване на съветника Вашият чатбот е готов да обработва запитвания за резервации. Можете да прецизирате отделните AI действия в Bot Settings > Actions (Настройки на бота > Действия).
Вариант B: Ръчна настройка
Ако предпочитате да конфигурирате интеграцията ръчно, следвайте тези стъпки.
Част 1: Създаване на API потребител в IdoBooking
Преди да свържете ChatLab с Вашата система IdoBooking, трябва да създадете специален потребител с достъп до API в панела на IdoBooking.
Стъпка 1: Отидете на управление на потребителите
- Влезте в своя администраторски панел в IdoBooking
- Отидете на Settings > Users (Настройки > Потребители)
- Щракнете върху Add new user (Добавяне на нов потребител)
Стъпка 2: Създайте потребителски акаунт
- Въведете потребителско име за вход за новия потребител (напр. "chatlab-api")
- Попълнете останалата задължителна информация
- Задайте сигурна парола за този профил
Стъпка 3: Конфигурирайте достъпа до API
Задайте следните настройки за достъп на новия потребител:
- Активирайте "Active API access" (Активен API достъп) - това е задължително за работата на интеграцията
- Деактивирайте "Active panel access" (Активен достъп до панела) - потребителят не се нуждае от достъп до администраторския панел
Стъпка 4: Задайте потребителска роля и разрешения
Имате две възможности за конфигуриране на потребителската роля:
Вариант A: Роля Administrator (по-лесен начин)
- Изберете Administrator (Администратор) като роля
- Тъй като потребителят няма да има достъп до панела, това е безопасен вариант, който предоставя пълни разрешения за API
Вариант B: Персонализирана роля Custom user (по-детайлен контрол)
Ако предпочитате по-прецизен контрол, изберете Custom user (Персонализиран потребител) и конфигурирайте следните модулни разрешения:
- Reservations (Резервации) - Read-only (само за четене, ако чатботът трябва само да извлича информация за резервации) или Full access (пълен достъп, ако чатботът ще създава резервации)
- Customers (Клиенти) - Read-only (само за четене)
- Offers (Оферти) - Read-only (само за четене)
За персонализираните потребители трябва също да конфигурирате разрешенията за локации:
- Превъртете до раздел Location and accommodation permissions (Разрешения за локации и места за настаняване)
- Препоръчваме да изберете Select all (Избери всички), за да предоставите достъп до всички обекти
Стъпка 5: Деактивирайте ненужните известия
За да предотвратите получаването на оперативни известия от API потребителя, деактивирайте следните опции:
- Notifications for property staff (Известия за персонала на обекта) - Деактивирайте
- Automatic email notifications (Автоматични имейл известия) - Деактивирайте
Стъпка 6: Запазете и съберете данните за връзка
- Щракнете върху Save (Запазване), за да създадете потребителския акаунт
- Запишете си следната информация - ще Ви е необходима за конфигурирането в ChatLab:
- Login - Потребителското име, което сте създали (напр. chatlab-api)
- Password - Паролата, която сте задали
- Subdomain - Вашият поддомейн в IdoBooking (напр. client3760)
Къде да намерите своя поддомейн: Погледнете адреса URL на Вашия панел в IdoBooking. Например, ако Вашият URL адрес е
https://client3760.idosell.com, поддомейнът Ви еclient3760.
Част 2: Настройване на интеграцията в ChatLab
Стъпка 1: Отидете в раздел Connect
- Влезте в своя администраторски панел в ChatLab
- Изберете бота, който искате да конфигурирате
- Отидете в раздел Connect (Свързване)
- Намерете и щракнете върху IdoBooking в списъка с интеграции
Стъпка 2: Въведете данните за връзка
Попълнете формуляра за връзка с информацията, взета от IdoBooking:
- Client Subdomain (Поддомейн на клиента) - Въведете своя поддомейн в IdoBooking (без пълния URL). Пример:
client3760(неhttps://client3760.idosell.com) - System Login (Системно потребителско име) - Въведете потребителското име на API потребителя, който създадохте в IdoBooking
- System Password (Системна парола) - Въведете паролата за API потребителя
- Default Currency (Валута по подразбиране) - Изберете валутата за ценовата информация
- Default Language (Език по подразбиране) - Изберете езика за описанията на обектите
Стъпка 3: Свързване
- След като попълните всички задължителни полета, бутонът Connect (Свързване) става активен
- Щракнете върху Connect (Свързване), за да установите връзката
- Изчакайте съобщението за потвърждение
- След като се свърже, ще видите известие за успех
След успешно свързване бутонът се променя от "Connect" на "Update Chatbot", и се появява бутон "Disconnect", ако по-късно се наложи да деактивирате интеграцията.
Конфигуриране на AI действия
След като Вашата интеграция с IdoBooking е свързана (чрез някой от двата метода), можете да конфигурирате кои AI действия да изпълнява чатботът Ви. Ако сте използвали настройката през marketplace, всички действия са активирани по подразбиране.
Налични AI действия
- Get Apartments - Извежда наличните апартаменти и места за настаняване с описания, разпределение на леглата и снимки
- Find Available Apartments - Търси налични апартаменти за даден период с информация за цените
- Check Apartment Availability - Проверява наличността за конкретен апартамент и период от дати
- Get Reservations - Търси съществуващи резервации по ID, статус или период
- Create Reservation - Създава нови резервации с данни за гостите и информация за резервацията
Активиране и персонализиране на действия
- След свързването щракнете върху Configure AI Actions (Конфигуриране на AI действия) в модалния прозорец за успех или отидете на Bot Settings > Actions (Настройки на бота > Действия) и намерете категорията IdoBooking
- Включете или изключете действията, които искате да активирате
- Персонализирайте етикета на действието (текста, който се показва на потребителите, докато действието се изпълнява) и инструкциите според нуждите си
- Щракнете върху Save (Запазване), за да приложите промените
Конфигуриране на "Find available apartments"
Действието Find available apartments (Намиране на налични апартаменти) има две допълнителни настройки, които определят колко апартамента показва чатботът, когато гост попита за наличност, и кои апартаменти да бъдат избрани. Отворете действието от Bot Settings > Actions > IdoBooking - find available apartments (Настройки на бота > Действия > IdoBooking - намиране на налични апартаменти), за да ги настроите.
Брой оферти за показване (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 (Случаен избор) - избира апартаменти на случаен принцип от филтрираните резултати. Полезно е, когато искате да разнообразите показваните апартаменти в отделните разговори и да избегнете препоръчването на едни и същи предложения всеки път.
И двете настройки се запазват индивидуално за всеки бот, заедно със съществуващия персонализиран промпт и етикет на действието.
Добри практики
Препоръки за сигурност (ръчна настройка)
- Използвайте отделен API потребител - Създайте специален потребител конкретно за интеграцията с ChatLab, вместо да използвате личния си администраторски профил
- Минимални разрешения - Предоставяйте само разрешенията, необходими за Вашия конкретен случай. Използвайте достъп само за четене, ако чатботът трябва единствено да извлича информация
- Редовна смяна на данните за достъп - Периодично обновявайте паролата на API потребителя и след това актуализирайте данните за достъп в ChatLab
Оптимизиране на отговорите на чатбота
- Обучете бота си с информация за обектите - Добавете описания на Вашите места за настаняване в базата от знания, включително удобства, характеристики на стаите и подробности за местоположението
- Задайте ясни сценарии на разговор - Конфигурирайте приветствени съобщения, които насочват потребителите да питат за наличност, и използвайте предложени въпроси като "Проверка на наличност" или "Преглед на стаите"
Отстраняване на неизправности
- Връзката е неуспешна - Проверете дали опцията "Active API access" е включена за потребителя в IdoBooking
- Грешки "Access denied" (Отказан достъп) - Проверете дали потребителят разполага с правилните модулни разрешения
- Не се връщат данни - Уверете се, че потребителят има достъп до съответните локации и имоти
- Неправилен поддомейн - Проверете своя URL адрес в IdoBooking и извлечете само частта за поддомейна (напр.
client3760отhttps://client3760.idosell.com)