Collega il tuo chatbot ChatLab al tuo sistema di prenotazione IdoBooking per fornire ai visitatori del tuo sito web informazioni sulla disponibilità in tempo reale e assistenza per le prenotazioni.
Conversazione di esempio
Dalle date del viaggio alle offerte per le camere
Richiede un'integrazione per strutture ricettive supportata e l'azione di disponibilità attivata. Un'offerta o una richiesta non confermano una prenotazione.
Visitatore: Una camera per due adulti, dal 14 al 16 agosto.
Riproduci l'esempio o leggilo qui sotto. Non viene utilizzato alcun dato reale dei clienti.Raccogli le preferenze di soggiorno.
La riproduzione va in pausa quando questo esempio esce dallo schermo. Questa è una simulazione, non una chat dal vivo. I comandi del widget all'interno della riproduzione non sono interattivi.Leggi l'esempio completo
- Raccogli le preferenze di soggiorno.
Visitatore: Una camera per due adulti, dal 14 al 16 agosto.
- Chiedi i dettagli mancanti sulle date prima di effettuare la ricerca.
Assistente: In quale anno vorresti soggiornare?
- L'ospite indica l'anno.
Visitatore: 2027.
- Interroga il sistema gestionale collegato.
Verifico la disponibilità delle camere...
- Mostra le offerte disponibili per quel soggiorno.
Doppia vista mare, €280 / stay. Offerta di esempio per due adulti, due notti.
- Continua usando il percorso di prenotazione supportato dalla tua integrazione.
Assistente: Verifica il prezzo finale e le condizioni nella pagina di prenotazione. Nessuna prenotazione è stata effettuata in questa dimostrazione.
L'esempio illustra l'esperienza del cliente. Le azioni disponibili e le informazioni restituite dipendono da questa integrazione e dalla tua configurazione.
Prima di iniziare
Per prima cosa crea o seleziona un chatbot. Devi disporre dell'autorizzazione per gestire le sue integrazioni e dell'accesso alle impostazioni di connessione dell'account esterno. Se il riquadro Connect mostra un invito all'upgrade o al contatto, verifica che il tuo abbonamento includa questa integrazione. Mantieni private le credenziali API; non incollarle mai nel codice di incorporamento del sito web.
Cosa offre l'integrazione
Con l'integrazione IdoBooking abilitata, il tuo chatbot può:
- Elencare appartamenti e alloggi disponibili con descrizioni e foto
- Verificare la disponibilità per date specifiche
- Trovare appartamenti disponibili per un determinato intervallo di date con i relativi prezzi
- Cercare prenotazioni esistenti tramite ID, stato o intervallo di date
- Creare nuove prenotazioni con i dettagli degli ospiti
Esistono due modi per configurare questa integrazione - tramite l'IdoBooking Marketplace (consigliato) oppure manualmente tramite il pannello di amministrazione di ChatLab.
Opzione A: configurazione tramite IdoBooking Marketplace (consigliata)
Il modo più rapido per collegare ChatLab a IdoBooking è tramite l'IdoBooking Marketplace. Questo metodo gestisce automaticamente le credenziali API e abilita le azioni di lettura per il tuo chatbot.
Passaggio 1: installa ChatLab dall'IdoBooking Marketplace
- Accedi al tuo pannello di amministrazione di IdoBooking
- Vai alla sezione Marketplace
- Cerca ChatLab e fai clic su Install (Installa)
IdoBooking invia automaticamente le tue credenziali API a ChatLab - non è necessario creare un utente API separato o copiare le credenziali manualmente.
Passaggio 2: crea o accedi al tuo account ChatLab
Dopo aver attivato ChatLab nel marketplace, verrai reindirizzato a una procedura guidata di configurazione. Se hai già un account ChatLab, accedi. Altrimenti, crea un nuovo account.
Passaggio 3: scegli un piano di abbonamento
Seleziona un piano di abbonamento adatto alle tue esigenze. Le funzioni di integrazione delle prenotazioni di IdoBooking (ricerca di appartamenti, verifica della disponibilità, prenotazioni) richiedono la funzionalità di integrazione IdoBooking. Se il tuo abbonamento non la include, segui l'avviso di upgrade o di contatto.
Passaggio 4: seleziona un chatbot
Scegli un chatbot esistente da collegare a IdoBooking oppure creane uno nuovo. La procedura guidata può creare un nuovo bot per te automaticamente.
Passaggio 5: completa la configurazione
La procedura guidata esegue automaticamente le seguenti operazioni:
- Collega le tue credenziali IdoBooking al chatbot selezionato
- Abilita la ricerca di appartamenti, le verifiche della disponibilità e la ricerca di prenotazioni. La creazione di prenotazioni non viene abilitata automaticamente.
- Ti reindirizza a IdoBooking o al pannello di amministrazione di ChatLab
Dopo aver completato la procedura guidata, il tuo chatbot è pronto per gestire le richieste di prenotazione. Puoi perfezionare le singole azioni IA in Settings > Actions (Impostazioni > Azioni).
Opzione B: configurazione manuale
Se preferisci configurare l'integrazione manualmente, segui questi passaggi.
Parte 1: creazione di un utente API in IdoBooking
Prima di collegare ChatLab al tuo sistema IdoBooking, devi creare un utente dedicato con accesso API nel tuo pannello IdoBooking.
Passaggio 1: accedi a User Management
- Accedi al tuo pannello di amministrazione di IdoBooking
- Vai a Settings > Users (Impostazioni > Utenti)
- Fai clic su Add new user (Aggiungi nuovo utente)
Passaggio 2: crea l'account utente
- Inserisci un login name per il nuovo utente (ad es., "chatlab-api")
- Compila le restanti informazioni richieste
- Imposta una password sicura per questo account
Passaggio 3: configura l'accesso API
Configura le seguenti impostazioni di accesso per il nuovo utente:
- Abilita "Active API access" - questo è necessario per il funzionamento dell'integrazione
- Disabilita "Active panel access" - l'utente non ha bisogno di accedere al pannello di amministrazione
Passaggio 4: imposta il ruolo utente e le autorizzazioni
Hai due opzioni per configurare il ruolo utente:
Opzione A: ruolo Administrator (più semplice)
- Seleziona Administrator come ruolo
- Questo concede ampie autorizzazioni API anche quando l'accesso al pannello è disabilitato. Usa un ruolo personalizzato se l'integrazione necessita solo di operazioni di lettura selezionate.
Opzione B: ruolo Custom user (più granulare)
Se preferisci un controllo più dettagliato, seleziona Custom user e configura le seguenti autorizzazioni per i moduli:
- Reservations - Read-only (se il chatbot deve solo recuperare informazioni sulle prenotazioni) o Full access (se il chatbot creerà prenotazioni)
- Customers - Read-only
- Offers - Read-only
Per gli utenti personalizzati, devi configurare anche le autorizzazioni relative alla sede:
- Scorri fino alla sezione Location and accommodation permissions
- Seleziona le strutture che questo chatbot deve coprire; concedi l'accesso a tutte solo se questo è l'ambito desiderato.
Passaggio 5: disabilita le notifiche non necessarie
Per evitare che l'utente API riceva notifiche operative, disabilita le seguenti opzioni:
- Notifications for property staff - Disabilita
- Automatic email notifications - Disabilita
Passaggio 6: salva e raccogli i dettagli di connessione
- Fai clic su Save (Salva) per creare l'account utente
- Annota le seguenti informazioni - ti serviranno per la configurazione di ChatLab:
- Login - Il nome utente che hai creato (ad es., chatlab-api)
- Password - La password che hai impostato
- Subdomain - Il tuo sottodominio IdoBooking (ad es., client3760)
Come trovare il tuo sottodominio: controlla l'URL del tuo pannello IdoBooking. Ad esempio, se il tuo URL è https://client3760.idosell.com, il tuo sottodominio è client3760.
Parte 2: configurazione dell'integrazione in ChatLab
Passaggio 1: vai alla scheda Connect
- Accedi al tuo pannello di amministrazione di ChatLab
- Seleziona il bot che desideri configurare
- Vai alla scheda Connect (Connetti)
- Trova e fai clic su IdoBooking nell'elenco delle integrazioni
Passaggio 2: inserisci i dettagli di connessione
Compila il modulo di connessione con le informazioni raccolte da IdoBooking:
- Client Subdomain - Inserisci il tuo sottodominio IdoBooking (senza l'URL completo). Esempio:
client3760(nonhttps://client3760.idosell.com) - System Login - Inserisci il nome utente dell'utente API creato in IdoBooking
- System Password - Inserisci la password per l'utente API
- Default Currency - Seleziona la valuta per le informazioni sui prezzi
- Default Language - Seleziona la lingua per le descrizioni delle strutture
Passaggio 3: connetti
- Dopo aver compilato tutti i campi obbligatori, il pulsante Connect diventa attivo
- Fai clic su Connect per stabilire la connessione
- Attendi il messaggio di conferma
- Una volta stabilita la connessione, visualizzerai una notifica di avvenuto successo
Dopo aver effettuato correttamente la connessione, il pulsante cambia da "Connect" a "Update Chatbot", e compare un pulsante "Disconnect" nel caso in cui tu debba disabilitare l'integrazione in un secondo momento.
Configurazione delle azioni IA
Una volta collegata l'integrazione IdoBooking (con uno dei due metodi), puoi configurare quali azioni IA può eseguire il tuo chatbot. Rivedi le azioni attive dopo qualsiasi metodo di configurazione. La creazione di prenotazioni non viene abilitata automaticamente.
Azioni IA disponibili
- Get Apartments - Elenca gli appartamenti e gli alloggi disponibili con descrizioni, configurazione dei letti e foto
- Find Available Apartments - Cerca appartamenti disponibili per un determinato intervallo di date con informazioni sui prezzi
- Check Apartment Availability - Verifica la disponibilità per un appartamento e un intervallo di date specifici
- Get Reservations - Cerca prenotazioni esistenti per ID, stato o intervallo di date
- Create Reservation - Crea nuove prenotazioni con i dettagli dell'ospite e le informazioni di prenotazione
- AI room search - Trova le corrispondenze tra la richiesta dell'ospite e le descrizioni delle tue camere, anziché verificare le date
AI room search e Get Apartments sono alternative, non complementari. Quando AI room search è attiva, sostituisce lo strumento di elenco standard e Get Apartments viene ritirata dal chatbot, in modo che sia sempre attivo un solo strumento per elencare le camere. Le azioni basate sulle date restano inalterate.
Abilitazione e personalizzazione delle azioni
- Dopo la connessione, fai clic su Configure AI Actions nella finestra modale di conferma, oppure vai a Settings > Actions e trova la categoria IdoBooking
- Attiva o disattiva le azioni che desideri abilitare
- Personalizza l'etichetta dell'azione (il testo mostrato agli utenti mentre l'azione è in corso) e le istruzioni secondo necessità
- Nella finestra di dialogo dell'azione, fai clic su Enable (Abilita) per una nuova azione o su Update (Aggiorna) per un'azione esistente.
Configurazione di "Find available apartments"
L'azione Find available apartments include due controlli aggiuntivi che determinano quanti appartamenti il chatbot mostra quando un ospite chiede informazioni sulla disponibilità e quali appartamenti vengono selezionati. Apri l'azione da Settings > Actions > IdoBooking - find available apartments per accedervi.
Number of offers to show
Uno slider che varia da 3 a 10 (valore predefinito 6). Controlla quanti appartamenti il chatbot restituisce all'utente in una singola risposta.
- Valori più bassi (3-4) mantengono la risposta breve e mirata, utile quando la maggior parte degli ospiti sceglie tra poche opzioni preferite.
- Valori più alti (8-10) offrono agli ospiti una maggiore varietà da confrontare, utile per strutture con un catalogo più ampio.
Offer selection strategy
Un menu a discesa che stabilisce quali appartamenti vengono scelti dall'elenco completo dei risultati disponibili dopo aver applicato i filtri per data e numero di ospiti. Sono disponibili quattro opzioni:
- Cheapest offers (predefinito) - restituisce gli appartamenti con il prezzo minimo più basso, ordinati dal più economico al più costoso. Utile quando gli ospiti sono attenti al prezzo o quando desideri proporre per prime le opzioni più accessibili.
- Evenly distributed by price - seleziona appartamenti distribuiti uniformemente lungo l'intervallo di prezzo. Ad esempio, con 9 offerte restituisce circa 3 opzioni economiche, 3 di fascia media e 3 più costose. Utile quando vuoi che gli ospiti visualizzino l'intera gamma disponibile anziché solo le soluzioni più economiche.
- Most expensive offers - restituisce gli appartamenti con il prezzo più alto, ordinati dal più costoso al più economico. Indicato per strutture di livello superiore o quando desideri dare risalto alle sistemazioni di fascia più alta.
- Random selection - seleziona appartamenti in modo casuale tra i risultati filtrati. Utile quando vuoi variare gli appartamenti messi in risalto tra una conversazione e l'altra ed evitare di consigliare sempre le stesse sistemazioni.
Entrambe le impostazioni vengono salvate per singolo bot, insieme al prompt personalizzato e all'etichetta dell'azione esistenti.
Testa la configurazione completata
Apri Overview (Panoramica) e avvia una nuova conversazione di prova. Chiedi informazioni sulle camere per un intervallo di date futuro e per un numero specifico di ospiti, quindi apri il link di prenotazione restituito e confronta date, valuta e prezzo con IdoBooking. Esegui un test di ricerca delle prenotazioni utilizzando una prenotazione che sei autorizzato a visualizzare. Abilita e testa Create Reservation solo se intendi effettuare una prenotazione reale; un test in chat può scrivere direttamente nel tuo sistema di prenotazione.
Buone pratiche
Raccomandazioni di sicurezza (configurazione manuale)
- Usa un utente API dedicato - Crea un utente separato specifico per l'integrazione con ChatLab anziché usare il tuo account amministratore personale
- Autorizzazioni minime - Concedi solo le autorizzazioni necessarie per il tuo caso d'uso. Usa l'accesso in sola lettura se il chatbot deve soltanto recuperare informazioni
- Rotazione periodica delle credenziali - Aggiorna periodicamente la password dell'utente API, quindi aggiorna le credenziali in ChatLab
Ottimizzare le risposte del chatbot
- Allena il tuo bot con le informazioni sulla struttura - Aggiungi le descrizioni dei tuoi alloggi alla knowledge base, inclusi servizi, caratteristiche delle camere e dettagli sulla posizione
- Imposta flussi di conversazione chiari - Configura messaggi di benvenuto che guidino gli utenti a chiedere informazioni sulla disponibilità, e usa domande suggerite come "Verifica disponibilità" o "Visualizza camere"
Risoluzione dei problemi
- Connessione non riuscita - Verifica che l'opzione "Active API access" sia abilitata per l'utente in IdoBooking
- Errori "Access denied" - Controlla che l'utente disponga delle autorizzazioni corrette per i moduli
- Nessun dato restituito - Assicurati che l'utente abbia accesso alle sedi e alle strutture pertinenti
- Sottodominio errato - Verifica l'URL di IdoBooking ed estrai solo la parte del sottodominio (ad es.,
client3760dahttps://client3760.idosell.com)
Catalogo camere e panoramica hotel
Se il tuo account mostra la scheda Hotel, usa Hotel > Rooms per verificare il catalogo camere e lo stato dell'allenamento. AI room search è separata dalle verifiche di disponibilità basate sulle date: cerca le corrispondenze con le descrizioni delle camere, mentre le azioni di disponibilità verificano un soggiorno richiesto. L'indicizzazione automatica delle camere dipende dall'autoindicizzazione del catalogo e dalla quota di camere assegnata al catalogo; in caso contrario, usa Train rooms (Allena camere) quando disponibile. Rivedi le azioni abilitate e attendi il completamento dell'allenamento prima di affidarti ad AI room search.