Distribuisci Quickchat AI sul sito come Widget mobile, Incorporamento nella pagina o Pagina chat ospitata. Installazione, accessi, aspetto, testi e parametri personalizzati.
Ci sono tre modi per portare il tuo AI Agent Quickchat sul web. Scegli la forma più adatta:
- Widget: la bolla di chat mobile nell’angolo del sito. Ideale per l’assistenza generale.
- Incorporamento: una finestra di chat integrata esattamente dove vuoi nella pagina. Ideale per una schermata dell’app, una pagina del centro assistenza o una scheda prodotto.
- Pagina chat: una chat a schermo intero ospitata da Quickchat, senza installazione o codice. Ideale per condividere un link, per esempio via email di supporto, Slack interno o con beta tester, senza intervenire sul loro browser.
Installa la forma scelta da Canali → Il tuo sito web → Installa. La pagina contiene tre sottoschede: Installa per scegliere come aggiungere l’Agent, Aspetto per lo stile visivo e Contenuto testuale per testi e etichette mostrati ai visitatori. Installa si apre con la scelta del metodo, mantiene disponibilità e accessi in una sezione dedicata e mostra uno Scenario ID copiabile per plugin e API.
Strumenti di configurazione facoltativi
Sezione intitolata “Strumenti di configurazione facoltativi”-
Confronta i metodi di distribuzione. Confronta i canali, l’accesso al sito e le funzionalità richieste che hai indicato con le opzioni Quickchat AI. Lo strumento non esamina il tuo sito o account.
-
Confronta HTML e Markdown di una pagina di esempio. Recupera HTML iniziale, contenuto Markdown e link agli strumenti da un esempio Quickchat AI predefinito. Non esegue JavaScript né esamina siti arbitrari.
Il Widget integra l’AI Agent direttamente nel sito, permettendo agli utenti di interagire facilmente con l’AI. Solitamente appare come una bolla nell’angolo in basso a destra. Facendo clic si apre una finestra in cui porre domande, ricevere assistenza o trovare informazioni.
Aggiungere il Widget al sito
Sezione intitolata “Aggiungere il Widget al sito”Apri Canali → Il tuo sito web → Installa. La scheda inizia con “Come vuoi aggiungere il tuo agente AI?” ed elenca i metodi partendo dal più semplice. Scegli quello per il tuo sito:
- WordPress: installa il plugin gratuito Quickchat AI Agent, incolla lo Scenario ID e il Widget compare automaticamente, senza modificare il tema.
- Shopify: aggiungi il Widget tramite il Theme Editor del negozio. Vedi la guida Shopify.
- Webflow, Wix e altri: copia uno snippet nell’impostazione di codice personalizzato per l’intero sito e applicalo a tutte le pagine. Non usare un elemento Incorporamento o HTML su una pagina. Vedi Site builder.
- Condividi invece un link: non installare nulla; condividi il link della Pagina chat ospitata.
- Installa manualmente con il codice: copia lo snippet Widget o Incorporamento e incollalo direttamente nell’HTML.
Ogni metodo apre un pannello con istruzioni mirate e solo il codice o l’ID necessario.
Lo Scenario ID è in cima alla scheda Installa, in un campo copiabile. È l’identificativo richiesto da plugin e API: copialo da qui quando richiesto dalla configurazione.
Installazione manuale con codice
Sezione intitolata “Installazione manuale con codice”Se gestisci il tuo HTML, espandi Installa manualmente con il codice nella scheda Installa e:
- Copia lo snippet Widget.
- Apri il file HTML della pagina. Su un site builder usa invece l’impostazione per l’intero sito; vedi Site builder.
- Incolla lo snippet subito prima del tag di chiusura
</body>in ogni pagina in cui vuoi il Widget.
Controlla uno snippet Widget rispetto allo Scenario ID fornito. Il controllo legge il codice incollato, senza recuperare il sito.
Site builder
Sezione intitolata “Site builder”Su Webflow, Wix, Squarespace, Hostinger e strumenti simili, aggiungi il Widget una sola volta tramite il codice per l’intero sito:
- Apri l’impostazione che aggiunge codice a tutte le pagine, solitamente Custom code, Code injection, Footer code o Body end.
- Incolla lo snippet e applicalo a tutte le pagine. Se puoi scegliere la posizione, usa il footer o la fine del body. Lo snippet non funziona nell’head.
- Pubblica il sito. La bolla di chat appare su ogni pagina.
Non aggiungere il Widget con un elemento Embed o HTML sulla pagina. Molti builder mostrano questi elementi in un piccolo frame separato, dove il Widget non può aprirsi. Anche se caricasse, apparirebbe solo su quella pagina.
Dove trovare l’impostazione per l’intero sito:
| Builder | Impostazione del codice globale |
|---|---|
| Webflow | Site settings → Custom code → Footer code |
| Wix | Settings → Custom Code, poi All pages e Body - end. Richiede un dominio collegato. |
| Squarespace | Custom Code → Code Injection → Footer. Piani Core, Plus, Advanced e alcuni piani precedenti. |
| Hostinger Website Builder | More (⋯) → Integrations → Custom code. Gli script vengono caricati automaticamente a fine pagina. |
I menu possono cambiare o essere tradotti nella lingua del builder. Se il builder o il piano non offre codice globale, condividi invece il link della Pagina chat.
Ti serve una mano?
Sezione intitolata “Ti serve una mano?”Non sei uno sviluppatore? La scheda Installa offre due scorciatoie sotto Ti serve una mano?:
- Chiedi aiuto all’AI: apre l’assistente nell’app con una domanda già compilata sull’aggiunta dell’Agent al sito.
- Invia istruzioni a uno sviluppatore via email: invia a un collega tutto il necessario, cioè snippet Widget, Scenario ID e link a questa guida, per installarlo al posto tuo.
Per altro aiuto, scrivi a contact@quickchat.ai.
Pagina chat
Sezione intitolata “Pagina chat”La Pagina chat è una versione ospitata, a schermo intero, dell’AI Agent su un URL Quickchat. Non richiede installazione: condividi il link e i visitatori possono chattare nel browser. Usala quando:
- Vuoi una chat ma non hai un sito o non vuoi modificarne il codice.
- Condividi l’AI con un piccolo gruppo, come beta tester, assistenza o potenziali clienti, e vuoi un link con accesso controllato anziché un widget pubblico.
- Vuoi inviare l’AI come canale di follow-up via email, Slack o CRM.
Configura chi può aprirla da Installa → Accesso alla pagina chat. Vedi Controllo degli accessi.
Iniziare una nuova conversazione
Sezione intitolata “Iniziare una nuova conversazione”Per ricominciare da zero:
- Widget o Incorporamento: Apri la chat e fai clic sul pulsante con la penna in un quadrato in alto a destra.
- Pagina chat: Seleziona New chat nella barra laterale o usa il pulsante con la penna nell’intestazione.
Si avvia una nuova conversazione con l’Agent. Quella precedente resta nell’Posta in arrivo. Chiudere e riaprire il Widget o ricaricare la pagina può riprendere la conversazione esistente. Chiedere all’AI di “resettare” o “cancellare la chat” non ne avvia una nuova. Non serve cancellare i cookie del browser.
Controllo degli accessi
Sezione intitolata “Controllo degli accessi”La scheda Installa raccoglie i controlli nella sezione espandibile Disponibilità e accesso. Aprila per trovare due impostazioni:
Accesso a Widget ed Incorporamento
Sezione intitolata “Accesso a Widget ed Incorporamento”L’interruttore in cima a Disponibilità e accesso. Se attivo, gli script Widget ed Incorporamento funzionano normalmente nei browser. Se disattivato, non sono disponibili sul sito anche se il codice è ancora presente. Utile per mettere temporaneamente offline l’AI senza rimuovere lo snippet o limitare l’accesso pubblico mantenendo la Pagina chat per gli invitati.
Accesso alla pagina chat
Sezione intitolata “Accesso alla pagina chat”Indipendentemente dall’interruttore Widget ed Incorporamento, puoi limitare l’accesso alla Pagina chat:
- Chiunque: URL pubblico, utilizzabile da chiunque abbia il link.
- Solo utenti invitati: Per usare la Pagina chat, le persone devono accedere e avere un ruolo su questo agente AI. Scegli Utente chat per chi deve solo conversare.
- Nessuno: Pagina chat completamente disattivata.
Il link Invita utenti della chat apre Impostazioni → Organizzazione → Membri del team. Seleziona Utente chat nel modulo di invito per concedere l’accesso alla Pagina chat senza accesso alla dashboard. Gli inviti richiedono un posto disponibile e il piano Basic precedente non consente di scegliere il ruolo. Consulta Membri del team e ruoli per i limiti dei piani.
Personalizzazione
Sezione intitolata “Personalizzazione”Le sottoschede Aspetto e Contenuto testuale personalizzano l’aspetto di Widget, Incorporamento e Pagina chat e i testi visibili. Le tre forme condividono le impostazioni: modificale una volta per applicarle ovunque l’Agent sia distribuito.
Il pannello destro di Installa/Aspetto/Contenuto testuale ha controlli di anteprima: passa fra Widget, Incorporamento e Pagina chat, e fra Desktop e Dispositivo mobile, per vedere le modifiche prima della pubblicazione.
Aspetto
Sezione intitolata “Aspetto”Lo stile visivo è organizzato in Marchio, Size & Position, Tema e Altre impostazioni.
Marchio
Sezione intitolata “Marchio”- Avatar dell’agente AI: foto profilo o logo dell’Agent, una sola immagine usata nell’intestazione e sul pulsante di avvio, fino a 5 MB. È un’impostazione unica: carichi una volta e l’immagine appare in entrambi i punti, sostituendo i vecchi “header logo” e “launcher icon” separati. Ogni Agent parte con un avatar predefinito. Ripristina predefiniti lo ripristina; eliminandolo non appare alcun avatar. Disponibile in tutti i piani, incluso Free.
Avatar dell’agente AI si applica a Widget, Incorporamento e Pagina chat, ma non a Discord, dove l’avatar proviene dall’app Discord del bot. Vedi Discord.
Size & Position
Sezione intitolata “Size & Position”- Dimensioni del pulsante di apertura: Classico, Solo campo di input o Piccolo. Controlla l’aspetto del pulsante prima di aprire la chat.
- Chiusura del launcher: Classico ha un piccolo pulsante di chiusura in alto a destra, visibile al passaggio del mouse su desktop e sempre visibile sui dispositivi touch. Nasconde il widget solo per la visualizzazione corrente; torna al caricamento successivo. Le altre dimensioni non hanno il pulsante.
- Etichetta del pulsante di apertura: appare solo con Piccolo. Testo personalizzato sul pulsante piccolo, fino a 25 caratteri, per esempio “Ask AI” o “Chat”. Lascialo vuoto per mostrare solo l’icona.
- Posizione del widget: in basso a sinistra, al centro o a destra.
- Dimensioni della finestra di chat: larghezza 300–700px e altezza 400–1200px.
- Pulsante di apertura trascinabile: consente ai visitatori di trascinare il pulsante in un altro punto, utile se copre contenuti importanti.
Scegli i colori della chat:
- Chiaro e Scuro sono preset fissi uguali per tutti gli account.
- Personalizzato offre una tavolozza completamente personalizzabile. Compaiono controlli per sfondo, intestazione e relativo testo, colore di accento usato per pulsante iniziale pre-chat, suggerimenti e valutazioni, bolle e testo dei messaggi, testo AI, colore dei link, campo di input, bordi e altro. Ogni colore viene controllato rispetto allo sfondo per il contrasto WCAG AA, con avvisi sulle combinazioni difficili da leggere.
I colori del brand per intestazione e accenti sono nel tema Personalizzato. Chiaro e Scuro restano preset neutri: passando dall’uno all’altro non si trasferiscono colori personalizzati.
Sotto Trasparenza, Sfondo determina quanto è trasparente la chat. Funziona con ogni tema, che fornisce la tinta:
- Tinta unita: sfondo pieno, impostazione predefinita.
- Vetro: finestra trasparente con il sito dietro sfocato, come vetro smerigliato. La tinta è bianca in Chiaro, scura in Scuro e corrisponde allo sfondo scelto in Personalizzato. In Personalizzato, un’intestazione di colore diverso conserva quel colore per mantenere il brand visibile. Opacità del vetro regola quanto la tinta copre la pagina, dal minimo che mantiene leggibile il testo su qualsiasi sito (50% in Chiaro, 65% in Scuro, in base ai colori in Personalizzato) fino al 95%. Se nessun livello rende leggibile il testo con i colori Personalizzato, il widget usa uno sfondo pieno e le impostazioni spiegano il motivo. Vetro resta selezionato e torna applicabile dopo aver corretto colori del testo o dello sfondo per ottenere contrasto sufficiente.
La trasparenza si applica a Widget, anche sui telefoni, ed Incorporamento. La Pagina chat a pagina intera ha sempre sfondo pieno. Chi attiva “Reduce transparency” sul dispositivo vede Tinta unita in Chrome ed Edge, i browser che comunicano questa preferenza ai siti. Se il browser non supporta la sfocatura, Vetro resta quasi pieno per mantenere il testo leggibile.
Con Personalizzato, la Pagina chat ha anche colori propri per la barra laterale: Sfondo della barra laterale, Testo della barra laterale, Sfondo della barra laterale al passaggio del mouse e Testo della barra laterale al passaggio del mouse. Valgono solo per la Pagina chat completa, non per Widget o Incorporamento. Lascia i colori del testo non impostati e verrà scelto automaticamente un colore leggibile sullo sfondo.
Puoi impostare anche il raggio degli angoli, che arrotonda bolle, campi e pulsanti, e la dimensione del testo. Entrambi valgono per ogni tema.
Altre impostazioni
Sezione intitolata “Altre impostazioni”- Input vocale: permette di registrare un messaggio vocale dal microfono nella chat. Viene trascritto nel campo di input per modificarlo prima dell’invio. La registrazione termina dopo due minuti; disponibile nei piani a pagamento.
- Allegati: permette di allegare immagini o documenti. Attivo per impostazione predefinita; disattivalo per rimuovere il pulsante allegati.
- Apertura automatica del widget: apre automaticamente il Widget al caricamento della pagina.
- Nascondi il marchio Quickchat AI: nasconde il footer “Powered by Quickchat AI” per un’esperienza completamente white-label, nei piani che includono questa funzione.
Per consentire la valutazione delle conversazioni, apri Conversazioni → Approfondimenti → Valutazione della conversazione. Impostazioni e risultati sono nella stessa scheda; vedi Valutazione delle conversazioni.
Contenuto testuale
Sezione intitolata “Contenuto testuale”Apri Canali → Il tuo sito web → Contenuto testuale per modificare il saluto e gli altri testi visibili:
- Testo dell’intestazione: testo in cima alla finestra di chat.
- Messaggio di benvenuto: primo messaggio dell’Agent a ogni conversazione, per esempio “Ciao, ti serve aiuto?”.
- Mostra come popup: mostra il benvenuto in una bolla accanto al launcher, spesso chiamata “teaser” o “launcher message”, per attirare l’attenzione prima del clic. La bolla usa proprio Messaggio di benvenuto, quindi modifica quel campo per cambiarne il testo.
- Spunti di conversazione: fino a 3 messaggi d’esempio prima che il visitatore scriva. Il clic invia il testo come primo messaggio, utile per indirizzare verso i punti di forza dell’AI, come “Come installo il widget?” o “Quali integrazioni supportate?”.
- Testo segnaposto: suggerimento nel campo messaggio vuoto.
- Testo di esclusione di responsabilità: testo dietro la conversazione, solitamente per informare che si sta parlando con un’AI. Consigliamo di mantenerlo chiaro e visibile.
La sezione Schermata iniziale della chat è sotto questi campi nella stessa scheda Contenuto testuale. Attivala lì e modifica intestazione, pulsante e messaggio.
Il Widget standard per siti web mostra in questa schermata un titolo, un messaggio e un pulsante di avvio. Non ci sono campi per email o telefono e non è possibile renderli obbligatori prima della chat. La raccolta intelligente dei dati può richiederli durante la conversazione. Per esigere i contatti prima di consentire la chat, serve un modulo separato sul sito o un’integrazione personalizzata.
Lingue e traduzioni
Sezione intitolata “Lingue e traduzioni”Per impostazione predefinita, tutti vedono Contenuto testuale esattamente come lo hai scritto. Nei piani a pagamento puoi aggiungere traduzioni per lingua, così i visitatori vedono il widget nella propria lingua.
- Apri Contenuto testuale e fai clic su Traduci in Altre lingue. Si apre Traduci testo del widget, con il testo principale accanto alle traduzioni come Predefinito (origine).
- Fai clic su Aggiungi lingua e scegli una lingua. Quickchat AI traduce il testo attuale. Controlla e modifica intestazione, benvenuto, spunti di conversazione, placeholder, schermata pre-chat e disclaimer. Le modifiche si salvano automaticamente.
- I campi lasciati vuoti usano il testo predefinito, così traduci solo ciò che vuoi cambiare. Se la traduzione automatica fallisce, puoi inserire il testo manualmente.
Il numero di lingue aggiungibili dipende dal piano.
Come viene scelta la lingua del visitatore
Sezione intitolata “Come viene scelta la lingua del visitatore”Per Widget ed Incorporamento, Quickchat segue questo ordine:
- Un override esplicito nel loader:
_quickchat("language", "de"), da chiamare prima di_quickchat("init", ...). - L’attributo
<html lang>della pagina: per esempio<html lang="de">mostra la traduzione tedesca. È il metodo consigliato: imposta correttamentelangsu ogni pagina localizzata e il widget si adatta automaticamente. - La lingua del browser, poi il testo Predefinito se non c’è corrispondenza.
Se manca una traduzione nella lingua del visitatore, viene sempre mostrato Predefinito. Nessun campo resta vuoto.
Funzioni avanzate: parametri personalizzati
Sezione intitolata “Funzioni avanzate: parametri personalizzati”Widget ed Incorporamento permettono di passare parametri personalizzati all’inizializzazione. Possono:
- migliorare le analisi, essendo disponibili nell’esportazione CSV della piattaforma
- fornire valori alle API Actions e, dove consentito, personalizzare le risposte. L’AI riceve solo un sottoinsieme filtrato; vedi Contesto del modello e autorizzazione
Esempi di parametri utili:
visitor_name:Mikecustomer_tier:VIPorder_id:ord_123
visitor_name è una chiave di contatto riconosciuta. Chiavi come customer_tier possono essere salvate e usate nelle Actions, ma inviarle non garantisce che l’AI le usi nelle risposte. Considera i valori del browser come input non verificati, non come autorizzazione ad accedere all’account di un cliente.
Per aggiungere questi parametri, includi quanto segue nello script trovato in Il tuo sito web > Installa.
Widget ed Incorporamento usano la stessa forma di chiamata:
_quickchat("custom_params", { "visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123",});Gli attributi vengono assegnati a ogni nuova conversazione; consigliamo di limitarsi a poche chiavi.
Parametri con nomi snake_case, come order_id o customer_tier, possono essere inseriti direttamente nelle API Actions come {{metadata_order_id}}, {{metadata_customer_tier}} e così via. Vedi Variabili AI Action.
Script di esempio:
widget
<script> (function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat"); _quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"}); _quickchat("init", "abcdefghij");</script>Incorporamento
<div id="quickchat-embedded" style="height:600px;overflow:hidden;"></div><script> (function(e,a,d,i,c,t=a.createElement(d)){e[c]=e[c]||function(){(e[c].q=e[c].q||[]).push(arguments)},t.src=i,t.async=1,a.body.insertAdjacentElement("beforeend",t)})(window,document,"script","https://bubble.quickchat.ai/chat.js","_quickchat"); _quickchat("containerId", "quickchat-embedded"); _quickchat("custom_params", {"visitor_name": "Mike", "customer_tier": "VIP", "order_id": "ord_123"}); _quickchat("init", "abcdefghij");</script>Incorporamento
Sezione intitolata “Incorporamento”Incorporamento posiziona l’AI Agent nella pagina come finestra di chat integrata, anziché come bolla mobile. Usalo per collocarla in un punto preciso, come una colonna del centro assistenza, una pagina contatti o una barra laterale nell’app.
Aggiungere l’Incorporamento
Sezione intitolata “Aggiungere l’Incorporamento”-
Recupera il codice Incorporamento
- Accedi alla Quickchat AI App.
- Vai in Canali → Il tuo sito web nella barra laterale sinistra.
- Apri Installa, poi espandi Installa manualmente con il codice.
- Copia lo snippet Incorporamento, che include contenitore
<div id="quickchat-embedded">e script di caricamento.
-
Apri il file HTML del sito o la pagina nel builder.
-
Incolla il codice
- Inserisci lo snippet Incorporamento nel
<body>della pagina. - Posizionalo esattamente dove vuoi la chat. Il
<div>controlla le dimensioni: adattastyle="height:600px"allo spazio del layout. - Nel builder aggiungi un elemento codice o HTML nel punto desiderato e incolla lo snippet al suo interno.
- Inserisci lo snippet Incorporamento nel
Incorporamento funziona solo se il builder inserisce il codice direttamente nella pagina. Alcuni, per esempio Wix, mostrano gli elementi HTML in un frame separato, dove Incorporamento non può caricarsi. Se la chat non appare nella pagina pubblicata, aggiungi il Widget con il codice globale o condividi la Pagina chat.