Integracja z IdoBooking

Połącz swojego chatbota ChatLab z systemem rezerwacji IdoBooking, aby zapewnić odwiedzającym Twoją stronę informacje o dostępności w czasie rzeczywistym i pomoc w dokonywaniu rezerwacji.

Przykładowa rozmowa

Przykład ilustruje doświadczenie klienta. Dostępne działania i zwracane informacje zależą od tej integracji oraz Twojej konfiguracji.

Zanim zaczniesz

Najpierw utwórz lub wybierz chatbota. Potrzebujesz uprawnień do zarządzania jego integracjami oraz dostępu do ustawień połączenia na koncie zewnętrznym. Jeśli na kafelku Connect (Połącz) wyświetla się prośba o zmianę planu na wyższy lub kontakt, upewnij się, że Twoja subskrypcja obejmuje tę integrację. Chroń dane uwierzytelniające API; nigdy nie wklejaj ich do kodu osadzania na stronie.

Co zapewnia integracja

Po włączeniu integracji z IdoBooking Twój chatbot może:

• Wyświetlać listę dostępnych apartamentów i miejsc noclegowych wraz z opisami i zdjęciami
• Sprawdzać dostępność w określonych terminach
• Wyszukiwać dostępne apartamenty w danym zakresie dat wraz z cenami
• Wyszukiwać istniejące rezerwacje po identyfikatorze, statusie lub zakresie dat
• Tworzyć nowe rezerwacje z danymi gości

Tę integrację można skonfigurować na dwa sposoby - poprzez IdoBooking Marketplace (zalecane) lub ręcznie w panelu administracyjnym ChatLab.

---

Opcja A: Konfiguracja przez IdoBooking Marketplace (zalecana)

Najszybszym sposobem połączenia ChatLab z IdoBooking jest IdoBooking Marketplace. Ta metoda automatycznie obsługuje dane uwierzytelniające API i włącza dla Twojego chatbota akcje odczytu.

Krok 1: Zainstaluj ChatLab z IdoBooking Marketplace

1. Zaloguj się do swojego panelu administracyjnego IdoBooking
2. Przejdź do sekcji Marketplace
3. Znajdź ChatLab i kliknij Install (Zainstaluj)

IdoBooking automatycznie przesyła Twoje dane uwierzytelniające API do ChatLab - nie musisz tworzyć osobnego użytkownika API ani ręcznie kopiować danych dostępowych.

Krok 2: Utwórz konto w ChatLab lub zaloguj się do niego

Po aktywacji ChatLab w marketplace nastąpi przekierowanie do kreatora konfiguracji. Jeśli masz już konto w ChatLab, zaloguj się. W przeciwnym razie utwórz nowe konto.

Krok 3: Wybierz plan subskrypcji

Wybierz plan subskrypcji dopasowany do Twoich potrzeb. Funkcje integracji rezerwacji z IdoBooking (wyszukiwanie apartamentów, sprawdzanie dostępności, rezerwacje) wymagają funkcji integracji z IdoBooking. Jeśli Twoja subskrypcja jej nie obejmuje, postępuj zgodnie z komunikatem dotyczącym zmiany planu na wyższy lub kontaktu.

Krok 4: Wybierz chatbota

Wybierz istniejącego chatbota, którego chcesz połączyć z IdoBooking, lub utwórz nowego. Kreator może utworzyć nowego bota automatycznie.

Krok 5: Dokończ konfigurację

Kreator automatycznie:

• Łączy Twoje dane uwierzytelniające IdoBooking z wybranym chatbotem
• Włącza wyszukiwanie apartamentów, sprawdzanie dostępności oraz wyszukiwanie rezerwacji. Tworzenie rezerwacji nie jest włączane automatycznie.
• Przekierowuje Cię z powrotem do IdoBooking lub do panelu administracyjnego ChatLab

Po ukończeniu pracy z kreatorem Twój chatbot jest gotowy do obsługi zapytań o rezerwacje. Możesz dostosować poszczególne akcje AI w Settings > Actions (Ustawienia > Akcje).

---

Opcja B: Konfiguracja ręczna

Jeśli wolisz skonfigurować integrację ręcznie, wykonaj poniższe kroki.

Część 1: Tworzenie użytkownika API w IdoBooking

Przed połączeniem ChatLab z systemem IdoBooking musisz utworzyć w panelu IdoBooking dedykowanego użytkownika z dostępem do API.

Krok 1: Przejdź do zarządzania użytkownikami

1. Zaloguj się do swojego panelu administracyjnego IdoBooking
2. Przejdź do Settings > Users (Ustawienia > Użytkownicy)
3. Kliknij Add new user (Dodaj nowego użytkownika)

Krok 2: Utwórz konto użytkownika

1. Wpisz login nowego użytkownika (np. "chatlab-api")
2. Uzupełnij pozostałe wymagane informacje
3. Ustaw silne hasło dla tego konta

Krok 3: Skonfiguruj dostęp do API

Skonfiguruj następujące ustawienia dostępu dla nowego użytkownika:

1. Włącz "Active API access" (Aktywny dostęp do API) - jest to wymagane do działania integracji
2. Wyłącz "Active panel access" (Aktywny dostęp do panelu) - użytkownik nie potrzebuje dostępu do panelu administracyjnego

Krok 4: Ustaw rolę i uprawnienia użytkownika

Masz dwie opcje konfiguracji roli użytkownika:

Opcja A: Rola administratora (prostsza)

• Wybierz Administrator jako rolę
• Nadaje to szerokie uprawnienia do API, nawet gdy dostęp do panelu jest wyłączony. Użyj roli niestandardowej, jeśli integracja potrzebuje tylko wybranych operacji odczytu.

Opcja B: Niestandardowa rola użytkownika (bardziej szczegółowa)

Jeśli wolisz bardziej szczegółową kontrolę, wybierz Custom user (Użytkownik niestandardowy) i skonfiguruj następujące uprawnienia modułów:

• Reservations (Rezerwacje) - Read-only (Tylko do odczytu - jeśli chatbot ma tylko pobierać informacje o rezerwacjach) lub Full access (Pełny dostęp - jeśli chatbot będzie tworzyć rezerwacje)
• Customers (Klienci) - Read-only (Tylko do odczytu)
• Offers (Oferty) - Read-only (Tylko do odczytu)

W przypadku użytkowników niestandardowych musisz także skonfigurować uprawnienia do lokalizacji:

1. Przewiń do sekcji Location and accommodation permissions (Uprawnienia do lokalizacji i obiektów)
2. Wybierz obiekty, które ten chatbot powinien obsługiwać; nadaj dostęp do wszystkich tylko wtedy, gdy taki jest Twój zamierzony zakres.

Krok 5: Wyłącz niepotrzebne powiadomienia

Aby zapobiec otrzymywaniu powiadomień operacyjnych przez użytkownika API, wyłącz następujące opcje:

• Notifications for property staff (Powiadomienia dla personelu obiektu) - wyłącz
• Automatic email notifications (Automatyczne powiadomienia e-mail) - wyłącz

Krok 6: Zapisz i zgromadź dane połączenia

1. Kliknij Save (Zapisz), aby utworzyć konto użytkownika
2. Zanotuj następujące informacje - będą Ci potrzebne do konfiguracji w ChatLab:

• Login - utworzona nazwa użytkownika (np. chatlab-api)
• Hasło - ustawione hasło
• Subdomena - Twoja subdomena IdoBooking (np. client3760)

Jak znaleźć swoją subdomenę: Spójrz na adres URL swojego panelu IdoBooking. Na przykład, jeśli Twój adres URL to https://client3760.idosell.com, Twoją subdomeną jest client3760.

Część 2: Konfiguracja integracji w ChatLab

Krok 1: Przejdź do zakładki Connect

1. Zaloguj się do panelu administracyjnego ChatLab
2. Wybierz bota, którego chcesz skonfigurować
3. Przejdź do zakładki Connect (Połącz)
4. Znajdź i kliknij IdoBooking na liście integracji

Krok 2: Wprowadź dane połączenia

Wypełnij formularz połączenia informacjami zebranymi z IdoBooking:

• Client Subdomain (Subdomena klienta) - wpisz swoją subdomenę IdoBooking (bez pełnego adresu URL). Przykład: client3760 (nie https://client3760.idosell.com)
• System Login (Login systemowy) - wpisz nazwę użytkownika API utworzonego w IdoBooking
• System Password (Hasło systemowe) - wpisz hasło użytkownika API
• Default Currency (Domyślna waluta) - wybierz walutę dla informacji o cenach
• Default Language (Domyślny język) - wybierz język dla opisów obiektów

Krok 3: Połącz

1. Po wypełnieniu wszystkich wymaganych pól przycisk Connect (Połącz) stanie się aktywny
2. Kliknij Connect (Połącz), aby nawiązać połączenie
3. Poczekaj na komunikat potwierdzający
4. Po nawiązaniu połączenia zobaczysz powiadomienie o sukcesie

Po udanym połączeniu przycisk zmienia się z "Connect" na "Update Chatbot" (Zaktualizuj chatbota), a jeśli zajdzie potrzeba wyłączenia integracji w późniejszym czasie, pojawi się przycisk "Disconnect" (Rozłącz).

---

Konfigurowanie akcji AI

Gdy integracja z IdoBooking zostanie podłączona (dowolną metodą), możesz skonfigurować, jakie akcje AI Twój chatbot może wykonywać. Po użyciu dowolnej metody konfiguracji przejrzyj aktywne akcje. Tworzenie rezerwacji nie jest włączane automatycznie.

Dostępne akcje AI

• Get Apartments - wyświetla listę dostępnych apartamentów i miejsc noclegowych z opisami, układem łóżek i zdjęciami
• Find Available Apartments - wyszukuje dostępne apartamenty w danym zakresie dat wraz z informacjami o cenach
• Check Apartment Availability - sprawdza dostępność konkretnego apartamentu w określonym zakresie dat
• Get Reservations - wyszukuje istniejące rezerwacje po identyfikatorze, statusie lub zakresie dat
• Create Reservation - tworzy nowe rezerwacje z danymi gości i informacjami o rezerwacji
• AI room search - dopasowuje opis preferencji gościa do opisów Twoich pokoi, zamiast sprawdzać terminy

Wyszukiwanie pokoi przez AI (AI room search) i Get Apartments są alternatywami, a nie uzupełnieniem. Gdy AI room search jest włączone, zastępuje zwykłe narzędzie do wyświetlania listy, a Get Apartments zostaje wycofane z chatbota, dzięki czemu aktywne jest zawsze tylko jedno narzędzie do listowania pokoi. Akcje oparte na datach pozostają nienaruszone.

Włączanie i dostosowywanie akcji

1. Po nawiązaniu połączenia kliknij Configure AI Actions (Skonfiguruj akcje AI) w oknie z podsumowaniem sukcesu lub przejdź do Settings > Actions (Ustawienia > Akcje) i znajdź kategorię IdoBooking
2. Włącz akcje, z których chcesz korzystać
3. Dostosuj etykietę akcji (tekst wyświetlany użytkownikom podczas wykonywania akcji) i instrukcje według potrzeb
4. W oknie dialogowym akcji kliknij Enable (Włącz) dla nowej akcji lub Update (Aktualizuj) dla istniejącej akcji.

Konfigurowanie akcji "Find available apartments"

Akcja Find available apartments posiada dwa dodatkowe elementy sterujące, które decydują o tym, ile apartamentów chatbot pokazuje, gdy gość pyta o dostępność, oraz które apartamenty zostaną wybrane. Otwórz akcję z poziomu Settings > Actions > IdoBooking - find available apartments (Ustawienia > Akcje > IdoBooking - find available apartments), aby uzyskać do nich dostęp.

Number of offers to show (Liczba wyświetlanych ofert)

Suwak z zakresem od 3 do 10 (domyślnie 6). Określa, ile apartamentów chatbot zwraca użytkownikowi w pojedynczej odpowiedzi.

• Niższe wartości (3-4) sprawiają, że odpowiedź jest krótka i konkretna, co jest przydatne, gdy większość gości wybiera spośród zaledwie kilku faworytów.
• Wyższe wartości (8-10) dają gościom większy wybór do porównania, co przydaje się w obiektach z szerszą ofertą.

Offer selection strategy (Strategia wyboru ofert)

Lista rozwijana decydująca o tym, które apartamenty zostaną wybrane z pełnej listy dostępnych wyników po przefiltrowaniu według daty i liczby gości. Dostępne są cztery opcje:

• Cheapest offers (Najtańsze oferty) (domyślnie) - zwraca apartamenty o najniższej cenie minimalnej, posortowane od najtańszego do najdroższego. Dobre rozwiązanie, gdy goście zwracają uwagę na cenę lub chcesz zacząć od najbardziej przystępnych cenowo opcji.
• Evenly distributed by price (Równomiernie rozłożone według ceny) - wybiera apartamenty równomiernie rozłożone w całym przedziale cenowym. Na przykład przy 9 ofertach daje to mniej więcej 3 najtańsze, 3 ze średniej półki cenowej i 3 najdroższe. Przydatne, gdy chcesz, aby goście zobaczyli pełen przekrój oferty, a nie tylko propozycje budżetowe.
• Most expensive offers (Najdroższe oferty) - zwraca apartamenty o najwyższych cenach, posortowane od najdroższego do najtańszego. Dobre dla obiektów premium lub gdy chcesz zacząć od oferty z najwyższej półki.
• Random selection (Wybór losowy) - wybiera apartamenty losowo spośród przefiltrowanych wyników. Przydatne, gdy chcesz urozmaicić polecane apartamenty w różnych rozmowach i uniknąć ciągłego rekomendowania tych samych pozycji.

Oba ustawienia są zapisywane osobno dla każdego bota, obok dotychczasowego niestandardowego promptu i etykiety akcji.

---

Przetestuj ukończoną konfigurację

Otwórz Overview (Przegląd) i rozpocznij nową rozmowę testową. Zapytaj o pokoje w przyszłym terminie dla określonej liczby gości, a następnie otwórz zwrócony link do rezerwacji i porównaj daty, walutę oraz cenę z IdoBooking. Przetestuj wyszukiwanie rezerwacji, używając rezerwacji, do której podglądu masz uprawnienia. Włączaj i testuj akcję Create Reservation tylko wtedy, gdy naprawdę zamierzasz utworzyć rezerwację; test na czacie może zapisać dane w Twoim systemie rezerwacji.

Najlepsze praktyki

Zalecenia dotyczące bezpieczeństwa (konfiguracja ręczna)

• Używaj dedykowanego użytkownika API - utwórz osobnego użytkownika specjalnie dla integracji z ChatLab, zamiast korzystać ze swojego osobistego konta administratora
• Minimalne uprawnienia - nadawaj tylko te uprawnienia, które są niezbędne do Twojego zastosowania. Użyj dostępu tylko do odczytu, jeśli chatbot ma jedynie pobierać informacje
• Regularna rotacja danych uwierzytelniających - okresowo aktualizuj hasło użytkownika API, a następnie zaktualizuj dane dostępowe w ChatLab

Optymalizacja odpowiedzi chatbota

• Trenuj bota na informacjach o obiekcie - dodaj opisy swoich obiektów noclegowych do bazy wiedzy, w tym udogodnienia, wyposażenie pokoi oraz szczegóły dotyczące lokalizacji
• Ustaw przejrzyste ścieżki rozmowy - skonfiguruj wiadomości powitalne, które zachęcają użytkowników do pytania o dostępność, i korzystaj z sugerowanych pytań, takich jak "Sprawdź dostępność" lub "Zobacz pokoje"

---

Rozwiązywanie problemów

• Błąd połączenia - upewnij się, że opcja "Active API access" jest włączona dla użytkownika w IdoBooking
• Błędy "Access denied" (Odmowa dostępu) - sprawdź, czy użytkownik ma poprawne uprawnienia do modułów
• Brak zwracanych danych - upewnij się, że użytkownik ma dostęp do odpowiednich lokalizacji i obiektów
• Nieprawidłowa subdomena - sprawdź swój adres URL IdoBooking i wyodrębnij tylko część subdomeny (np. client3760 z adresu https://client3760.idosell.com)

---

Katalog pokoi i przegląd hotelu

Jeśli na Twoim koncie widoczna jest zakładka Hotel, użyj Hotel > Rooms (Hotel > Pokoje), aby przejrzeć katalog pokoi oraz status trenowania. Funkcja AI room search działa niezależnie od sprawdzania dostępności na podstawie dat: dopasowuje opisy pokoi, podczas gdy akcje sprawdzania dostępności weryfikują żądany pobyt. Automatyczne indeksowanie pokoi zależy od automatycznego indeksowania katalogu i przypisanej pojemności pokoi; w przeciwnym razie użyj opcji Train rooms (Trenuj pokoje), gdy jest dostępna. Przejrzyj włączone akcje i poczekaj na zakończenie trenowania przed rozpoczęciem korzystania z wyszukiwania pokoi przez AI.

Powiązane artykuły

• Dodawanie chatbota do strony internetowej
• Trenowanie chatbota: podstawy i ograniczenia
• Wysyłanie linku do chatbota