Integrarea cu Hostfully

Hostfully este o platformă de gestionare a proprietăților pentru închirieri de vacanță și agenții de închirieri pe termen scurt. Conectarea acesteia la ChatLab îi permite chatbotului dumneavoastră să răspundă la întrebări despre proprietăți, date și prețuri folosind datele live din Hostfully, să caute rezervarea unui oaspete și să transmită cererile de rezervare către echipa dumneavoastră, în loc să răspundă pe baza unui text static pe care trebuie să îl actualizați manual.

Notă: Hostfully necesită funcționalitatea de integrare corespunzătoare. Dacă planul dumneavoastră nu o include, deschiderea pictogramei Hostfully va afișa o scurtă notă cu un link pentru a ne contacta, în locul formularului de conectare.

Exemplu de conversație

Exemplul ilustrează experiența oaspetelui. Acțiunile disponibile și informațiile returnate depind de această integrare și de configurația dumneavoastră.

Ce oferă integrarea

Odată conectat, chatbotul primește cinci acțiuni Hostfully. O acțiune separată de AI room search este disponibilă atunci când chatbotul dispune de capacitatea corespunzătoare de căutare a camerelor.

Hostfully - get properties - listează proprietățile agenției dumneavoastră. Pentru fiecare dintre acestea, chatbotul poate afișa numele, descrierea, fotografia, numărul maxim de oaspeți și linkul paginii proprietății din Hostfully. Descrierile sunt preluate în limba de conținut pe care o alegeți în momentul conectării.

Hostfully - find available properties - oaspetele introduce un interval de date și numărul de oaspeți, iar chatbotul returnează proprietățile libere pentru acele date, împreună cu prețul sejurului și un link de rezervare pentru fiecare proprietate.

Hostfully - check availability - oaspetele întreabă despre o anumită proprietate. Chatbotul verifică calendarul proprietății pentru datele solicitate, indică dacă este liberă, ce date sunt ocupate dacă nu este disponibilă, prețul pentru numărul respectiv de oaspeți și oferă un link de rezervare.

Hostfully - get reservation status - un oaspete care a rezervat deja oferă numărul de referință al rezervării, iar chatbotul citește din Hostfully statusul, proprietatea, numele oaspetelui și datele de check-in și check-out.

Hostfully - create booking request - chatbotul colectează proprietatea, datele, numărul de adulți și copii, precum și numele, adresa de e-mail și numărul de telefon ale oaspetelui, le confirmă cu acesta și creează un nou lead în contul dumneavoastră Hostfully. Oaspetele primește un număr de referință, iar echipa dumneavoastră preia solicitarea direct din Hostfully.

Datele calendaristice sunt înțelese din limbajul natural, astfel încât un oaspete poate scrie "weekendul viitor" sau "12-15 iunie", fără a fi nevoie de un format strict de dată.

Înainte de a începe

Aveți nevoie de un chatbot la care să conectați integrarea. Dacă nu ați creat încă unul, urmați mai întâi ghidul Cum să vă creați primul chatbot ChatLab.

Apoi, obțineți două valori din Hostfully. Ambele se află pe aceeași pagină: conectați-vă la Hostfully, faceți clic pe numele companiei dumneavoastră din meniul principal de navigare și alegeți Agency Settings (Setări agenție).

1. API Key - în secțiunea API Key din pagina Agency Settings. Accesul la API este o funcție a contului Hostfully; dacă secțiunea lipsește din contul dumneavoastră, solicitați asistenței Hostfully să o activeze. Consultați Hostfully API authentication.
2. Agency UID - în partea de jos a paginii Agency Settings.

Opțional, pregătiți o a treia valoare:

3. Booking URL format - adresa propriei pagini de rezervare, cu variabile de substituție pe care ChatLab le completează pentru fiecare răspuns:

   • {web_link} - linkul paginii proprietății din Hostfully
   • {property_uid} - identificatorul proprietății în Hostfully
   • {date_from} - data de check-in
   • {date_to} - data de check-out
   • {guests} - numărul de oaspeți

   De exemplu:

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

   Dacă lăsați acest câmp necompletat, chatbotul va răspunde în continuare în legătură cu disponibilitatea și prețurile, folosind linkul paginii proprietății din Hostfully fără parametri de dată.

Pasul 1: Conectați Hostfully

1. Selectați chatbotul dumneavoastră și navigați la fila Connect (Conectare).
2. Faceți clic pe Connect (Conectare) pe pictograma Hostfully.

3. Inserați valorile pentru API Key și Agency UID, alegeți opțiunea pentru Default content language (Limbă conținut implicită) și, opțional, completați câmpul Booking URL format (Format URL rezervare).

4. Faceți clic pe Connect.

ChatLab salvează setările și execută imediat un apel de testare care listează proprietățile agenției dumneavoastră. Dacă cheia API sau Agency UID este incorectă, integrarea este dezactivată la loc, iar eroarea este afișată în formular, evitând lăsarea unei conexiuni nefuncționale parțial configurate. La reușită, ChatLab încarcă proprietățile dumneavoastră cu descrierile și fotografiile acestora în propriul cache, astfel încât răspunsurile ulterioare să fie rapide.

Opțiunea Default content language stabilește limba în care ChatLab citește numele și descrierile proprietăților atunci când Hostfully le conține în mai multe limbi. Sunt disponibile engleza, poloneza, germana, spaniola, franceza și italiana; valoarea implicită este engleza.

Pasul 2: Revizuiți acțiunile Hostfully

Conectarea activează automat patru acțiuni: get properties, check availability, find available properties și get reservation status. Acțiunea Create booking request rămâne dezactivată, deoarece aceasta adaugă un nou lead în contul dumneavoastră Hostfully; activați-o atunci când doriți ca oaspeții să poată trimite cereri de rezervare direct din chat.

Pentru a revizui sau ajusta acțiunile, navigați la Settings > Actions (Setări > Acțiuni) și consultați grupul Hostfully Actions. De asemenea, puteți face clic pe Hostfully în panoul Filter by Platform (Filtrare după platformă) din dreapta pentru a afișa doar acest grup:

• Hostfully - get properties - etichetă implicită de acțiune "Getting properties..."
• Hostfully - check availability - etichetă implicită de acțiune "Checking availability..."
• Hostfully - find available properties - etichetă implicită de acțiune "Searching available properties..."
• Hostfully - get reservation status - etichetă implicită de acțiune "Checking reservation..."
• Hostfully - create booking request - etichetă implicită de acțiune "Submitting request..."

Captura de ecran de mai sus prezintă grupul înainte de conectarea integrării: acțiunile și funcția opțională AI room search sunt listate, dar marcate cu Not connected (Neconectat) și indisponibile pentru chatbot. AI room search depinde de capacitatea de camere alocată și de indexarea automată a catalogului; nu este garantată activarea acesteia la fiecare conexiune. Când funcția AI room search este activată, aceasta preia descoperirea proprietăților, iar acțiunea simplă get properties este trecută pe plan secund.

Pentru fiecare acțiune puteți edita:

• Action Label (Etichetă acțiune) - mesajul scurt pe care oaspetele îl vede în chat în timp ce acțiunea rulează.
• Instructions (Instrucțiuni) - ceea ce face acțiunea, informații pe care inteligența artificială le folosește pentru a decide când să o apeleze.
• User Instructions (Instrucțiuni utilizator) - propriile dumneavoastră reguli suplimentare, de exemplu solicitarea numărului de oaspeți înainte de căutare sau menționarea duratei minime de ședere.

De asemenea, puteți dezactiva o acțiune individuală dacă nu aveți nevoie de ea. De exemplu, puteți lăsa active disponibilitatea și prețurile, dar să dezactivați căutarea rezervărilor.

Acțiunea find available properties are, de asemenea, o setare pentru numărul de rezultate: între 1 și 10 proprietăți, valoarea implicită fiind 5. Aceasta limitează lista returnată, prin urmare un răspuns nu reprezintă neapărat o listă completă a fiecărei proprietăți libere.

Pasul 3: Testați integrarea

Deschideți fila Overview (Prezentare generală), începeți o nouă conversație de test și încercați întrebări care corespund fiecărei acțiuni:

• "Ce apartamente aveți?" - declanșează Hostfully - get properties
• "Ce este liber între 12 și 15 iunie anul viitor pentru 2 adulți?" - declanșează Hostfully - find available properties
• "Este liber Seaside Loft weekendul viitor?" - declanșează Hostfully - check availability
• "Care este statusul rezervării mele ABC123?" - declanșează Hostfully - get reservation status
• "Doresc să rezerv Seaside Loft pentru acele date" - declanșează Hostfully - create booking request, dacă ați activat-o

Verificați dacă numele proprietăților și prețurile corespund datelor din Hostfully, dacă linkurile de rezervare deschid pagina dumneavoastră de rezervare cu datele deja completate și dacă o cerere de rezervare de test apare ca un lead nou în Hostfully.

Gestionarea integrării

Actualizarea setărilor - deschideți pictograma Hostfully din fila Connect (Conectare), modificați cheia API, Agency UID, limba de conținut sau formatul URL-ului de rezervare și faceți clic pe Update Chatbot (Actualizează chatbotul). ChatLab execută din nou apelul de testare și actualizează memoria cache a proprietăților.

Deconectarea - deschideți pictograma Hostfully și faceți clic pe Disconnect (Deconectare). Acțiunile Hostfully nu vor mai fi disponibile pentru chatbot, iar datele proprietăților din memoria cache sunt șterse. Setările dumneavoastră rămân salvate în formular, astfel încât reconectarea ulterioară se realizează printr-un singur clic.

Sfaturi utile

• Continuați să vă antrenați botul pe baza conținutului site-ului dumneavoastră web. Acțiunile Hostfully acoperă proprietățile, datele și prețurile; toate celelalte detalii pe care le poate întreba un oaspete (ore de check-in, parcare, regulamentul casei, animale de companie) provin din baza dumneavoastră de cunoștințe. Consultați Antrenarea chatbotului dumneavoastră - noțiuni de bază și limite.
• Adăugați reguli de rezervare, cum ar fi durata minimă a sejurului sau politica privind garanția, în secțiunea de instrucțiuni ale utilizatorului pentru acțiunea respectivă, astfel încât chatbotul să le menționeze odată cu disponibilitatea, în loc să lase oaspetele să le descopere ulterior.
• Adăugați întrebări sugerate precum "Verifică disponibilitatea" sau "Arată apartamentele", astfel încât oaspeții să descopere ce poate face chatbotul.
• O cerere de rezervare este creată în Hostfully numai după ce chatbotul obține numele, e-mailul și telefonul oaspetelui, iar acesta a confirmat detaliile. Dacă utilizați și un formular de colectare a leadurilor, asigurați-vă că cele două sunt coordonate, pentru a evita solicitarea acelorași date de două ori. Consultați Colectarea leadurilor.
• Fiecare răspuns care apelează o acțiune Hostfully consumă credite de mesaje la fel ca orice alt răspuns al chatbotului. Consultați Ce este un credit de mesaj.

Articole conexe

• Integrarea cu Beds24
• Integrarea cu Hotres
• Integrarea cu IdoBooking
• Integrarea cu KWHotel
• Integrarea cu Mews
• Antrenarea chatbotului dumneavoastră - noțiuni de bază și limite
• Ce este un credit de mesaj

Catalog de camere și prezentare generală a hotelului

Dacă în contul dumneavoastră apare fila Hotel, accesați Hotel > Rooms (Hotel > Camere) pentru a verifica catalogul de camere și stadiul antrenării. Funcția AI room search este separată de verificările de disponibilitate bazate pe date: aceasta găsește potriviri în descrierile proprietăților, în timp ce acțiunile de disponibilitate verifică un sejur solicitat. Indexarea automată a proprietăților depinde de indexarea automată a catalogului și de capacitatea atribuită camerelor; în caz contrar, folosiți Train rooms (Antrenează camerele) atunci când opțiunea este disponibilă. Verificați acțiunile activate și așteptați finalizarea antrenării înainte de a vă baza pe funcția AI room search.