Salta ai contenuti

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.

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.

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.

Se gestisci il tuo HTML, espandi Installa manualmente con il codice nella scheda Installa e:

  1. Copia lo snippet Widget.
  2. Apri il file HTML della pagina. Su un site builder usa invece l’impostazione per l’intero sito; vedi Site builder.
  3. 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.

Su Webflow, Wix, Squarespace, Hostinger e strumenti simili, aggiungi il Widget una sola volta tramite il codice per l’intero sito:

  1. Apri l’impostazione che aggiunge codice a tutte le pagine, solitamente Custom code, Code injection, Footer code o Body end.
  2. 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.
  3. 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:

BuilderImpostazione del codice globale
WebflowSite settings → Custom code → Footer code
WixSettings → Custom Code, poi All pages e Body - end. Richiede un dominio collegato.
SquarespaceCustom Code → Code Injection → Footer. Piani Core, Plus, Advanced e alcuni piani precedenti.
Hostinger Website BuilderMore (⋯) → 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.

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.

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.

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.

La scheda Installa raccoglie i controlli nella sezione espandibile Disponibilità e accesso. Aprila per trovare due impostazioni:

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.

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.

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.

Lo stile visivo è organizzato in Marchio, Size & Position, Tema e Altre impostazioni.

  • 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.

  • 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.

  • 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.

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.

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.

  1. 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).
  2. 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.
  3. 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.

Per Widget ed Incorporamento, Quickchat segue questo ordine:

  1. Un override esplicito nel loader: _quickchat("language", "de"), da chiamare prima di _quickchat("init", ...).
  2. L’attributo <html lang> della pagina: per esempio <html lang="de"> mostra la traduzione tedesca. È il metodo consigliato: imposta correttamente lang su ogni pagina localizzata e il widget si adatta automaticamente.
  3. 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.

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: Mike
  • customer_tier: VIP
  • order_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 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.

  1. 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.
  2. Apri il file HTML del sito o la pagina nel builder.

  3. Incolla il codice

    • Inserisci lo snippet Incorporamento nel <body> della pagina.
    • Posizionalo esattamente dove vuoi la chat. Il <div> controlla le dimensioni: adatta style="height:600px" allo spazio del layout.
    • Nel builder aggiungi un elemento codice o HTML nel punto desiderato e incolla lo snippet al suo interno.

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.

Ultimo aggiornamento: