Primi passi con l'Agent

Questa guida ti accompagna dalla creazione del primo Agent fino al momento in cui inizia a ricevere e gestire conversazioni reali dal tuo sito. Ogni passaggio spiega cosa fare e perché farlo, così puoi completare la configurazione senza domande aperte.

Il percorso completo richiede tipicamente dieci minuti per un Agent semplice (un sito B&B con FAQ) e trenta minuti per un Agent più articolato (un ristorante con menu completo o un hotel con servizi e camere).

Panoramica del percorso

Passaggio 1: Crea il tuo primo Agent

Accedi alla dashboard e clicca Nuovo Agent dalla sezione Agenti. Si apre una procedura guidata che ti chiede tre informazioni iniziali.

Nome dell'Agent

È il nome interno usato per identificare l'Agent nella dashboard. Per chi gestisce più strutture o più attività, il nome aiuta a distinguere tra Agent diversi (es. "Hotel Bellavista", "Ristorante Da Luigi", "Tour Guide Roma").

Il nome può essere cambiato in qualsiasi momento dalle impostazioni generali e non è visibile agli ospiti — quello che vedono è il titolo della chat, che configuri separatamente.

Tipo di Agent

La scelta del tipo è importante perché modifica il comportamento di base, la terminologia e le funzionalità attivate di default. Le tre opzioni sono:

• Sito web — profilo generico, adatto a qualsiasi attività che vuole un assistente per FAQ, raccolta contatti e gestione appuntamenti. È la scelta giusta per guide turistiche, fornitori di esperienze, studi professionali, attività commerciali.
• Ristorante — profilo per ristoranti, pizzerie, bar. Attiva di default il menu strutturato, la gestione allergeni, gli ordini al tavolo via QR code e la prenotazione tavolo.
• Struttura ricettiva — profilo per hotel, B&B, ville, agriturismi. Attiva di default i servizi per camera, il sistema di prenotazione, la raccolta documenti d'identità e l'integrazione con il Booking Engine.

Se non sei sicuro, scegli Sito web — è il profilo più flessibile e potrai sempre cambiare tipo in seguito. La scelta del tipo è descritta in dettaglio nelle guide dedicate: Sito web, Ristorante, Struttura ricettiva.

Lingua principale

Indica la lingua principale dei tuoi contenuti. L'Agent comunque comprende e risponde in 30+ lingue automaticamente — la lingua principale serve solo come default per l'interfaccia interna e per i contenuti che generi tu.

Passaggio 2: Conferma la creazione

Confermando si crea l'Agent e ti viene presentata la pagina di configurazione, organizzata in una serie di schede laterali: Impostazioni generali, Workflows, Servizi, Integrazioni, Moduli, Messaggi rapidi, Articoli, Design, Traduzioni, Privacy, Ospiti, Funzionalità Plus.

Per il primo setup ti interessano principalmente: Impostazioni generali, Addestramento (Articoli + Crawler + File), Design, Integrazione. Vedremo questi nei passaggi successivi.

Passaggio 3: Addestra l'Agent con i tuoi contenuti

L'Agent risponde basandosi esclusivamente sulle informazioni che gli fornisci. Hai tre canali per fornire contenuti, ciascuno utile per uno scopo diverso. Per il primo setup ti basta uno di questi tre — gli altri puoi aggiungerli in qualsiasi momento.

Opzione A: Crawler automatico dal sito (la più rapida)

Se hai già un sito web, questa è la via più veloce. Vai su Siti web dalla sidebar e inserisci l'URL del tuo sito. Il crawler scansiona automaticamente le pagine, indicizza i contenuti e li rende disponibili all'Agent. Tipicamente bastano 2-3 minuti per un sito vetrina di 5-10 pagine.

Il crawler funziona meglio se il sito è ben strutturato: pagine separate per camere/menu/servizi, testi in italiano chiaro, intestazioni semantiche. Per dettagli vedi Crawler del sito.

Opzione B: Upload di un PDF o di un documento Word

Se hai una brochure, un menu in PDF, un listino servizi o un manuale interno, puoi caricarli direttamente. Vai su File dalla sidebar e trascina i documenti. L'Agent estrae il testo, lo divide in passaggi semanticamente coerenti e lo usa per rispondere.

Formati supportati: PDF, DOCX, TXT, CSV, MD. Il limite per singolo file è generoso e adatto anche a brochure complete. Per dettagli vedi File e documenti.

Opzione C: Articoli scritti a mano

Se preferisci controllare esattamente cosa l'Agent sa, puoi scrivere articoli direttamente in dashboard. Ogni articolo è un blocco di conoscenza con titolo e contenuto (es. "Orari della reception", "Politica animali", "Come arrivare in struttura"). Vai su Articoli dalla sidebar dell'Agent e clicca Nuovo articolo.

Gli articoli sono particolarmente utili per informazioni che non sono nel sito ma che ricevi spesso dai clienti, e per correzioni puntuali a risposte dell'Agent. Per dettagli vedi Articoli.

Quale combinazione scegliere

Passaggio 4: Personalizza colori e messaggio di benvenuto

Vai sulla scheda Design della configurazione Agent. Qui personalizzi l'aspetto visivo della chat per integrarla con il tuo brand.

Messaggio di benvenuto

È il primo messaggio che l'utente vede quando apre la chat. Dovrebbe essere caloroso, breve e indicare cosa puoi fare per lui. Esempi efficaci:

• B&B: "Ciao, sono l'assistente di Casa del Sole. Puoi chiedermi orari, disponibilità o qualsiasi informazione sul soggiorno."
• Ristorante: "Benvenuto da Luigi, posso aiutarti con il menu, le prenotazioni e gli orari di apertura."
• Hotel: "Sono il concierge digitale dell'Hotel Bellavista. Posso aiutarti con informazioni, prenotazioni e richieste durante il tuo soggiorno."

Colori principali

I colori importanti da impostare per primi sono tre:

• Colore bolla — il pulsante circolare che apre la chat. Tipicamente coincide con il colore principale del brand.
• Colore header — la barra superiore della finestra di chat. Anche questo allineato al brand.
• Colore messaggi utente — i fumetti dei messaggi inviati dall'utente. Spesso lo stesso colore del brand per coerenza visiva.

I colori dei messaggi dell'Agent restano tipicamente in grigio chiaro o bianco con bordo per garantire leggibilità.

Logo

Carica il logo della tua attività in PNG o SVG (consigliato 200x200 pixel, sfondo trasparente). Appare nell'header della chat accanto al nome.

Per la guida completa vedi Design e personalizzazione.

Passaggio 5: Verifica le risposte in chat di prova

Prima di pubblicare l'Agent, è importante testarlo. Vai sulla scheda Chat o usa il pulsante Anteprima per aprire una conversazione di prova.

Cosa testare

Prova a fare le domande che ricevi tipicamente dai clienti reali:

• Per un hotel: "Quali sono gli orari di check-in?", "C'è il parcheggio?", "La colazione è inclusa?"
• Per un ristorante: "Qual è il piatto del giorno?", "Avete opzioni vegetariane?", "Siete aperti domenica sera?"
• Per una guida turistica: "Quanto dura il tour?", "Come prenoto?", "Quali lingue parlate?"

Se una risposta è incompleta o imprecisa, hai due opzioni:

1. Aggiungi un articolo con l'informazione corretta — l'Agent la userà nelle conversazioni successive
2. Modifica il prompt di sistema dalle impostazioni generali, dando un'istruzione specifica (es. "Quando ti chiedono dei parcheggi, specifica sempre che sono gratuiti per gli ospiti")

Test multilingua

Se ricevi clienti stranieri, prova le stesse domande in inglese, francese, tedesco o spagnolo. L'Agent rileva automaticamente la lingua e risponde nella stessa lingua, attingendo agli stessi contenuti.

Passaggio 6: Pubblica l'Agent sul sito

Quando sei soddisfatto delle risposte, è il momento di metterlo online. Vai sulla scheda Integrazione dalla sidebar dell'Agent.

Tre modi per pubblicare

Widget JavaScript — è la modalità più comune. Copia il codice (una sola riga) e incollalo nel tuo sito web. Funziona con WordPress, Wix, Squarespace, Shopify, siti custom. Il widget appare come bolla in basso a destra in ogni pagina.

Link condivisibile — l'Agent ha un URL pubblico (es. tuo-nome.hotely.ai) che puoi condividere via email, social, codici QR. Non richiede installazione su un sito.

iFrame — per incorporare la chat a tutta pagina su una sezione dedicata del sito. Adatto per pagine "Aiuto" o "Contatti" dove vuoi che la chat occupi tutto lo spazio.

Per la guida completa vedi Integrazione.

Verifica della pubblicazione

Dopo aver incollato il codice nel sito, ricarica una pagina del sito stesso. La bolla chat dovrebbe apparire entro pochi secondi. Cliccaci sopra: si apre la finestra di chat con il messaggio di benvenuto.

Fai una conversazione di prova dal sito vero, non solo dall'anteprima dashboard. Spesso piccole differenze (lingua del browser, dimensione schermo) emergono solo nell'integrazione reale.

Cosa fare nei giorni successivi

Una volta pubblicato l'Agent, la gestione quotidiana si concentra su poche attività ricorrenti:

Prossimi passi suggeriti

Quando il primo Agent è operativo, puoi attivare progressivamente funzionalità avanzate:

Ogni funzionalità è documentata in una pagina dedicata. Non sei obbligato ad attivare nulla: l'Agent funziona pienamente con la sola configurazione base.

Per qualsiasi dubbio, contatta il supporto a support@hotely.ai — risposta tipica in poche ore.