Integrazione con Hostfully

Hostfully è una piattaforma di gestione delle strutture per case vacanze e agenzie di affitti brevi. Collegandola a ChatLab consenti al tuo chatbot di rispondere alle domande su alloggi, date e prezzi usando i dati in tempo reale di Hostfully, di verificare la prenotazione di un ospite e di inoltrare le richieste di prenotazione al tuo team, invece di rispondere con testi statici che dovresti mantenere costantemente aggiornati.

Nota: Hostfully richiede la funzione di integrazione corrispondente. Se il tuo piano non la include, aprendo il riquadro di Hostfully vedrai una breve nota con un link per contattarci al posto del modulo di connessione.

Conversazione di esempio

L'esempio illustra l'esperienza dell'ospite. Le azioni disponibili e le informazioni restituite dipendono da questa integrazione e dalla tua configurazione.

Cosa offre l'integrazione

Una volta collegato, il chatbot riceve cinque azioni Hostfully. Un'azione separata AI room search è disponibile quando il chatbot ha la capacità di ricerca camere corrispondente.

Hostfully - get properties - elenca le strutture della tua agenzia. Per ciascuna, il chatbot può mostrare nome, descrizione, foto, numero massimo di ospiti e il link alla pagina della struttura su Hostfully. Le descrizioni vengono recuperate nella lingua dei contenuti che scegli durante la connessione.

Hostfully - find available properties - l'ospite indica un intervallo di date e il numero di ospiti, e il chatbot restituisce le strutture disponibili per quelle date, con il prezzo del soggiorno e un link di prenotazione per ciascuna struttura.

Hostfully - check availability - l'ospite chiede informazioni su una struttura specifica. Il chatbot verifica il calendario della struttura per le date richieste, comunica se è libera, quali date risultano occupate in caso contrario e il prezzo per il numero di ospiti specificato, oltre a un link di prenotazione.

Hostfully - get reservation status - un ospite che ha già prenotato inserisce il codice di prenotazione e il chatbot recupera da Hostfully lo stato, la struttura, il nome dell'ospite e le date di check-in e check-out.

Hostfully - create booking request - il chatbot raccoglie struttura, date, numero di adulti e bambini, nonché nome, e-mail e telefono dell'ospite, ne chiede conferma e crea un nuovo lead nel tuo account Hostfully. L'ospite riceve un codice di riferimento e il tuo team gestisce la richiesta direttamente in Hostfully.

Le date vengono interpretate dal linguaggio naturale, quindi un ospite può scrivere "prossimo weekend" o "12-15 giugno" anziché usare un formato di data rigido.

Prima di iniziare

Ti serve un chatbot a cui collegare l'integrazione. Se non ne hai ancora creato uno, segui prima la guida Come creare il tuo primo chatbot ChatLab.

Dopodiché recupera due valori da Hostfully. Si trovano entrambi nella stessa pagina: accedi a Hostfully, fai clic sul nome della tua azienda nel menu di navigazione principale e seleziona Agency Settings (Impostazioni agenzia).

1. API Key - nella sezione API Key della pagina Agency Settings. L'accesso alle API è una funzionalità dell'account Hostfully; se la sezione non è presente nel tuo account, chiedi all'assistenza di Hostfully di attivarla. Consulta Hostfully API authentication.
2. Agency UID - in fondo alla pagina Agency Settings.

Se desideri, prepara anche un terzo valore:

3. Booking URL format - l'indirizzo della tua pagina di prenotazione, con i segnaposto che ChatLab compila per ogni risposta:

   • {web_link} - il link alla pagina della struttura su Hostfully
   • {property_uid} - l'ID della struttura in Hostfully
   • {date_from} - data di check-in
   • {date_to} - data di check-out
   • {guests} - numero di ospiti

   Ad esempio:

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

   Se lasci vuoto questo campo, il chatbot risponde comunque su disponibilità e prezzi, utilizzando il link alla pagina della struttura su Hostfully senza date.

Passaggio 1: Collega Hostfully

1. Seleziona il tuo chatbot e vai alla scheda Connect (Collega).
2. Fai clic su Connect (Collega) nel riquadro di Hostfully.

3. Incolla la tua API Key e l'Agency UID, scegli la lingua in Default content language (Lingua predefinita dei contenuti) e, facoltativamente, compila il campo Booking URL format (Formato URL di prenotazione).

4. Fai clic su Connect (Collega).

ChatLab salva le impostazioni ed esegue immediatamente una chiamata di prova che elenca le strutture della tua agenzia. Se la chiave API o l'Agency UID non sono corretti, l'integrazione viene disattivata e l'errore compare nel modulo, evitando che una connessione non funzionante rimanga abilitata a metà. In caso di esito positivo, ChatLab carica le strutture con descrizioni e foto nella propria cache, garantendo risposte successive rapide.

Il campo Default content language determina in quale lingua ChatLab legge nomi e descrizioni delle strutture quando Hostfully le rende disponibili in più lingue. Sono supportati inglese, polacco, tedesco, spagnolo, francese e italiano; l'impostazione predefinita è l'inglese.

Passaggio 2: Rivedi le azioni Hostfully

La connessione attiva automaticamente quattro azioni: get properties, check availability, find available properties e get reservation status. L'azione Create booking request resta disattivata, poiché registra un nuovo lead nel tuo account Hostfully; attivala quando desideri che gli ospiti possano inviare richieste di prenotazione dalla chat.

Per rivedere o modificare le azioni, vai su Settings > Actions (Impostazioni > Azioni) e individua il gruppo Hostfully Actions. Puoi anche fare clic su Hostfully nel pannello Filter by Platform (Filtra per piattaforma) a destra per visualizzare solo questo gruppo:

• Hostfully - get properties - etichetta predefinita dell'azione "Getting properties..."
• Hostfully - check availability - default action label "Checking availability..."
• Hostfully - find available properties - default action label "Searching available properties..."
• Hostfully - get reservation status - default action label "Checking reservation..."
• Hostfully - create booking request - default action label "Submitting request..."

Lo screenshot qui sopra mostra il gruppo prima del collegamento dell'integrazione: le azioni e la ricerca opzionale AI room search sono elencate, ma contrassegnate come Not connected (Non connesso) e non disponibili per il chatbot. La funzione AI room search dipende dalla disponibilità di ricerca camere e dall'auto-indicizzazione del catalogo; non è garantito che si attivi con ogni connessione. Quando AI room search è attiva, gestisce la scoperta delle strutture e la normale azione get properties viene bypassata.

Per ogni azione puoi modificare:

• Action Label - il breve messaggio che l'ospite visualizza nella chat mentre l'azione è in esecuzione.
• Instructions - la descrizione di ciò che fa l'azione, usata dall'IA per decidere quando richiamarla.
• User Instructions - le tue regole personalizzate aggiuntive, ad esempio per richiedere il numero di ospiti prima della ricerca o per specificare la durata minima del soggiorno.

Puoi anche disattivare una singola azione se non desideri utilizzarla. Ad esempio, puoi mantenere attive disponibilità e prezzi ma disattivare la verifica delle prenotazioni.

L'azione find available properties include anche un'impostazione per il numero di risultati: da 1 a 10 strutture, con un valore predefinito di 5. Questa impostazione limita l'elenco restituito, quindi la risposta potrebbe non includere necessariamente tutte le strutture libere.

Passaggio 3: Esegui un test

Apri Overview (Panoramica), avvia una nuova conversazione di prova e prova domande corrispondenti a ciascuna azione:

• "Quali appartamenti avete?" - attiva Hostfully - get properties
• "Cosa c'è di disponibile dal 12 al 15 giugno del prossimo anno per 2 adulti?" - attiva Hostfully - find available properties
• "Il Seaside Loft è libero il prossimo fine settimana?" - attiva Hostfully - check availability
• "Qual è lo stato della mia prenotazione ABC123?" - attiva Hostfully - get reservation status
• "Vorrei prenotare il Seaside Loft per quelle date" - attiva Hostfully - create booking request, se l'hai abilitata

Verifica che i nomi delle strutture e i prezzi corrispondano ai dati di Hostfully, che i link di prenotazione aprano la tua pagina con le date già compilate e che una richiesta di prenotazione di prova compaia come nuovo lead in Hostfully.

Gestione dell'integrazione

Aggiornamento delle impostazioni - apri il riquadro Hostfully nella scheda Connect, modifica la chiave API, l'Agency UID, la lingua dei contenuti o il formato URL di prenotazione, quindi fai clic su Update Chatbot (Aggiorna chatbot). ChatLab esegue nuovamente la chiamata di prova e aggiorna la cache delle strutture.

Disconnessione - apri il riquadro Hostfully e fai clic su Disconnect (Disconnetti). Le azioni Hostfully non saranno più disponibili per il chatbot e i dati delle strutture memorizzati nella cache verranno eliminati. Le impostazioni restano salvate nel modulo, così potrai ricollegare l'integrazione in un secondo momento con un solo clic.

Suggerimenti

• Continua ad allenare il bot sui contenuti del tuo sito web. Le azioni Hostfully gestiscono strutture, date e prezzi; tutto il resto che un ospite potrebbe chiedere (orari di check-in, parcheggio, regole della casa, animali ammessi) proviene dalla tua knowledge base. Consulta Allenare il chatbot - nozioni di base e limiti.
• Inserisci regole di prenotazione come il soggiorno minimo o la politica sui depositi nelle istruzioni utente dell'azione, in modo che il chatbot le segnali insieme alla disponibilità senza lasciare che l'ospite lo scopra solo in un secondo momento.
• Aggiungi domande suggerite come "Verifica disponibilità" o "Mostra appartamenti" per far scoprire agli ospiti cosa può fare il chatbot.
• Una richiesta di prenotazione viene creata in Hostfully solo dopo che il chatbot ha raccolto nome, e-mail e telefono dell'ospite e questi ha confermato i dettagli. Se utilizzi anche un modulo di raccolta lead, mantieni coerenti i due strumenti per evitare di richiedere due volte le stesse informazioni. Consulta Lead collection.
• Ogni risposta che richiama un'azione Hostfully consuma crediti messaggio come qualsiasi altra risposta del chatbot. Consulta Cos'è un credito messaggio.

Articoli correlati

• Integrazione con Beds24
• Integrazione con Hotres
• Integrazione con IdoBooking
• Integrazione con KWHotel
• Integrazione con Mews
• Allenare il chatbot - nozioni di base e limiti
• Cos'è un credito messaggio

Catalogo camere e panoramica hotel

Se il tuo account mostra la scheda Hotel, utilizza Hotel > Rooms (Hotel > Camere) per verificare il catalogo camere e lo stato del training. L'azione AI room search è distinta dalle verifiche di disponibilità basate sulle date: cerca corrispondenze con le descrizioni delle strutture, mentre le azioni di disponibilità controllano il soggiorno richiesto. L'indicizzazione automatica delle strutture dipende dall'auto-indicizzazione del catalogo e dalla capacità camere assegnata; in caso contrario, utilizza Train rooms (Allena camere) quando disponibile. Rivedi le azioni abilitate e attendi il termine del training prima di affidarti ad AI room search.