Avatar
Identità dell assistente — nome, immagine, tono di voce, messaggi di benvenuto e fallback, orari e lingue.
L'avatar definisce come l'assistente si presenta all'utente: il nome, l'immagine, il modo di parlare e i messaggi che pronuncia nelle situazioni ricorrenti. È un'entità riutilizzabile: puoi assegnare lo stesso avatar a più progetti.
Prima di iniziare
- Ruolo con permesso identity:projects:write
- Immagine quadrata in formato PNG o SVG, minimo 256x256 pixel
Creare un avatar
Nome dell'assistente
Compare nell'intestazione del widget, nelle notifiche e nella firma dei messaggi.
Usa un nome breve, pronunciabile e coerente con il marchio, ad esempio Aura.
Evita nomi che possano far credere all'utente di parlare con una persona reale.
Immagine
Carica un file PNG o SVG quadrato, minimo 256x256 pixel, massimo 512 kB. Il ritaglio circolare è applicato automaticamente: lascia almeno 8 pixel di margine.
Tono di voce
Seleziona un preset oppure definisci un tono personalizzato.
Messaggi
Compila benvenuto, fallback e firma. Sono i testi che gli utenti leggono più spesso.
Orari e lingue
Imposta la disponibilità e le lingue supportate, poi seleziona Salva.
Campi dell'avatar
Configurazione avatar
| Parametro | Tipo | Obblig. | Default | Descrizione |
|---|---|---|---|---|
display_name | string | Sì | — | Nome mostrato nell intestazione del widget. Massimo 24 caratteri. |
avatar_url | string | No | — | URL pubblico dell immagine. Se assente si usa l iniziale del nome su fondo colorato. |
tone | string | Sì | — | Preset del tono di voce: formale, professionale, cordiale, informale. |
tone_instructions | string | No | — | Istruzioni aggiuntive sul registro linguistico, accodate al prompt di sistema. |
welcome_message | string | Sì | — | Primo messaggio mostrato all apertura della chat. |
welcome_variants | array | No | — | Varianti dinamiche selezionate in base a fascia oraria, pagina o utente riconosciuto. |
fallback_message | string | Sì | — | Messaggio usato quando l assistente non trova una risposta. |
signature | string | No | — | Firma accodata alle risposte, utile su email e WhatsApp. |
availability | object | No | — | Fasce orarie di presidio umano, per giorno della settimana. |
out_of_hours_message | string | No | — | Messaggio mostrato fuori dagli orari di presidio. |
languages | array | Sì | — | Lingue in cui l avatar può rispondere. La prima è la lingua predefinita. |
Tono di voce
| Preset | Registro | Esempio di risposta |
|---|---|---|
| Formale | Terza persona, nessuna contrazione | "La prenotazione è stata registrata correttamente." |
| Professionale | Seconda persona singolare, asciutto | "Ho registrato la tua prenotazione." |
| Cordiale | Seconda persona, calore misurato | "Perfetto, ho registrato la tua prenotazione." |
| Informale | Seconda persona, linguaggio colloquiale | "Fatto! La prenotazione è a posto." |
Puoi affinare il preset con istruzioni personalizzate.
Usa sempre il "tu". Frasi brevi, massimo 20 parole.
Non usare superlativi né esclamazioni. Non usare emoji.
Evita il gergo tecnico: al posto di "sinistro" scrivi "richiesta di risarcimento".
Quando comunichi una data, scrivila per esteso: "martedì 9 settembre alle 15:30".Coerenza con il prompt di sistema
Le istruzioni di tono vengono accodate al prompt del modello. Se il prompt di sistema contiene già regole sul registro, rimuovile da uno dei due punti per evitare conflitti. Vedi Modelli AI.
Messaggi di benvenuto
Il messaggio di benvenuto è il testo con il maggiore impatto sul tasso di ingaggio. Deve dire chi sei, cosa puoi fare e proporre un'azione.
Benvenuto statico
Ciao, sono Aura, l'assistente di Poliambulatorio Acme.
Posso aiutarti a prenotare una visita, controllare gli orari o spiegarti come prepararti a un esame.
Da cosa iniziamo?Ciao, sono Nico dell'assistenza Acme.
Posso seguire il tuo ordine, gestire un reso o aiutarti a scegliere la taglia giusta.
Come posso aiutarti?Buongiorno, sono l'assistente dello Studio Acme.
Posso fornirti informazioni sui servizi, sui documenti necessari e fissare un primo appuntamento.
Di cosa hai bisogno?Benvenuto dinamico
Le varianti sono valutate in ordine: viene usata la prima la cui condizione risulta vera.
| Condizione | Variabile disponibile | Esempio di messaggio |
|---|---|---|
| Fascia oraria mattutina | time_of_day | "Buongiorno! Sono Aura, come posso aiutarti?" |
| Fascia oraria serale | time_of_day | "Buonasera! Sono Aura, come posso aiutarti?" |
| Utente riconosciuto | user.name | "Bentornato Marco, vuoi controllare la tua prenotazione?" |
| Pagina di listino | page_url | "Vuoi sapere se una prestazione è coperta dalla tua assicurazione?" |
| Prima visita al sito | is_returning | "È la prima volta che ci scrivi: ti spiego cosa posso fare." |
| Carrello abbandonato | cart_value | "Vedo che hai lasciato degli articoli nel carrello: ti aiuto a completare?" |
Utente riconosciuto
Le variabili user.name e user.email sono valorizzate solo se l'integrazione
passa i dati dell'utente autenticato. Vedi
API JavaScript di BluBot.
Messaggi di fallback
Il fallback si attiva quando l'assistente non trova una risposta affidabile. Deve ammettere il limite, non ripetere la domanda e offrire un'alternativa concreta.
Su questo punto non ho un'informazione verificata e preferisco non darti una risposta approssimativa.
Posso metterti in contatto con la segreteria oppure farti richiamare: cosa preferisci?Mi occupo di prenotazioni, orari e informazioni sulle prestazioni di Poliambulatorio Acme.
Per questa richiesta ti conviene parlare direttamente con la segreteria: vuoi che la contatti io?Non sto riuscendo ad aiutarti come vorrei.
Passo la conversazione a un collega che ti risponde qui in chat: resta pure su questa pagina.| Tipo di fallback | Quando si attiva | Azione consigliata |
|---|---|---|
| Nessun risultato in knowledge base | Ricerca senza documenti rilevanti | Proponi handover |
| Argomento fuori ambito | Richiesta non prevista dal prompt | Riporta all'ambito e offri contatto |
| Strumento non disponibile | Endpoint in errore o timeout | Chiedi di riprovare o raccogli il recapito |
| Ripetizione | Due risposte consecutive non risolutive | Escalation automatica a operatore |
Firma
— Aura, assistente virtuale di Poliambulatorio Acme
Le risposte sono generate automaticamente. Per parlare con una persona scrivi "operatore".Trasparenza obbligatoria
Dichiarare la natura automatica dell'assistente è richiesto dal Regolamento europeo sull'intelligenza artificiale. Vedi Conformità.
Orari di disponibilità
Gli orari non spengono l'assistente: definiscono quando è possibile l'handover verso un operatore umano.
| Giorno | Presidio umano | Comportamento fuori orario |
|---|---|---|
| Lunedì – venerdì | 09:00 – 18:00 | Raccolta recapito e ticket |
| Sabato | 09:00 – 13:00 | Raccolta recapito e ticket |
| Domenica e festivi | Nessuno | Solo risposte automatiche |
Il fuso orario predefinito è Europe/Rome. I giorni festivi italiani sono riconosciuti
automaticamente; puoi aggiungere chiusure straordinarie dal calendario.
In questo momento la segreteria è chiusa. Riapriamo domani alle 9:00.
Posso comunque darti informazioni su orari, prestazioni e preparazione agli esami,
oppure raccogliere il tuo recapito e farti richiamare appena riapriamo.Lingue supportate
| Lingua | Codice | Rilevamento automatico | Note |
|---|---|---|---|
| Italiano | it | Sì | Lingua predefinita |
| Inglese | en | Sì | — |
| Francese | fr | Sì | — |
| Tedesco | de | Sì | — |
| Spagnolo | es | Sì | — |
| Arabo | ar | Sì | Interfaccia da destra a sinistra |
| Rumeno | ro | Sì | — |
Se il rilevamento automatico è attivo, l'assistente risponde nella lingua del messaggio
ricevuto. Puoi forzare la lingua dal widget con setLocale, descritto in
API JavaScript.
Messaggi tradotti
I messaggi di benvenuto, fallback e fuori orario non vengono tradotti automaticamente: inseriscili per ogni lingua abilitata nella scheda corrispondente.
Assegnare l'avatar a un progetto
Identificativo avatar
avt_2e9d5741bc634f80Usalo nel campo avatar_id delle API di progetto.
Passi successivi
- Progetti — collega avatar, modello e knowledge base.
- Personalizzazione del widget — allinea colori e font all'identità visiva.
- Flussi conversazionali — definisci i percorsi guidati.