Integrace s Hostfully

Hostfully je platforma pro správu nemovitostí (property management platform) určená pro ubytování v soukromí a agentury zajišťující krátkodobé pronájmy. Její propojení s ChatLabem umožní vašemu chatbotovi odpovídat na dotazy ohledně nabízených nemovitostí, termínů a cen přímo z vašich živých dat v Hostfully, vyhledávat rezervace hostů a předávat poptávky na rezervace vašemu týmu - místo toho, aby čerpal pouze ze statického textu, který musíte neustále ručně aktualizovat.

Poznámka: Hostfully vyžaduje odpovídající integrační funkci. Pokud ji váš plán nezahrnuje, po otevření dlaždice Hostfully se místo formuláře pro připojení zobrazí krátká zpráva s odkazem na kontaktování podpory.

Ukázková konverzace

Příklad ilustruje uživatelský zážitek hosta. Dostupné akce a vrácené informace závisí na této integraci a vaší konkrétní konfiguraci.

Co integrace nabízí

Po připojení získá chatbot pět akcí Hostfully. Samostatná akce AI room search je dostupná v případě, že má chatbot odpovídající kapacitu pro vyhledávání pokojů.

Hostfully - get properties - zobrazí seznam nemovitostí vaší agentury. U každé z nich může chatbot uvést název, popis, fotografii, maximální počet hostů a odkaz na stránku nemovitosti v Hostfully. Popisy se načítají v jazyce obsahu, který si zvolíte při připojování.

Hostfully - find available properties - host zadá časové rozmezí a počet osob a chatbot vrátí nemovitosti, které jsou v těchto termínech volné, včetně ceny za pobyt a odkazu na rezervaci pro každou z nich.

Hostfully - check availability - host se zeptá na jednu konkrétní nemovitost. Chatbot zkontroluje kalendář nemovitosti pro požadované termíny a odpoví, zda je volná (pokud ne, uvede obsazené termíny), jaká je cena pro daný počet hostů a přidá odkaz na rezervaci.

Hostfully - get reservation status - host, který již má rezervaci, zadá její referenční číslo a chatbot z Hostfully načte stav rezervace, název nemovitosti, jméno hosta a termíny příjezdu a odjezdu.

Hostfully - create booking request - chatbot shromáždí informace o nemovitosti, termínech, počtu dospělých i dětí a také jméno, e-mail a telefon hosta, tyto údaje si u hosta ověří a vytvoří nový lead ve vašem účtu Hostfully. Host obdrží referenční číslo a váš tým se o požadavek dále postará přímo v Hostfully.

Termíny jsou rozpoznávány z přirozeného jazyka, takže host může napsat například „příští víkend" nebo „12-15. června", aniž by musel dodržovat striktní formát data.

Než začnete

K propojení integrace potřebujete mít vytvořeného chatbota. Pokud jej ještě nemáte, postupujte nejprve podle návodu Jak vytvořit prvního chatbota v ChatLabu.

Poté si z Hostfully připravte dvě hodnoty. Obě najdete na stejné stránce: přihlaste se do Hostfully, v hlavní navigaci klikněte na název své společnosti a zvolte Agency Settings (Nastavení agentury).

1. API Key - v sekci API Key na stránce Agency Settings. Přístup k rozhraní API je funkcí účtu Hostfully; pokud tato sekce ve vašem účtu chybí, požádejte podporu Hostfully o její aktivaci. Podrobnosti najdete v dokumentaci Hostfully API authentication.
2. Agency UID - úplně dole na stránce Agency Settings.

Volitelně si můžete připravit také třetí hodnotu:

3. Booking URL format - adresu vaší vlastní rezervační stránky se zástupnými symboly (placeholdery), které ChatLab dosadí do každé odpovědi:

   • {web_link} - odkaz na stránku nemovitosti v Hostfully
   • {property_uid} - identifikátor nemovitosti v Hostfully
   • {date_from} - datum příjezdu
   • {date_to} - datum odjezdu
   • {guests} - počet hostů

   Příklad:

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

   Pokud toto pole necháte prázdné, chatbot bude na dostupnost a ceny odpovídat i nadále, přičemž použije odkaz na stránku nemovitosti v Hostfully bez zadaných termínů.

Krok 1: Připojení Hostfully

1. Vyberte svého chatbota a přejděte na kartu Connect (Připojit).
2. Na dlaždici Hostfully klikněte na Connect (Připojit).

3. Vložte svůj API Key a Agency UID, zvolte Default content language (Výchozí jazyk obsahu) a případně vyplňte pole Booking URL format.

4. Klikněte na Connect (Připojit).

ChatLab uloží nastavení a okamžitě provede testovací volání, které načte seznam nemovitostí vaší agentury. Pokud je klíč API nebo Agency UID nesprávné, integrace se automaticky vypne a ve formuláři se zobrazí chyba - nefunkční připojení tak nikdy nezůstane napůl aktivní. Při úspěšném ověření načte ChatLab nemovitosti včetně popisů a fotografií do své mezipaměti, aby byly následné odpovědi rychlé.

Nastavení Default content language určuje, v jakém jazyce má ChatLab číst názvy a popisy nemovitostí, pokud je má Hostfully k dispozici ve více jazycích. K dispozici je angličtina, polština, němčina, španělština, francouzština a italština; výchozím jazykem je angličtina.

Krok 2: Kontrola akcí Hostfully

Připojením se automaticky aktivují čtyři akce: načtení nemovitostí (get properties), kontrola dostupnosti (check availability), vyhledání volných nemovitostí (find available properties) a zjištění stavu rezervace (get reservation status). Akce Create booking request zůstává vypnutá, protože zapisuje nový lead do vašeho účtu Hostfully; zapněte ji ve chvíli, kdy chcete hostům umožnit odesílat poptávky na rezervace přímo z chatu.

Chcete-li akce zkontrolovat nebo upravit, přejděte do Settings > Actions (Nastavení > Akce) a vyhledejte skupinu Hostfully Actions. Můžete také kliknout na Hostfully v panelu Filter by Platform (Filtrovat podle platformy) vpravo a zobrazit pouze tuto skupinu:

• Hostfully - get properties - výchozí štítek akce „Getting properties..."
• Hostfully - check availability - výchozí štítek akce „Checking availability..."
• Hostfully - find available properties - výchozí štítek akce „Searching available properties..."
• Hostfully - get reservation status - výchozí štítek akce „Checking reservation..."
• Hostfully - create booking request - výchozí štítek akce „Submitting request..."

Snímek obrazovky výše ukazuje skupinu před připojením integrace: akce i volitelná funkce AI room search jsou sice uvedeny, ale mají označení Not connected (Nepřipojeno) a pro chatbota nejsou dostupné. Funkce AI room search závisí na kapacitě pokojů a automatické indexaci katalogu; není zaručeno, že se aktivuje při každém propojení. Pokud je AI room search zapnuto, převezme vyhledávání nabídek a standardní akce get properties ustoupí do pozadí.

U každé akce můžete upravit:

• Action Label - krátkou zprávu, kterou host uvidí v chatu během provádění akce.
• Instructions - popis fungování akce, podle kterého se umělá inteligence rozhoduje, kdy ji zavolat.
• User Instructions - vaše vlastní doplňující pravidla, například požadavek na zjištění počtu hostů před vyhledáváním nebo upozornění na minimální délku pobytu.

Jednotlivé akce můžete také vypnout, pokud je nechcete využívat. Můžete například nechat zapnutou dostupnost a ceny, ale vypnout vyhledávání rezervací.

Akce find available properties obsahuje také nastavení počtu výsledků: v rozmezí 1-10 nemovitostí s výchozí hodnotou 5. Toto nastavení omezuje počet zobrazených položek, odpověď tedy nemusí nutně obsahovat úplný seznam všech volných ubytování.

Krok 3: Otestování

Přejděte do sekce Overview (Přehled), zahajte novou testovací konverzaci a vyzkoušejte dotazy odpovídající jednotlivým akcím:

• „Jaké apartmány nabízíte?" - aktivuje Hostfully - get properties
• „Co máte volné od 12. do 15. června příštího roku pro 2 dospělé?" - aktivuje Hostfully - find available properties
• „Je Seaside Loft příští víkend volný?" - aktivuje Hostfully - check availability
• „Jaký je stav mé rezervace ABC123?" - aktivuje Hostfully - get reservation status
• „Chci si rezervovat Seaside Loft na tyto termíny" - aktivuje Hostfully - create booking request (pokud je akce zapnutá)

Zkontrolujte, zda názvy nemovitostí a ceny odpovídají údajům v Hostfully, zda rezervační odkazy otevírají vaši rezervační stránku s již předvyplněnými termíny a zda se testovací poptávka rezervace objeví jako nový lead v Hostfully.

Správa integrace

Aktualizace nastavení - na kartě Connect (Připojit) otevřete dlaždici Hostfully, upravte klíč API, Agency UID, jazyk obsahu nebo formát rezervační adresy a klikněte na Update Chatbot (Aktualizovat chatbota). ChatLab provede nový testovací dotaz a obnoví mezipaměť nemovitostí.

Odpojení - otevřete dlaždici Hostfully a klikněte na Disconnect (Odpojit). Akce Hostfully přestanou být pro chatbota dostupné a data nemovitostí uložená v mezipaměti se smažou. Vaše nastavení ve formuláři zůstane uloženo, takže případné opětovné připojení v budoucnu zvládnete jedním kliknutím.

Tipy

• Nezapomínejte svého chatbota trénovat na obsahu svých webových stránek. Akce Hostfully pokrývají nemovitosti, termíny a ceny; na veškeré další dotazy hostů (časy příjezdu, parkování, domovní řád, domácí mazlíčci) odpovídá z vaší báze znalostí. Více informací najdete v článku Trénování chatbota - základy a limity.
• Pravidla rezervací, jako je minimální délka pobytu nebo storno podmínky a zálohy, vložte do uživatelských pokynů dané akce (User Instructions). Chatbot je tak zmíní přímo při ověřování dostupnosti a host se je nebude muset dozvídat dodatečně.
• Přidejte navrhované otázky, například „Zkontrolovat dostupnost" nebo „Ukázat apartmány", aby hosté snadno zjistili, co všechno chatbot dokáže.
• Poptávka na rezervaci se v Hostfully vytvoří až poté, co chatbot získá jméno, e-mail a telefon hosta a host tyto údaje potvrdí. Pokud na webu využíváte také formulář pro sběr leadů, slaďte oba postupy tak, aby host nemusel zadávat stejné údaje dvakrát. Podívejte se na Sběr leadů.
• Každá odpověď, která vyvolá akci Hostfully, spotřebovává zprávy (message credits) stejně jako jakákoli jiná odpověď chatbota. Přečtěte si, co je kredit na zprávy.

Související články

• Integrace s Beds24
• Integrace s Hotres
• Integrace s IdoBooking
• Integrace s KWHotel
• Integrace s Mews
• Trénování chatbota - základy a limity
• Co je kredit na zprávy

Room Catalog a Hotel Overview

Pokud váš účet obsahuje kartu Hotel, přejděte do sekce Hotel > Rooms (Hotel > Pokoje), kde můžete zkontrolovat katalog pokojů a stav trénování. Akce AI room search funguje odlišně od ověřování dostupnosti podle termínů: vyhledává shody v popisech nemovitostí, zatímco akce dostupnosti ověřují konkrétní poptávaný pobyt. Automatická indexace nemovitostí závisí na automatické indexaci katalogu a přiřazené kapacitě pokojů; v opačném případě použijte tlačítko Train rooms (Trénovat pokoje), pokud je k dispozici. Než se začnete na vyhledávání AI room search spoléhat, zkontrolujte povolené akce a počkejte na dokončení trénování.