What's my plan?
Add-on AI agents - Advanced
Questo articolo descrive le funzionalità legacy e deve essere usato solo dai clienti che hanno già installato Ultimate Chat Widget e necessitano di informazioni sulla sua manutenzione. I nuovi clienti dovrebbero invece implementare gli agenti AI tramite il Web Widget .

Con solo pochi minuti del tuo tempo, il Widget Chat Ultimate può essere installato e funzionante sul tuo sito web. Sarai in grado di fornire assistenza clienti di prim’ordine in pochissimo tempo. Il widget è altamente personalizzabile per adattarsi all’aspetto unico del tuo brand ed è progettato per prestazioni ottimali: le sue dimensioni compatte non rallentano i tempi di caricamento della pagina.

In questo articolo vengono trattati i seguenti argomenti:

  • Incorporamento del widget
  • Caricamento del widget
  • Acquisizione Metadata
  • Cronologia conversazioni
  • Internazionalizzazione e localizzazione
  • Configurazione delle risposte generative
  • Notifiche
  • Metodi
  • Moduli
  • Localizzazione
  • Privacy dei dati
  • DOMANDE FREQUENTI

Piattaforme supportate:

  • Desktop
  • Mobile (web)

Tipi di contenuti supportati:

  • Messaggi di testo, inclusa la formattazione HTML
  • Risposte generative
  • Pulsanti
  • Schede e sequenze
  • link
  • assistenza per immagini e GIF

Escalation

  • Escalation email
  • Creazione ticket (richiede una semplice integrazione API)

Incorporamento del widget

Per aggiungere il widget, incorpora lo script nel tuo sito web o tramite un gestore di tag.

Assicurati di sostituire botID con il tuo identificatore univoco agenti AI . Trova il tuo botID nell’URL: https://dashboard.ultimate.ai/bot/{botID}/ o https://dashboard.ultimate.ai/ultimategpt/{botID}.

Script di incorporamento - nel file HTML

Lo script deve essere inserito prima di chiudere il tag body: </body>

<script type="module"> import UltimateChat from 'https://widget.ultimate.ai/sdk/index.mjs'; const chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID_HERE', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: 'I\'m an AI agent and here to answer your questions.' }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); </script>

Script di incorporamento - Tag Manager (servizi GTM o simili) 

<script> function _onUltimateChatLoad() { var chat = UltimateChat.Initialize({ botId: 'YOUR_BOT_ID', theme: {

'actions-hover': '#4A48B0',

'actions': '#5D5ADC',

'header-text': '#ECECF9',

'chat-button': '#15142d',

'chat-border-radius': 12px,

'header': '#000'

}, navbar: { avatarUrl: 'https://www.ultimate.ai/hubfs/raw_assets/public/ultimate/favicon/apple-touch-icon-152x152.png', title: 'Ultimate.ai', subtitle: 'Our bot will reply instantly', longSubtitle: "I'm an AI agent and here to answer your questions." }, recoverConversation: true, metadata: [ { key: 'name', value: 'John Doe' }, { key: 'email', value: 'john@ultimate.ai', sanitize: true } ] }); } </script> <script> (function () { var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true; s.src = 'https://widget.ultimate.ai/sdk/index.iife.js'; s.onload = _onUltimateChatLoad; var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x); })(); </script>

Personalizzazioni di stile

All’interno dello script del widget, sono disponibili varie opzioni di colori che puoi adattare al tema del widget.

theme: { 
'actions-hover': '#4A48B0', 
'actions': '#5D5ADC', 
'header-text': '#ECECF9', 
'chat-button': '#15142d', 
'chat-border-radius': 12px, 
'header': '#000' 
},

Specifiche asset:

Avatar - 172 x 172 px

Caricamento del widget

Aperto al caricamento

Questa opzione di configurazione controlla il comportamento del widget al caricamento. Quando è impostato su true, il widget si apre automaticamente non appena viene caricato completamente. Per impostazione predefinita, questa opzione è impostata su false il che significa che il widget di chat rimane chiuso fino a quando non viene aperto manualmente dall’utente.

L’apertura del widget sarà possibile solo a livello di codice (consulta Metodi - Apri widget) o tramite il openOnLoad opzione di configurazione. Per impostazione predefinita, questa opzione è impostata su false.

 

Pulsante Mostra/Nascondi widget

Questa opzione di configurazione controlla la visibilità del “pulsante di benvenuto” del widget. Quando è impostato su true, il pulsante non viene visualizzato durante il caricamento iniziale e dopo la chiusura del widget.

 

Posizione chat

Questa configurazione ti consente di controllare dove visualizzare il widget di chat sullo schermo. Puoi impostarlo su Bottom-right o Bottom-lefta seconda di dove si adatta meglio al tuo brand. Se non è definito, il widget sarà impostato su Bottom-right.

Acquisizione Metadata

I Metadata sono dati che forniscono un contesto aggiuntivo per l’ agenti AI. I Metadata possono essere usati per arricchire una chat fornendo informazioni aggiuntive sul cliente, sul suo comportamento e sulle sue precedenti interazioni con l’azienda.

Sfruttando i metadati, gli agenti AI possono fornire ai clienti un’esperienza più personalizzata ed efficiente, il che può portare a una maggiore soddisfazione e fidelizzazione dei clienti. Inoltre, i metadati possono aiutare i team assistenza ad analizzare e migliorare i propri processi assistenza nel tempo.

In qualsiasi momento, un sito web può impostare e aggiornare i metadati disponibili durante la conversazione.

A tale scopo, aggiungi al codice del widget i valori che desideri raccogliere.

Se desideri utilizzare questa funzionalità, possiamo consigliarti su come adattare il codice del widget.

Esempi di casi d’uso:

Informazioni cliente: I Metadata possono fornire informazioni sul cliente, come nome, indirizzo email, numero di telefono, ubicazione e altri dettagli. Queste informazioni possono aiutare l’ agenti AI a personalizzare la conversazione e fornire assistenza più pertinente.

Cronologia acquisti: Se il cliente ha effettuato acquisti precedenti dall'azienda, i metadati possono fornire informazioni sulla cronologia degli acquisti, come i prodotti che ha acquistato, la data di acquisto e il prezzo pagato. Queste informazioni possono aiutare l’ agenti AI a comprendere le esigenze del cliente e fornire assistenza mirata.

Cronologia interazioni: I Metadata possono anche fornire informazioni sulle precedenti interazioni del cliente con l’azienda, come chat, email o telefonate precedenti. Queste informazioni possono aiutare l’ agenti AI a comprendere il contesto della conversazione attuale e fornire un’esperienza più fluida al cliente.

Informazioni sul dispositivo: I Metadata possono fornire informazioni sul dispositivo usato dal cliente per chattare, come il tipo di dispositivo, il sistema operativo e il browser. Queste informazioni possono aiutare l’ agenti AI a risolvere i problemi tecnici e fornire assistenza più mirata.

Metadata

Per fornire ulteriore contesto per l’uso agenti AI :

setMetadata(Array<{
key: string;
value: string;
sanitize: boolean;
}> metadata)

Se sanitize è impostato su true il valore non sarà disponibile nei registri delle conversazioni, viene visualizzato con un segnaposto

Esempio:

            setTimeout(() => {
                chat.setMetadata([
                    { key: 'orderName', value: 'Jane Doe' },
                    { key: 'orderEmail', value: 'jane@ultimate.ai', sanitize: true }
                ]);
            }, 2000);

Raccolta automatica dei metadati

Ultimate Chat Widget può raccogliere automaticamente i metadati relativi al dispositivo dell’utente.

Come configurarlo?

Questa funzionalità è attiva per impostazione predefinita.

Puoi disattivarlo impostandoautoMetadataCollection a false

Dettagli dei metadati raccolti.

Questa funzionalità funziona in base alla configurazione del dispositivo e non richiede cookie e IP utente per funzionare correttamente.

Metadata Descrizione
Lingua {{systemLanguage}}

La lingua predefinita di un dispositivo utente.

es. en-GB, en-US

Puoi trovare un elenco completo dei codici lingua qui.

(Uso di BCP 47 standard)
Fuso orario {{systemTimezone}}

Il fuso orario/regione in cui si trova l’utente.

es. Europe/Berlin,

Un elenco completo dei fusi orari è disponibile qui nella colonna ID zona.
Tipo di dispositivo {{deviceName}}

Il tipo di dispositivo usato da un utente. I dispositivi che stiamo rilevando sono:

Dispositivi mobili: iPad, iPhone, Android, Windows Phone

Dispositivi desktop: Mac, Windows, Linux

URL iniziale

{{url}}

L’URL della pagina in cui l’utente ha aperto il widget.

es. https://www.google.com
Nome browser {{browserName}}

Il nome del browser dell’utente.

es. Chrome, Firefox, Opera, etc
Versione browser {{browserVersion}}

La versione del browser dell’utente.

es. 111, 113 etc

 

Cronologia conversazioni

Ogni conversazione con il widget viene memorizzata direttamente nei registri delle conversazioni.

Per una conversazione fluida, ti suggeriamo di abilitare la cronologia chat. Ciò consente agli utenti di riprendere da dove avevano interrotto, anche dopo aver ricaricato la pagina o aver riaperto la scheda del browser.

A tal fine, utilizziamo la memoria locale del browser per salvare l’ID conversazione. In questo modo, possiamo recuperare i dati della conversazione quando necessario.

Attivazione

Per recuperare la modifica della conversazione precedente recoverConversationparametro a true.

Disattivazione

Quando disattivi la cronologia delle conversazioni (modifica recoverConversation parametro a false), il lastReadMessageId_{botId} e platformConversationId_{botId} vengono rimossi dalla memoria locale (LS) del browser dell’utente. Ulteriori dettagli sull’uso della memoria locale sono disponibili qui.

recoverConversation was previously named isConversationPersistanceEnabled

 

Configurazione delle risposte generative

Etichetta risposta AI

D’ora in poi, ogni risposta generata AI visualizzerà un’etichetta sopra di essa. Ciò significa che gli utenti possono distinguere facilmente tra i contenuti generati AI e altri input di messaggi. È un passo avanti per rendere l’esperienza utente più chiara e informata, tenendolo informato sulla natura del contenuto con cui interagisce.

Configurazione:

Mostra/Nascondi icona info messageGeneratedAdditionalInfo (predefinito false)

Origini dei messaggi

Ogni risposta generata AI ora mostrerà le origini delle informazioni, consentendoti di risalire alle origini della risposta. Ciò non solo favorisce la credibilità, ma consente anche agli utenti di approfondire l’argomento con riferimenti credibili a portata di mano.

Configurazione:

Mostra/nascondi le origini AI usando il parametro showLlmSources (predefinito true)

Notifiche

Notifiche visive

Queste notifiche fungono da rappresentazione visiva dei messaggi in ingresso. Ogni volta che il widget viene chiuso o ridotto a icona e viene ricevuto un nuovo messaggio, una notifica rossa mostrerà il numero di messaggi ricevuti ma non aperti. 

Notifica sonora

Le notifiche sonore fungono da avvisi sonori che migliorano la consapevolezza degli utenti e vengono attivate nelle seguenti condizioni:
  1. Escalation agente: Quando un agente si unisce a una richiesta di escalation.
  2. Avviso scheda in background: Quando arriva un messaggio mentre l’utente sta visualizzando un’altra scheda del browser.
  3. Avviso widget ridotto a icona: Quando arriva un nuovo messaggio e il widget viene ridotto a icona.
Opzioni di configurazione
Abilitazione/disabilitazione delle notifiche sonoreI client possono configurare lo stato predefinito delle notifiche sonore usando allowSoundNotifications opzione nello script del widget:
  • Per abilitare le notifiche sonore per impostazione predefinita, imposta allowSoundNotifications a true.
  • Per disabilitare le notifiche sonore per impostazione predefinita, imposta allowSoundNotifications a false.
Una volta configurate, gli utenti conservano la possibilità di attivare o disattivare manualmente le notifiche sonore in base alle loro preferenze.

Apri/chiudi il widget

Puoi controllare facilmente il widget da qualsiasi punto del tuo sito web usando questi semplici comandi:

  • Per mostrare il widget openWidget()
  • Per nascondere il widget closeWidget()

Rimuovi widget

Esempio di caso d’uso:

Fornisci l’accesso al widget solo agli utenti che hanno effettuato l’accesso e assicurati che il widget venga chiuso dopo la disconnessione di un utente.

Implementazione:

Chiama un metodo destroy()

Comportamento:

  • Rimuove l’iframe del widget di chat dal DOM (Document Object Model)

  • Disconnetti la connessione WebSocket

 

Moduli 

I messaggi con modulo sono un tipo di messaggio strutturato che consente di acquisire i dati degli utenti in una conversazione in corso visualizzando un modulo che può contenere input di testo e selezionare menu a discesa. 

Uso di moduli con agenti AI - Avanzati

I moduli sono un ottimo modo per raccogliere i dati dei clienti senza che l’ agenti AI faccia più domande. I casi d'uso tipici includono sicurezza, domande di identificazione o richieste di modifica dei dati.

Per creare un modulo, vai a Settings / Ultimate Chat Widget / Forms e crea un modulo in base alle istruzioni nella pagina.

È possibile creare campi modulo come:

  • Text
  • Email
  • Seleziona

Una volta creato il modulo, vai alla finestra di dialogo in cui desideri aggiungere il modulo e segui i passaggi seguenti. 

Passaggi:

  1. Aggiungi un messaggio agenti AI con il codice abbreviato per acquisire il modulo e inserirlo. Nell’immagine qui sotto stiamo aggiungendo il nostro modulo lead_capture. Tuttavia, dovrai aggiungere il nome del modulo tra i modelli: e ))% nel frammento di codice qui sotto.

    %((template: nameOfTemplate))%

  2. Aggiungi a messaggio visitatore (Scritto con testo libero) blocco subito dopo il messaggio agenti AI . Acquisisce le risposte dell’utente.

  3. Aggiungi un altro blocco di messaggi agenti AI dopo il messaggio del visitatore con una sorta di conferma del completamento del modulo da parte dei clienti, ad esempio un ringraziamento.

  4. Le risposte dell’utente sono bloccate nei metadati. Se vuoi usarli in un secondo momento nella chat, ti consigliamo di recuperarli: questa operazione è completamente facoltativa. Lo facciamo con Actions.

Disinfetta le risposte dei clienti

La sanificazione delle risposte è un’operazione da eseguire se chiedi dati PII ai clienti. Questo è qualcosa che conoscerai bene dalle entità di contenuto, ad esempio, per impostazione predefinita, gli indirizzi email e i numeri IBAN vengono puliti. Per ulteriori informazioni sulla sanificazione, consulta gli articoli seguenti.

agenti AI - Avanzati dei dati

Ricetta: Disinfetta le informazioni personali identificabili (PII) con entità di contenuto

Come disinfettare i dati dei moduli

A seconda del caso d’uso dei moduli, potresti voler disinfettare le informazioni. È facile. 

  1. Fai clic sulla barra blu dove si legge “se…” per aprire il pannello dei dettagli.
  2. Fai clic sulla casella "Ripulisci la risposta dell'utente" per nascondere i dettagli in agenti AI - Avanzati

Di conseguenza, quando esamini la conversazione in agenti AI - Avanzati, apparirà come mostrato di seguito.

 

Localizzazione

È possibile modificare le impostazioni locali del widget in fase di runtime. Per cambiare la localizzazione del metodo di chiamata del widget: setLocale(<string>)

Valore predefinito: en_US

Altre lingue supportate: nl_NL

Verifica della localizzazione

Usa il parametro test per cambiare la lingua del widget. https://widget.ultimate.ai/demo/?botId={Your.Bot.ID}&locale={Your.Locale}
es. https://widget.ultimate.ai/demo/?botId=65da6df65ab8b465b87222586&locale=nl_NL

Esempio di caso d’uso: Sincronizza la lingua dell’interfaccia del widget con la lingua del sito web. Chiama un metodo per aggiornare la lingua del widget quando cambia la lingua del sito web.

Privacy dei dati

Il nostro widget è conforme a SOC2 e RGPD

  • I cookie non vengono utilizzati.
  • Lo spazio di memorizzazione locale viene usato per fornire la migliore esperienza di conversazione.

URL dell’informativa sulla privacy personalizzato

È possibile aggiungere la propria informativa sulla privacy accessibile tramite il nostro widget aggiungendola alla sezione della barra di navigazione.

privacyPolicyUrl: URL

es. privacyPolicyUrl: https://www.ultimate.ai/security-privacy

Memoria locale

Il nostro widget non memorizza i cookie sul dispositivo di un utente, ma è necessaria una memorizzazione sul lato utente per assistenza la funzionalità del widget. Questi sono descritti di seguito:

Nome parametro Descrizione
platformConversationId_{botId} Memorizziamo l’ID conversazione per ripristinare la conversazione durante il ricaricamento della pagina. (è possibile disattivarlo - consulta questa sezione)
lastReadMessageId_{botId}

We memorizza l’ID dell’ultimo messaggio letto dall’utente. Successivamente viene usato per calcolare il contatore delle notifiche.

DOMANDE FREQUENTI

  1. Devo collegarmi a un CRM per testare il widget? No, la connessione CRM non è necessaria. Puoi implementarla in un sito web sandbox o chiederci di fornire un ambiente se ciò non è possibile.
    Aggiungeremo il nostro widget alla nostra piattaforma per integrare la funzionalità di test agenti AI . 

  2. Possiamo monitorare se è stato fatto clic su un link? Purtroppo al momento non è possibile monitorare se è stato fatto clic su un link. Valuteremo l’aggiunta di questa funzionalità in futuro.

  3. Abbiamo la formattazione HTML nello strumento di creazione dialoghi? Purtroppo non al momento. Puoi provare a usare un editor online, come -Editor HTML5 - Composizione di contenuti online gratuita

  4. Possiamo avere più conversazioni? Questa funzione non è attualmente supportata

  5. Ultimate Chat Widget usa i cookie? No, il nostro widget non memorizza i cookie sul dispositivo di un utente. Per informazioni dettagliate sui requisiti di spazio di memorizzazione lato client, consulta la sezione precedente.

Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.

Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.

Powered by Zendesk