Panoramica sullo sviluppo della chat Web

Se si ha dimestichezza con il codice JavaScript, è possibile personalizzare ed estendere la chat web utilizzando l'API della chat web. Puoi anche utilizzare una WebView per integrare la chat web nell'applicazione mobile.

Per informazioni di riferimento dettagliate sull'API della chat web, consultare la documentazione dello sviluppatoredella chat web.

Per aggiungere il widget della chat web al tuo sito web o una WebView nella tua app mobile, tutto ciò che devi fare è incorporare un elemento script generato nella tua origine HTML (per ulteriori informazioni sullo script di incorporazione, vedi Integrazione della chat web nella tua pagina). All'interno di questo script di incorporazione, è possibile utilizzare l'API della chat web per personalizzare o estendere la chat web.

L'API della chat web è composta da diversi componenti:

  • Oggetto di configurazione: Lo script di integrazione definisce un oggetto di configurazione denominato watsonAssistantChatOptions, che specifica gli oggetti di configurazione per il widget di chat web. Modificando l'oggetto di configurazione, è possibile personalizzare l'aspetto e il comportamento della chat web prima che venga eseguito il rendering. Per ulteriori informazioni sulle opzioni di configurazione disponibili, vedi Oggetto delle opzioni di configurazione nella guida di riferimento API web.
  • Metodi dell'istanza: i metodi dell'istanza chat web forniscono un controllo di basso livello del widget chat web. È possibile utilizzare i metodi di istanza per implementare il comportamento personalizzato, come la modifica della modalità di apertura del widget della chat Web, la visualizzazione e la nascondimento del contenuto e l'impostazione delle informazioni di identità. Per ulteriori informazioni sui metodi di istanza disponibili, vedi Elenco di metodi e proprietà nella guida di riferimento dell'API della chat web.
  • Eventi: il sistema di eventi di chat Web consente al sito Web di rispondere agli eventi di chat Web (ad esempio, l'apertura o la chiusura della finestra di chat Web, l'invio o la ricezione di messaggi). Sottoscrivendo gli eventi, è possibile implementare un comportamento personalizzato o anche intercettare e modificare il contenuto del messaggio. Per ulteriori informazioni sul sistema di eventi, consultare Eventi nella guida di riferimento dell'API della chat web.

Se si desidera utilizzare l'API della chat web per personalizzare l'implementazione della chat web, non è necessario iniziare da zero. Sono disponibili esercitazioni che mostrano esempi di personalizzazione di chat web comuni. Per ulteriori informazioni, consultare Esercitazioni di sviluppo della chat Web.

Attività di sviluppo

È possibile utilizzare l'API della chat web per personalizzare ed estendere la chat web nei seguenti modi:

Stile e contenuto della chat Web
Apertura, chiusura e rendering della finestra di chat Web
Personalizzazione della conversazione
Gestione dei dati
Sicurezza e amministrazione

Per ulteriori esempi di integrazioni di chat web, vedi qui.

Stile e contenuto della chat Web

Personalizzazione dell'aspetto della chat web

Se si desidera personalizzare lo stile e l'aspetto della chat Web oltre le opzioni disponibili nella scheda Stile nelle impostazioni della chat Web, è possibile farlo scegliendo un tema Carbon Design diverso.

I temi supportati sono temi a colori definiti da IBM Carbon Design. Per impostare il tema Carbon, utilizzare l'opzione di configurazione carbonTheme.

È inoltre possibile impostare singole variabili all'interno del tema per personalizzare elementi UI specifici. Ad esempio, il testo visualizzato nella finestra di conversazione utilizza i caratteri IBMPlexSans, Arial, Helvetica, sans-serif. Se si desidera utilizzare un font diverso, è possibile specificarlo utilizzando il metodo dell'istanza di updateCSSVariables().

Personalizzazione della schermata iniziale

La schermata iniziale accoglie il cliente e, facoltativamente, mostra un elenco di starter di conversazione suggeriti. È possibile personalizzare lo stile e il contenuto della schermata principale:

Personalizzazione delle stringhe

È possibile personalizzare le stringhe che definiscono le diverse etichette e frasi codificate visualizzate dalla chat Web. Per personalizzare le stringhe, utilizzare il metodo dell'istanza updateLanguagePack() per sostituire le stringhe nel pacchetto lingua corrente. Per ulteriori informazioni, consultare Lingue.

Supporto del pubblico globale

Per impostazione predefinita, le stringhe visualizzate dalla chat web sono in inglese. Per passare a una lingua diversa, utilizzare il metodo dell'istanza updateLanguagePack() per sostituire il pacchetto lingua corrente con uno dei pacchetti lingua tradotti disponibili. Per ulteriori informazioni, consultare Supporting global audience in web chat.

Apertura, chiusura e rendering della finestra di chat Web

Sostituzione del programma di avvio predefinito

Per una migliore integrazione con il tuo sito web, potresti voler sostituire l'icona del launcher integrato con un meccanismo diverso per aprire la chat web. Per nascondere l'utilità di avvio predefinita, impostare l'opzione di configurazione showLauncher su false. Per aprire la chat web basata su altre interazioni, utilizzare il metodo dell'istanza openWindow.

icona sviluppo Esercitazione: per un'esercitazione che mostra come implementare un programma di avvio personalizzato, consultare Utilizzo di un programma di avvio personalizzato.

Mantenere la chat web sempre aperta

Se si desidera mantenere la chat web sempre aperta sulla pagina, utilizzare la configurazione di openChatByDefault aperta per eseguire il rendering della pagina con la finestra di chat aperta e l'opzione hideCloseButton per impedire ai clienti di chiuderla.

Modifica della dimensione o della posizione della chat web

La progettazione del tuo sito web potrebbe richiedere di modificare dove e come la finestra di chat web viene resa sul sito web. Ad esempio, si potrebbe desiderare che venga visualizzato in una posizione diversa nella pagina, in una dimensione diversa o nidificato all'interno di un altro elemento nella pagina.

Per modificare la dimensione della finestra di chat Web, è possibile utilizzare il metodo dell'istanza updateCSSVariables() per modificare lo stile CSS.

Se è necessario modificare la posizione della finestra di chat Web o modificare la dimensione oltre i limiti consentiti nel CSS, è possibile utilizzare un elemento DOM personalizzato per contenere la finestra di chat Web. A tale scopo, utilizzare l'opzione di configurazione element.

icona sviluppo Esercitazione: per un'esercitazione che mostra come eseguire il rendering della chat web in un elemento personalizzato, consultare Esercitazione: personalizzazione della dimensione e della posizione della conversazione web.

Aggiunta della chat web alla propria applicazione mobile

Puoi utilizzare una WebView con un bridge JavaScript per aggiungere la chat web alla tua applicazione mobile. Per ulteriori informazioni, vedi Aggiunta della chat web alla tua applicazione mobile.

Personalizzazione della conversazione

Intercettazione e modifica dei messaggi

Effettuando la sottoscrizione a eventi, il tuo codice può intercettare i messaggi inviati e ricevuti tra il cliente e l'assistente e persino modificarne il contenuto.

Sottoscrivi l'evento pre:receive se vuoi intercettare il messaggio di un cliente prima che venga inviato all'assistente. Ad esempio, si potrebbe voler rimuovere le informazioni di identificazione personale dal testo del messaggio o aggiungere variabili di contesto al payload del messaggio.

Sottoscrivi l'evento pre:send se vuoi intercettare una risposta in entrata dall'assistente prima che venga visualizzata al cliente. Ad esempio, è possibile aggiungere formattazione, collegamenti o altri elementi specifici della chat Web.

icona sviluppo Esercitazione: per un'esercitazione che mostra come utilizzare l'evento pre:receive per intercettare e modificare i messaggi in entrata, consultare Esercitazione: implementazione dei pulsanti di opzione personalizzati nella chat web.

Rendering dei tipi di risposta personalizzati

Se il tuo assistente invia risposte specializzate utilizzando un tipo di risposta personalizzato (user_defined), puoi implementare una vista personalizzata per visualizzare queste risposte nella finestra di chat web. A tale scopo, sottoscrivere l'evento customResponse, che viene attivato ogni volta che viene ricevuta una risposta user_defined. Nel metodo del gestore eventi, è possibile quindi leggere il contenuto della risposta e rendere l'output utilizzando i propri elementi.

icona sviluppo Esercitazione: per un'esercitazione che mostra come eseguire il rendering di un tipo di risposta personalizzato come sostituzione della risposta delle opzioni predefinite, consultare Esercitazione: implementazione dei pulsanti di opzione personalizzati nella chat web.

Implementazione di un'integrazione del centro di contatto

Puoi utilizzare uno dei kit starter della chat web per l'integrazione con una piattaforma del centro di contatto (service desk) diversa da quelle disponibili come integrazioni watsonx Assistant integrate. Le implementazioni di riferimento completamente funzionali sono disponibili per diverse piattaforme di contact center; inoltre, è possibile utilizzare un kit starter per sviluppare un'integrazione personalizzata con la piattaforma di tua scelta.

Per ulteriori informazioni, consultare Aggiunta del supporto del centro di contatto.

Gestione dei dati

Gestione delle informazioni sull'identità utente

La chat web associa un ID utente ad ogni messaggio che invia all'assistente; questo ID utente viene utilizzato per la fatturazione basata su utente e altri scopi. È possibile consentire alla chat web di generare un ID anonimo per ciascun utente oppure è possibile controllare l'ID utente da soli.

A seconda se è stata abilitata la sicurezza per la chat web, è possibile utilizzare il metodo dell'istanza updateUserID o il metodo updateIdentityToken per specificare le informazioni sull'identità dell'utente.

Per ulteriori informazioni su come vengono specificate le informazioni di identità utente e su come vengono utilizzate, vedi Gestione delle informazioni di identità utente nella chat web.

Sicurezza e amministrazione

Protezione della chat web

Per proteggere la chat web, puoi utilizzare JWT (JSON Web Token) per autenticare gli utenti e codificare i dati privati. Per ulteriori informazioni, vedi Protezione della chat web.

Controllo della versione della chat web

Il codice della chat web ospitato da IBM Cloud viene aggiornato regolarmente con miglioramenti e nuove funzioni. Per impostazione predefinita, lo script di integrazione utilizza automaticamente la versione più recente della chat web. Per evitare modifiche impreviste che potrebbero interessare il tuo sito web, potresti voler controllare quale versione della chat web utilizza il tuo sito web, dandoti l'opportunità di testare ogni nuova versione prima di distribuirla in produzione, al fine di evitare modifiche impreviste quando viene rilasciata una nuova versione.

Per ulteriori informazioni sulla versione della chat web, consultare Controllo della versione della chat web.