Centrum Pomocy
Integracje chatbota

Integracja z Hostfully

Ostatnia aktualizacja:

Hostfully to platforma do zarządzania obiektami noclegowymi dla wynajmu wakacyjnego oraz agencji najmu krótkoterminowego. Połączenie jej z ChatLab pozwala Twojemu chatbotowi odpowiadać na pytania o Twoje obiekty, terminy i ceny bezpośrednio na podstawie aktualnych danych z Hostfully, sprawdzać rezerwacje gości i przekazywać zapytania rezerwacyjne do Twojego zespołu - zamiast korzystać ze statycznego tekstu, który musisz na bieżąco aktualizować.

Uwaga: Hostfully wymaga odpowiedniej funkcji integracji w planie. Jeśli Twój plan jej nie obejmuje, po otwarciu kafelka Hostfully zobaczysz krótką informację z linkiem do kontaktu z nami zamiast formularza połączenia.

Przykładowa rozmowa

Zobacz to w rozmowie

Od dat podróży po oferty pokoi

Wymaga obsługiwanej integracji hotelarskiej oraz włączonej akcji sprawdzania dostępności. Oferta lub zapytanie nie stanowią potwierdzenia rezerwacji.

Przykład ChatLabPrzykładowa rozmowa

Odwiedzający: Pokój dla dwóch osób dorosłych, 14-16 sierpnia.

Odtwórz przykład lub przeczytaj go poniżej. Nie wykorzystano żadnych prawdziwych danych klientów.
1 / 6

Zbierz wymagania dotyczące pobytu.

Odtwarzanie zatrzymuje się, gdy ten przykład znika z ekranu. To jest symulacja, a nie czat na żywo. Elementy sterujące widgetu wewnątrz odtwarzania nie są interaktywne.
Przeczytaj cały przykład
  1. Zbierz wymagania dotyczące pobytu.

    Odwiedzający: Pokój dla dwóch osób dorosłych, 14-16 sierpnia.

  2. Zapytaj o brakujące szczegóły daty przed rozpoczęciem wyszukiwania.

    Asystent: Którego roku dotyczy pobyt?

  3. Gość podaje rok.

    Odwiedzający: 2027.

  4. Wyślij zapytanie do połączonego systemu hotelarskiego.

    Sprawdzam dostępność pokoi...

  5. Przedstaw oferty zwrócone dla tego pobytu.

    Pokój dwuosobowy z widokiem na morze, €280 / stay. Przykładowa oferta dla dwóch dorosłych na dwie noce.

  6. Przejdź dalej, korzystając ze ścieżki rezerwacji obsługiwanej przez Twoją integrację.

    Asystent: Sprawdź ostateczną cenę i warunki na stronie rezerwacji. W tej prezentacji nie dokonano żadnej rezerwacji.

Przykład pokazuje doświadczenie gościa. Dostępne akcje i zwracane informacje zależą od tej integracji oraz Twojej konfiguracji.

Co zapewnia integracja

Po połączeniu chatbot zyskuje pięć akcji Hostfully. Osobna akcja AI room search jest dostępna wtedy, gdy chatbot posiada odpowiedni limit wyszukiwania pokoi.

Hostfully - get properties - wyświetla listę obiektów Twojej agencji. Dla każdego z nich chatbot może pokazać nazwę, opis, zdjęcie, maksymalną liczbę gości oraz link do strony obiektu w Hostfully. Opisy są pobierane w języku treści wybranym podczas łączenia.

Hostfully - find available properties - gość podaje zakres dat i liczbę osób, a chatbot zwraca obiekty wolne w tych terminach wraz z ceną pobytu i linkiem do rezerwacji dla każdego obiektu.

Hostfully - check availability - gość pyta o jeden konkretny obiekt. Chatbot sprawdza kalendarz obiektu pod kątem wybranych dat, informuje, czy jest on wolny, a jeśli nie - jakie terminy są zajęte, podaje cenę dla danej liczby gości oraz link do rezerwacji.

Hostfully - get reservation status - gość, który ma już rezerwację, podaje jej numer referencyjny, a chatbot odczytuje z Hostfully jej status, nazwę obiektu, nazwisko gościa oraz daty zameldowania i wymeldowania.

Hostfully - create booking request - chatbot zbiera informacje o obiekcie, terminach, liczbie dorosłych i dzieci, a także imię i nazwisko, adres e-mail i numer telefonu gościa, potwierdza je z gościem i tworzy nowego leada na Twoim koncie Hostfully. Gość otrzymuje numer referencyjny, a Twój zespół przejmuje dalszą obsługę bezpośrednio w Hostfully.

Daty są rozumiane z języka naturalnego, więc gość może napisać "w następny weekend" lub "12-15 czerwca" zamiast podawać ścisły format daty.

Zanim zaczniesz

Potrzebujesz chatbota, z którym połączysz integrację. Jeśli jeszcze go nie masz, zapoznaj się najpierw z artykułem Jak utworzyć swojego pierwszego chatbota ChatLab.

Następnie przygotuj dwie wartości z Hostfully. Obie znajdują się na tej samej stronie: zaloguj się do Hostfully, kliknij nazwę swojej firmy w menu głównym i wybierz Agency Settings.

  1. API Key - w sekcji API Key na stronie Agency Settings. Dostęp do API to funkcja konta Hostfully; jeśli tej sekcji nie ma na Twoim koncie, poproś wsparcie Hostfully o jej włączenie. Zobacz Uwierzytelnianie Hostfully API.
  2. Agency UID - na samym dole strony Agency Settings.

Opcjonalnie przygotuj trzecią wartość:

  1. Booking URL format - adres Twojej własnej strony rezerwacji z placeholderami, które ChatLab uzupełnia dla każdej odpowiedzi:

    • {web_link} - link do strony obiektu w Hostfully
    • {property_uid} - identyfikator obiektu w Hostfully
    • {date_from} - data zameldowania
    • {date_to} - data wymeldowania
    • {guests} - liczba gości

    Na przykład:

    {web_link}?checkIn={date_from}&checkOut={date_to}&guests={guests}
    

    Jeśli zostawisz to pole puste, chatbot nadal będzie odpowiadać na pytania o dostępność i ceny, używając linku do strony obiektu w Hostfully bez parametrów dat.

Krok 1: Połącz Hostfully

  1. Wybierz swojego chatbota i przejdź do zakładki Connect (Połącz).
  2. Kliknij Connect na kafelku Hostfully.

Zakładka Connect z wyróżnionym kafelkiem integracji Hostfully

  1. Wklej swój API Key oraz Agency UID, wybierz Default content language (Domyślny język treści) i opcjonalnie uzupełnij pole Booking URL format (Format adresu URL rezerwacji).

Formularz integracji Hostfully z polami API Key, Agency UID, Default content language i Booking URL format

  1. Kliknij Connect.

ChatLab zapisze ustawienia i natychmiast wykona połączenie testowe, które pobierze listę obiektów Twojej agencji. Jeśli klucz API lub Agency UID są nieprawidłowe, integracja zostanie ponownie wyłączona, a błąd pojawi się w formularzu - dzięki temu uszkodzone połączenie nigdy nie pozostaje w stanie częściowego włączenia. W przypadku powodzenia ChatLab zapisze Twoje obiekty wraz z ich opisami i zdjęciami we własnej pamięci podręcznej, co zapewni szybkie odpowiedzi w przyszłości.

Default content language decyduje o tym, w jakim języku ChatLab ma pobierać nazwy i opisy obiektów, gdy w Hostfully są one dostępne w kilku wersjach językowych. Dostępne języki to angielski, polski, niemiecki, hiszpański, francuski i włoski; domyślnym językiem jest angielski.

Krok 2: Przejrzyj akcje Hostfully

Połączenie automatycznie włącza cztery akcje: pobieranie obiektów, sprawdzanie dostępności, wyszukiwanie dostępnych obiektów oraz sprawdzanie statusu rezerwacji. Akcja Create booking request pozostaje wyłączona, ponieważ zapisuje nowego leada na Twoim koncie Hostfully; włącz ją, jeśli chcesz, aby goście mogli wysyłać zapytania rezerwacyjne bezpośrednio z poziomu czatu.

Aby przejrzeć lub dostosować akcje, przejdź do Settings > Actions (Ustawienia > Akcje) i odszukaj grupę Hostfully Actions. Możesz także kliknąć Hostfully w panelu Filter by Platform (Filtruj według platformy) po prawej stronie, aby wyświetlić tylko tę grupę:

  • Hostfully - get properties - domyślna etykieta akcji "Getting properties..."
  • Hostfully - check availability - domyślna etykieta akcji "Checking availability..."
  • Hostfully - find available properties - domyślna etykieta akcji "Searching available properties..."
  • Hostfully - get reservation status - domyślna etykieta akcji "Checking reservation..."
  • Hostfully - create booking request - domyślna etykieta akcji "Submitting request..."

Grupa Hostfully Actions w Settings > Actions przed połączeniem integracji

Powyższy zrzut ekranu przedstawia grupę przed podłączeniem integracji: akcje oraz opcjonalna funkcja AI room search są widoczne na liście, ale oznaczone jako Not connected i niedostępne dla chatbota. Funkcja AI room search zależy od limitu pokoi i automatycznego indeksowania katalogu; nie ma gwarancji, że aktywuje się przy każdym połączeniu. Kiedy AI room search jest włączona, przejmuje wyszukiwanie obiektów, a standardowa akcja get properties ustępuje jej miejsca.

Dla każdej akcji możesz edytować:

  • Action Label - krótki komunikat, który gość widzi na czacie podczas wykonywania akcji.
  • Instructions - opis działania akcji, na podstawie którego AI decyduje, kiedy ją wywołać.
  • User Instructions - Twoje własne wytyczne uzupełniające, na przykład wymóg zapytania o liczbę gości przed rozpoczęciem wyszukiwania czy informowanie o minimalnej długości pobytu.

Możesz także wyłączyć dowolną pojedynczą akcję, jeśli jej nie potrzebujesz. Na przykład możesz pozostawić sprawdzanie dostępności i cen, ale wyłączyć sprawdzanie rezerwacji.

Akcja find available properties posiada dodatkowo ustawienie liczby wyników: od 1 do 10 obiektów, z wartością domyślną 5. Ogranicza to zwracaną listę, więc odpowiedź nie zawsze musi zawierać pełną listę wszystkich wolnych obiektów.

Krok 3: Przetestuj działanie

Przejdź do zakładki Overview (Przegląd), rozpocznij nową rozmowę testową i sprawdź pytania odpowiadające poszczególnym akcjom:

  • "Jakie macie apartamenty?" - wywołuje Hostfully - get properties
  • "Co jest wolne od 12 do 15 czerwca w przyszłym roku dla 2 dorosłych?" - wywołuje Hostfully - find available properties
  • "Czy Seaside Loft jest wolny w następny weekend?" - wywołuje Hostfully - check availability
  • "Jaki jest status mojej rezerwacji ABC123?" - wywołuje Hostfully - get reservation status
  • "Chcę zarezerwować Seaside Loft na te terminy" - wywołuje Hostfully - create booking request, o ile akcja została włączona

Upewnij się, że nazwy obiektów i ceny zgadzają się z Twoimi danymi w Hostfully, linki do rezerwacji otwierają Twoją stronę z uzupełnionymi już datami, a testowe zapytanie rezerwacyjne pojawia się jako nowy lead w Hostfully.

Zarządzanie integracją

Aktualizacja ustawień - otwórz kafelek Hostfully w zakładce Connect, zmień klucz API, Agency UID, język treści lub Booking URL format i kliknij Update Chatbot (Zaktualizuj chatbota). ChatLab ponownie przeprowadzi połączenie testowe i odświeży pamięć podręczną obiektów.

Odłączanie - otwórz kafelek Hostfully i kliknij Disconnect (Odłącz). Akcje Hostfully przestaną być dostępne dla chatbota, a zapisane dane obiektów zostaną usunięte z pamięci podręcznej. Twoje ustawienia pozostaną w formularzu, dzięki czemu ponowne połączenie w przyszłości zajmie tylko jedno kliknięcie.

Wskazówki

  • Nie przestawaj trenować bota na treściach ze swojej strony internetowej. Akcje Hostfully obejmują obiekty, terminy i ceny; o wszystko inne, o co pyta gość (godziny zameldowania, parking, regulamin obiektu, zwierzęta), dba Twoja baza wiedzy. Zobacz Trenowanie chatbota - podstawy i limity.
  • Umieść zasady rezerwacji, takie jak minimalna długość pobytu czy polityka zadatków, w instrukcjach użytkownika danej akcji, aby chatbot wspominał o nich od razu przy sprawdzaniu dostępności, zamiast zmuszać gościa do szukania tych informacji później.
  • Dodaj sugerowane pytania, takie jak "Sprawdź dostępność" lub "Pokaż apartamenty", aby goście od razu widzieli, co potrafi chatbot.
  • Zapytanie rezerwacyjne jest tworzone w Hostfully dopiero wtedy, gdy chatbot pozna imię i nazwisko, e-mail oraz telefon gościa, a sam gość potwierdzi te dane. Jeśli korzystasz również z formularza zbierania leadów, zachowaj spójność między nimi, aby goście nie musieli podawać tych samych danych dwa razy. Zobacz Zbieranie leadów.
  • Każda odpowiedź, która wywołuje akcję Hostfully, zużywa kredyty wiadomości tak samo jak każda inna odpowiedź chatbota. Zobacz Czym jest kredyt wiadomości.

Powiązane artykuły

Katalog pokoi i przegląd hotelu

Jeśli na Twoim koncie widoczna jest zakładka Hotel, przejdź do Hotel > Rooms (Pokoje), aby przejrzeć katalog pokoi i status trenowania. Funkcja AI room search działa niezależnie od sprawdzania dostępności według dat: dopasowuje ona opisy obiektów, podczas gdy akcje dostępności weryfikują konkretny termin pobytu. Automatyczne indeksowanie obiektów zależy od automatycznego indeksowania katalogu oraz przypisanej pojemności pokoi; w przeciwnym razie skorzystaj z opcji Train rooms (Trenuj pokoje), gdy jest dostępna. Przejrzyj włączone akcje i poczekaj na zakończenie trenowania, zanim zaczniesz polegać na funkcji AI room search.