Integra Oracle Digital Assistant in un sito Web integrato in Oracle Content Management

Introduzione

Le organizzazioni spesso cercano di creare siti Web per la condivisione dei contenuti (ad esempio siti di marketing, portali di vendita e hub partner) per la distribuzione dei contenuti a destinatari interni o esterni. Oracle Content Management offre strumenti con funzionalità avanzate per la creazione di siti Web di condivisione dei contenuti di questo tipo.

Gli assistenti digitali e i chatbot consentono ai team di vendita e marketing di monitorare rapidamente l'espansione del business digitale e migliorare l'esperienza cliente.

Oracle Digital Assistant è una piattaforma che consente di creare e distribuire assistenti digitali, ovvero interfacce basate sull'intelligenza artificiale che consentono agli utenti di eseguire una vasta gamma di attività nelle conversazioni con il linguaggio naturale. Ma cosa accade quando hai bisogno di un sistema di gestione dei contenuti (CMS) per servire tutti i tuoi contenuti? Fortunatamente, Oracle Content Management, con le sue funzionalità CMS headless, offre una soluzione ideale per tutte le esigenze di amministrazione e gestione del controllo dei contenuti.

In questa esercitazione, creeremo in primo luogo un chatbot in Oracle Digital Assistant utilizzando Oracle Content Management come CMS headless e il kit di sviluppo software (SDK) per la distribuzione dei contenuti in JavaScript. Successivamente, verrà utilizzato Site Builder di Oracle Content Management per creare e modificare un sito Web di abilitazione vendite e aggiungere il chatbot utilizzando un componente personalizzato di Oracle Content Management.

L'esercitazione si articola in quattro passi:

  1. Configura il tuo sito di vendita Café Supremo
  2. Sviluppa le competenze di Oracle Digital Assistant
  3. Impostare il componente personalizzato di Oracle Content Management
  4. Aggiungere il componente personalizzato al sito Web

Prerequisiti

Prima di procedere con questa esercitazione, si consiglia di leggere le seguenti informazioni:

Per seguire questa esercitazione, sono necessari:

Cosa stiamo costruendo

Café Supremo è una catena di caffà ̈ fittizia, che ha punti vendita in tutto il mondo. Il sito Web dell'abilitazione alle vendite Café Supremo viene creato con Oracle Content Management.

Il sito di vendita Café Supremo consente ai rappresentanti commerciali della società Café Supremo di tutto il mondo di ottenere tutte le informazioni necessarie sulle vendite. Per conoscere il sito Web di supporto alle vendite e visualizzare un'introduzione al sito Web di supporto alle vendite di Café Supremo, vedere Informazioni sulla creazione di un sito Web di supporto alle vendite.

Si tratta di una versione avanzata del sito di supporto alle vendite Café Supremo, in cui è presente un chatbot sviluppato mediante Oracle Digital Assistant (ODA) che estrae i contenuti consegnati da un canale di Oracle Content Management.

Questo è l'aspetto del sito di abilitazione delle vendite alla fine di questa esercitazione:

Questa immagine mostra la pagina di destinazione del sito di abilitazione delle vendite con la finestra del chatbot aperta e una conversazione in corso.

Task 1: Configura il tuo caffè Supremo Sales Enablement Sito Web

In questa sezione verrà impostato il sito Web dell'abilitazione alle vendite di Café Supremo mediante Oracle Content Management.

Per iniziare, è necessario scaricare il file ZIP contenente il modello e il codice di esempio per il sito Web di supporto alle vendite di Café Supremo dalla pagina dei download di Oracle Content Management. Una volta ottenuta una copia del modello, caricarlo in Oracle Content Management, dove verrà utilizzato per creare il sito Web di abilitazione delle vendite.

Il file ZIP contiene un file Readme, file di licenza e il file ZIP del modello.

Nota: le immagini utilizzate nel modello di esempio e nel sito Web dell'abilitazione alle vendite di Café Supremo sono immagini di Shutterstock. Se si desidera riutilizzarle, è necessario ottenere la licenza Shutterstock. È inoltre possibile sostituire queste immagini con immagini personali.

Per configurare il Sito di vendita di riferimento Café Supremo:

  1. Connettersi a Oracle Content Management come amministratore. Se non viene visualizzata una sezione ADMINISTRATION nel menu di navigazione sinistro nell'interfaccia Web di Oracle Content Management, non si dispone dei privilegi di amministratore. In tal caso, contattare l'amministratore del servizio.

  2. Nel menu di navigazione a sinistra fare clic su Sviluppatore, quindi su Visualizza tutti i modelli.

Questa immagine mostra la pagina Sviluppatore nell'interfaccia Web di Oracle Content Management, con collegamenti a componenti, modelli, temi e interfaccia utente incorporabile.

  1. Nella pagina Modelli fare clic su Crea e scegliere Importa package modello.

  2. Nella finestra di dialogo Seleziona un file, individuare la cartella in cui si desidera caricare il file o creare una nuova cartella e fare clic su Carica.

  3. Individuare e selezionare il package del modello CafeSupremoSalesEnablement.zip e fare clic su Open. Attendere il caricamento del file. Una volta caricato, il file sarà disponibile per la selezione.

  4. Selezionare la casella di controllo CafeSupremoSalesEnablement.zip e fare clic su OK. Il modello CafeSupremoSalesEnablement è ora incluso nella lista dei modelli nella pagina Modelli.

  5. Fare clic su Content in ADMINISTRATION nel menu di navigazione a sinistra.

  6. Ora creare un repository, che è una posizione di memorizzazione per gestire tutti gli asset digitali utilizzati nel tuo sito Web in un'unica posizione:

    1. Scegliere Repository nell'elenco a discesa e fare clic su Crea nell'angolo superiore destro.

    2. Nel campo Nome immettere un nome di repository significativo per il sito Web, ad esempio 'CafeSupremoSalesEnablement Repository'.

    3. Nel campo Lingua predefinita accertarsi che sia selezionato Inglese (Stati Uniti).

    4. Fare clic su Salva. Il nuovo repository creato viene ora incluso nella lista di repository nella pagina Contenuto.

    In questa immagine viene visualizzata la pagina Crea repository asset nell'interfaccia Web di Oracle Content Management.

  7. Fare clic su Siti nel menu di navigazione a sinistra.

  8. Nella pagina Siti fare clic su Crea nell'angolo superiore destro.

Questa immagine mostra la pagina di destinazione Siti nell'interfaccia Web di Oracle Content Management, con un pulsante Crea nell'angolo in alto a destra.

  1. Nella finestra di dialogo Crea sito, scegliere il modello CafeSupremoSalesEnablement.

  2. Completare i campi riportati di seguito.

    • Repository di asset: selezionare il repository di asset creato in precedenza, ad esempio 'CafeSupremoSalesEnablement Repository'.

    • Criterio di localizzazione: il criterio di localizzazione viene selezionato automaticamente perché è disponibile come parte del codice di esempio e del modello.

    • Lingua predefinita: questo campo è impostato su Inglese (Stati Uniti) (en-US) per impostazione predefinita.

In questa immagine viene visualizzata la pagina Crea sito nell'interfaccia Web di Oracle Content Management.

  1. Fare clic su Avanti e aggiungere i dettagli per il sito:

    • Nome: immettere un nome per il sito Web, ad esempio CafeSupremoSalesEnablement.

    • Prefisso per valori URL descrittivo: verrà aggiunto ai valori URL descrittivo per gli elementi di contenuto.

    • Descrizione: fornire una descrizione facoltativa del sito.

    In questa immagine viene visualizzata la pagina dei dettagli del sito nell'interfaccia Web di Oracle Content Management.

  2. Fare clic su Crea.

Il sito Web di abilitazione delle vendite è stato creato ed è ora elencato nella pagina Siti.

Task 2: creare l'abilità di Oracle Digital Assistant

Per utilizzare il contenuto di Oracle Content Management in un'applicazione chatbot ODA, è possibile utilizzare l'esempio di chatbot ODA di Oracle Content Management, disponibile in un repository open-source su GitHub.

Nota: tenere presente che l'uso del campione di chatbot ODA è facoltativo e che viene utilizzato in questa esercitazione per iniziare rapidamente. Puoi anche creare la tua applicazione di chatbot.

Per creare la competenza di chatbot in ODA:

  1. Duplicare il repository di esempio
  2. Importare lo skill ODA nell'istanza
  3. Impostare e configurare il servizio componente personalizzato
  4. Gestione SDK contenuto
  5. Utilizzare il kit SDK del contenuto per recuperare il contenuto
  6. Package e distribuzione del servizio componente personalizzato

Duplicare il repository di esempio

Il campione di chatbot ODA di Oracle Content Management è disponibile in un repository open source su GitHub. Sarà innanzitutto necessario clonare il repository di esempio da GitHub al computer locale e modificare la directory per utilizzare questo esempio.

git clone https://github.com/oracle/oce-integration-samples.git
    cd oce-integration-samples/oce-oda-chatbot-sample/site-integration-chatbot-sample

Ora che si dispone del codice base, è necessario esaminare più da vicino le cartelle che verranno utilizzate in questa esercitazione:

Nota: la cartella headless-chatbot-sample fa parte di un esempio di chatbot senza problemi. Puoi consultare ulteriori informazioni su questo esempio di chatbot senza problemi qui.

Importa skill ODA nell'istanza

La cartella SalesEnablementChatbotIntegration è lo skill ODA utilizzato in questa esercitazione. Attenersi alla procedura riportata di seguito per creare e formare la propria competenza sull'istanza ODA.

  1. Nell'istanza di Oracle Digital Assistant aprire il menu di navigazione a sinistra, quindi fare clic su Sviluppo, quindi su Skill.

    Questa immagine mostra l'istanza di Oracle Digital Assistance con il menu di navigazione sinistro aperto e l'opzione Skill evidenziata.

  2. Cercare lo skill Integrazione chatbot di abilitazione delle vendite.

    Nota: se l'istanza non dispone di questo skill, selezionare il contenuto della cartella SalesEnablementChatbotIntegration e comprimerli in un singolo file zip. Nella pagina Skill dell'istanza ODA fare clic su Importa competenza e importare il file ZIP appena creato. La compressione diretta della cartella SalesEnablementChatbotIntegration produrrà un errore al momento dell'importazione.

  3. Nella scheda competenza Abilitazione vendite integrazione chatbot, fare clic sull'icona delle opzioni, quindi su Duplicazione.

    Questa immagine mostra il menu di scelta rapida per una competenza di integrazione chatbot di abilitazione delle vendite.

  4. Assegnare alla competenza clonata un nome visualizzato univoco, ad esempio aggiungere le iniziali all'inizio, ad esempio 'AB - Integrazione chatbot di abilitazione delle vendite'. Lasciare invariati tutti gli altri valori. Selezionare Apri competenze clonate in seguito, quindi fare clic su Duplica.

    Nota: il nome deve iniziare con una lettera e può contenere solo lettere, numeri, punti e caratteri di sottolineatura. Non può superare i 100 caratteri.

    Questa immagine mostra la finestra di dialogo per la creazione di un clone di abilità.

  5. Fare clic su Train, assicurarsi che sia selezionato Trainer Ht, quindi fare clic su Sottometti per formare la competenza.

    Nota: in questa esercitazione viene utilizzato il training Ht, che è rapido ma superficiale. Per il lavoro di produzione, è necessario utilizzare la formazione Tm, che consente una migliore risoluzione delle intenzioni.

    Questa immagine mostra le opzioni di formazione per lo skill.

Competenza integrazione chatbot abilitazione vendite

Le competenze sono singoli chatbot progettati per interagire con gli utenti ed eseguire tipi specifici di attività, come l'ordine di cibo, la prenotazione e la modifica delle informazioni di contatto. Lo skill ODAChatbot consente a un utente di trovare annunci e storie di abilitazione vendite appropriati mediante una combinazione di messaggi di testo e semplici elementi dell'interfaccia utente, ad esempio elenchi di selezione.

Prima di acquisire familiarità con l'assistente digitale e lo sviluppo di competenze, ecco alcuni concetti con cui si desidera acquisire familiarità:

Per saperne di più su Oracle Digital Assistant e sulle competenze, consulta la documentazione del prodotto.

Impostazione e configurazione del servizio componente personalizzato

La cartella oda-custom-component nella base di codice è il componente personalizzato ODA utilizzato per recuperare il contenuto da un canale sicuro in OCM. In primo luogo, è necessario scaricare le dipendenze per questo componente personalizzato ODA. Eseguire il comando seguente dalla directory site-integration-chatbot-sample/oda-custom-component:

npm install

Successivamente, dobbiamo configurare alcune informazioni in modo che il nostro SDK di Oracle Content Management Content (e qualsiasi altra richiesta) possa indirizzare l'URL dell'istanza e la versione API corretti con il token di canale corretto.

Questi valori vengono utilizzati in component/server-config-utils.js per creare un'istanza di un nuovo client di distribuzione.

Aprire il file server-config-utils.js in un editor di testo. Sono disponibili gli elementi riportati di seguito.


    contentServer: "https://instance-name.cec.ocp.oraclecloud.com",
    contentVersion: "v1.1",
    channelToken: "4b7b22ad5f5245f28579641d5489a98f",

Modificare ogni coppia chiave-valore in modo che rifletta l'URL dell'istanza, la versione API che si desidera target e il token canale associato al canale di pubblicazione del sito CafeSupremoSalesEnablement.

Utilizzare l'SDK di Oracle Content Management Content

Oracle Content Management offre un SDK che consente di individuare e utilizzare i contenuti nelle applicazioni. L'SDK viene pubblicato come modulo NPM e il progetto viene gestito in hosting su GitHub.

Per ulteriori informazioni sull'SDK, fare clic qui.

L'SDK è stato registrato come dipendenza runtime del componente personalizzato ODA nel file package.json.

Utilizzare l'SDK del contenuto per recuperare il contenuto

Ora possiamo sfruttare il kit SDK del contenuto per recuperare il contenuto della competenza relativa ai chatbot tramite il componente personalizzato ODA.

La cartella Components/services.js contiene il codice per il recupero dei dati da Oracle Content Management mediante l'SDK del contenuto.

Il file component/server-config-utils.js importa l'SDK del contenuto e quindi crea un client di consegna utilizzando la configurazione specificata in esso.

Il comando seguente importa l'SDK:

createDeliveryClient = require('@oracle/content-management-sdk');

Il comando seguente crea il client di consegna:

deliveryClient = createDeliveryClient(serverconfig);

Il file component/services.js contiene tutto il codice per recuperare gli elementi di contenuto per il chatbot. C'è una funzione principale per recuperare tutto il contenuto del chatbot.

Le funzioni riportate di seguito vengono richiamate per recuperare tutti i dati per una particolare categoria di tassonomia dal repository CafeSupremoSalesEnablement.

function getStoryData(client, categoryName) {
     if (categoryName === 'Announcements') {
       return fetchItemsForAnnouncements(client, false)
         .then((topLevelItem) => {
           const { totalResults } = topLevelItem;
           const promises = [];
           // for each item, retrieve the result object and add it to the promise
           topLevelItem.items.forEach((item) => {
             promises.push(
               retrieveAnnouncementsObject(client, item.id)
                 .then((resultobject) => ({ ...resultobject })),
             );
           });
           // execute all the promises before returning the data
           return Promise.all(promises)
             .then((arrayOfItems) => ({
               totalResults,
               items: arrayOfItems.flat(),
             }));
         });
     }
     return fetchItemsForCategoryName(client, categoryName, false)
       .then((topLevelItem) => {
         const { totalResults } = topLevelItem;
         const promises = [];
         // for each item, retrieve the result object and add it to the promise
         topLevelItem.items.forEach((item) => {
           promises.push(
             retrieveResultObject(client, item.id)
               .then((resultobject) => ({ ...resultobject })),
           );
         });
         // execute all the promises before returning the data
         return Promise.all(promises)
           .then((arrayOfItems) => ({
             totalResults,
             items: arrayOfItems.flat(),
           }));
       });
    }

La funzione getStoryData effettua due set di chiamate diversi a seconda che la richiesta venga effettuata per la categoria annunci o storia.

Dati annunci

Richiede una chiamata dati per ottenere tutti gli elementi di contenuto per gli annunci.

La funzione getStoryData chiama fetchItemsForAnnouncements, che recupera tutti gli elementi di contenuto di tipo 'SE2-Announcements'. Successivamente, viene chiamata la funzione retrieveAnnouncementsObject e i campi del titolo e del sintetico dell'oggetto risultato vengono popolati con i dati di fetchItemsForAnnouncements.

function fetchItemsForAnnouncements(client, limit) {
     return client.getItems({
       q: '(type eq "SE2-Announcement")',
       fields: 'all',
       expand: 'all',
       limit: limit ? 4 : 100,
       totalResults: true,
     });
    }

Dati storia

Richiede diverse chiamate di dati per ottenere tutti gli elementi di contenuto per le Storie.

  1. In primo luogo, vengono recuperati tutti gli elementi di contenuto per la categoria richiesta dall'utente.

  2. Per ogni elemento di contenuto ottenuto, viene effettuata una chiamata per recuperare l'URL del supporto.

La funzione getStoryData chiama fetchItemsForCategoryName, che recupera tutti gli elementi di contenuto di tipo 'SE2-Story' e il nome della categoria di tassonomia come specificato dall'utente.

function fetchItemsForCategoryName(client, categoryName, limit) {
     return client.getItems({
       q: `(taxonomies.categories.name eq "${categoryName}" and type eq "SE2-Story")`,
       fields: 'all',
       expand: 'all',
       limit: limit ? 4 : 100,
       totalResults: true,
     });
    }

L'elemento di contenuto recuperato da fetchItemsForCategoryName dispone di un campo ID supporto. La funzione retrieveMediaURL utilizza questo ID supporto per recuperare l'URL del supporto.

function retrieveMediaURL(client, identifier) {
     return client.getItem({
       id: identifier,
       fields: 'all',
       expand: 'all',
     }).then((asset) => {
       let url = null;
       if (asset.fields && asset.fields.renditions && asset.fields.fileType !== 'mp4') {
         const object = asset.fields.renditions.filter((item) => item.name === 'Small')[0];
         const format = object.formats.filter((item) => item.format === 'jpg')[0];
         const self = format.links.filter((item) => item.rel === 'self')[0];
         url = self.href;
       } else {
         url = asset.fields.native.links[0].href;
       }
       return [url, asset.fields.fileType];
     });
    }

Package e distribuzione del servizio componente personalizzato

È possibile distribuire componenti personalizzati in un contenitore incorporato per una competenza, un server nodo remoto o Oracle Mobile Hub. In questa esercitazione verrà distribuito il servizio componente personalizzato in un contenitore incorporato. Per eseguire questa operazione, è innanzitutto necessario creare un package del servizio componente personalizzato in un file distribuibile:

  1. Salvare i dati nel proprio IDE JavaScript.

  2. Aprire una finestra di terminale e accedere alla cartella site-integration-chatbot-sample/oda-custom-component.

  3. Nella cartella oda-custom-component immettere il seguente comando npm

    bots-node-sdk pack

    A causa dello script prepack nel file package.json, il comando esegue in primo luogo il comando prepack per verificare il pacchetto. Il comando quindi imballa il progetto Node e le relative dipendenze in un tarball distribuibile denominato oda-custom-component-1.0.0.tgz.

    Il tarball deve includere tutte le dipendenze ad eccezione di devDependencies.

  4. Nella competenza chatbot sull'istanza ODA, fare clic sull'icona Componenti nella barra a sinistra per aprire la pagina del servizio componenti. Fare clic su + Service per creare un nuovo servizio.

    Questa immagine mostra una pagina dei servizi vuota per uno skill.

  5. Nella finestra di dialogo Crea servizio, effettuare le operazioni riportate di seguito.

    1. Nel campo Nome immettere SalesEnablementCustomComponent.

    2. Nel campo Descrizione è possibile aggiungere una descrizione facoltativa.

    3. Assicurarsi che l'opzione Contenitore incorporato sia selezionata.

    4. Trascinare o caricare il file oda-custom-component-1.0.0.tgz nel campo File package.

    5. Fare clic su Crea.

In questa immagine è illustrata la finestra di dialogo Crea servizio.

  1. Attendere che il campo Stato mostri Pronto, che potrebbe richiedere alcuni secondi.

  2. Con il servizio componente personalizzato distribuito nel contenitore incorporato della competenza, è possibile eseguire il test del componente.

Per ulteriori informazioni su Oracle Digital Assistant e sui componenti personalizzati, consulta la documentazione relativa alla formazione.

Creare un canale Web Oracle Digital Assistant

Verrà creato un canale utente di Oracle Digital Assistant che consente a un client Web Oracle di accedere alle proprie competenze. Per assicurarsi che solo i client Web possano utilizzare questo canale, configurarlo in modo da richiedere l'autenticazione del client.

  1. Nell'istanza di Oracle Digital Assistant aprire il menu di navigazione a sinistra, quindi fare clic su Sviluppo, quindi su Canali.

    Questa immagine mostra l'istanza di Oracle Digital Assistance con il menu di navigazione sinistro aperto e l'opzione Canali evidenziata.

  2. Nella pagina Canali fare clic su + Canale per aggiungere un canale.

  3. Nella pagina Crea canali, immettere queste informazioni come mostrato nello screenshot seguente:

    • Nome: un nome univoco che inizia con una lettera e contiene solo lettere, numeri, punti e caratteri di sottolineatura (_), ad esempio AB_SalesEnablementChatbotIntegration.
    • Descrizione: (facoltativo) il canale utilizzato.
    • Tipo di canale: Oracle Web.
    • Domini consentiti: * (un solo asterisco consente qualsiasi dominio).
    • Autenticazione client abilitata: lasciarla in posizione non attiva.

    Questa immagine mostra l'istanza di Oracle Digital Assistance con il menu di navigazione sinistro aperto e l'opzione Canali evidenziata.

  4. Fare clic su Crea.

  5. Nell'elenco a discesa Instrada a selezionare la competenza creata per questa esercitazione.

    Questa immagine mostra la pagina Canali con l'elenco a discesa Instrada a aperto.

  6. Impostare l'opzione Canale abilitato su Attivo.

  7. Prendere nota dell'ID canale visualizzato per questo canale. Più avanti in questa esercitazione, questo valore verrà utilizzato nell'applicazione Web.

    Questa immagine mostra la pagina Canali con le informazioni di instradamento per il chatbot.

  8. Prendere inoltre nota dell'host e del dominio Oracle Digital Assistant (con riferimento come nome di dominio completamente qualificato) dall'URL dell'istanza visualizzato nel campo dell'indirizzo del browser Web, ad esempio oda-xxxx.data.digitalassistant.oci.oraclecloud.com. Questo valore verrà utilizzato in seguito nell'esercitazione.

La tua istanza è ora impostata per te per connettere un chatbot sul tuo sito Web alle abilità.

Task 3: Impostazione del componente personalizzato di Oracle Content Management

Ora è necessario importare il componente personalizzato SE2-ODA-Chatbot nell'istanza di Oracle Content Management.

L'impostazione del componente personalizzato di Oracle Content Management prevede tre passaggi:

  1. Aggiungi SDK Web Oracle Digital Assistant
  2. Importare il componente personalizzato SE2-ODA-Chatbot
  3. Pubblicare il componente personalizzato SE2-ODA-Chatbot

Aggiungi SDK Web Oracle Digital Assistant

È necessario aggiungere il file web-sdk.js ODA nel componente personalizzato SE2-ODA-Chatbot. L'SDK si connette a Oracle Chat Server, che si trova tra Oracle Digital Assistant e l'abilità (o assistente digitale). Il server di chat passa quindi i messaggi alla capacità di elaborazione e fornisce la risposta della competenza al client.

  1. Scaricare la versione più recente di Oracle Web SDK e decomprimerla in una cartella di tua scelta. È inoltre possibile accedere alla pagina di download di questo SDK dall'istanza di Digital Assistant aprendo il menu laterale e facendo clic su Download.

  2. Copiare il file native-client-sdk-js/web-sdk.js dalla cartella Oracle Web SDK e inserirlo nella cartella SE2-ODA-Chatbot/assets/chatbot.

Questa immagine mostra il file web-sdk nella cartella SE2-ODA-Chatbot/assets/chatbot.

Importare il componente personalizzato SE2-ODA-Chatbot

Per importare il componente personalizzato SE2-ODA-Chatbot, effettuare le operazioni riportate di seguito.

  1. Passare alla cartella site-integration-chatbot-sample e comprimere la cartella SE2-ODA-Chatbot in un file zip.

  2. Eseguire il login all'interfaccia Web di Oracle Content Management come amministratore.

  3. Fare clic su Developer nel menu di navigazione sinistro, quindi su View All Components. Se l'opzione Sviluppatore non viene visualizzata, non si dispone dei ruoli utente necessari.

  4. Nella pagina Componenti fare clic su Crea e scegliere Importa componente.

    Questa immagine mostra la pagina Componenti con il menu a discesa Crea aperto. Nella parte inferiore di tale menu a discesa è disponibile l'opzione Importa componente.

  5. Andare alla cartella dell'istanza di Oracle Content Management in cui si desidera caricare il componente o creare una nuova cartella. Fare clic su Carica , quindi trovare il file SE2-ODA-Chatbot.zip e fare clic su Apri.

  6. Selezionare il file SE2-ODA-Chatbot.zip e fare clic su OK.

    Questa immagine mostra la pagina Selezionare un file con il file SE2-ODA-Chatbot.zip selezionato e OK abilitato.

Se il nome o l'ID del componente o del layout esiste già, un messaggio inviterà a risolvere i conflitti. Potrebbe essere necessario creare un nuovo componente oppure sovrascrivere il componente esistente con la versione importata.

Una volta caricato correttamente il componente SE2-ODA-Chatbot, viene elencato nella pagina Componenti.

Pubblicare il componente personalizzato SE2-ODA-Chatbot

Ora è necessario pubblicare il componente SE2-ODA-Chatbot importato:

  1. Nella pagina Componenti selezionare il componente SE2-ODA-Chatbot e fare clic su Pubblica dalla barra delle azioni o dal menu di scelta rapida.

    Questa immagine mostra la pagina Componenti con il componente SE2-ODA-Chatbot selezionato e l'opzione Pubblica abilitata.

  2. Nella finestra di dialogo Pubblica componente selezionare Confermare per continuare e fare clic su OK.

    Questa immagine mostra la pagina Pubblica componente con la casella di controllo 'Conferma per continuare' selezionata e il pulsante OK abilitato.

Una volta pubblicato il componente SE2-ODA-Chatbot, viene visualizzata una notifica nella parte superiore della pagina per confermarlo.

Task 4: Aggiungere il componente personalizzato al sito Web

Come passo finale, verrà aggiunto il componente personalizzato SE2-ODA-Chatbot al sito di abilitazione delle vendite trascinandolo in Site Builder.

L'aggiunta del nostro chatbot al sito di supporto alle vendite è un processo in due fasi:

  1. Modificare il sito Web
  2. Pubblicare il sito Web

Modificare il sito Web

Il primo passo è aggiungere un chatbot al sito di abilitazione delle vendite utilizzando il componente personalizzato SE2-ODA-Chatbot:

  1. Eseguire il login all'interfaccia Web di Oracle Content Management e aprire la pagina Siti.

  2. Selezionare il sito Web appena creato e scegliere Apri nella barra delle azioni oppure fare clic con il pulsante destro del mouse sul menu per aprirlo in Site Builder.

  3. Impostare il sito in modalità di modifica attivando lo switch Visualizza/Modifica.

  4. Immettere un nome per l'aggiornamento e fare clic su OK.

  5. Nella barra laterale sinistra fare clic su Componenti, quindi su Personalizzato per visualizzare la lista dei componenti personalizzati.

    Questa immagine mostra l'elenco dei componenti in Site Builder con l'opzione Personalizzato selezionata.

  6. Ora aggiungiamo un widget di chatbot ODA alla home page utilizzando il componente personalizzato SE2-ODA-Chatbot. Trascinare il componente SE2-ODA-Chatbot in qualsiasi punto della pagina. Fare clic sul titolo del componente SE2-ODA-Chatbot per assicurarsi che il relativo elemento padre sia quello desiderato. Si tratta di un metodo utile per definire la posizione di qualsiasi componente all'interno della struttura della pagina Web.

    Questa immagine mostra il componente personalizzato in una pagina Web in Site Builder.

    Definire le impostazioni personalizzate nella scheda Generale.

    • URI ODA: l'URL dell'istanza ODA (senza http://).
    • ID canale: ID del canale Web ODA.
    • Titolo chatbot: il titolo del widget chat visualizzato nell'intestazione.
    • Configurazione chatbot: facoltativamente, fornire qualsiasi configurazione aggiuntiva per il chatbot ODA come oggetto JSON (utilizzare le virgolette per qualsiasi stringa di chiave e valore).

Ripetere i passaggi precedenti per aggiungere il chatbot su qualsiasi pagina del sito Web.

Pubblicare il sito Web

Dopo aver aggiunto il chatbot al sito Web, è possibile pubblicarlo per renderlo disponibile in linea in modo che possa essere visualizzato dagli utenti.

  1. Se l'aspetto è quello desiderato, eseguire il commit delle modifiche al sito Web di base facendo clic su Commit nell'angolo superiore destro di Site Builder.

    Questa immagine mostra il passo per eseguire il commit delle modifiche in Site Builder.

  2. Nella finestra di dialogo Esegui il commit dell'aggiornamento, fare clic su Esegui il commit.

    Questa immagine mostra la finestra di dialogo di commit in Site Builder.

  3. Una volta eseguito il commit delle modifiche, il sito Web è pronto per essere pubblicato. Chiudere SiteBuilder.

  4. Fare clic su Siti nel menu di navigazione sinistro nell'interfaccia Web di Oracle Content Management e selezionare il sito Web.

  5. Fare clic su Barra laterale nella barra dei menu, quindi scegliere Proprietà o Proprietà dal menu di scelta rapida.

    Questa immagine mostra il pulsante delle proprietà per il sito.

  6. Nella finestra di dialogo delle proprietà, fare clic sulla scheda Sicurezza, quindi selezionare Sì nel campo Richiedi a tutti di accedere a questo sito. Nel campo Chi può accedere a questo sito quando viene connesso selezionare la casella di controllo Utenti cloud e fare clic su Salva.

    Questa immagine mostra il cassetto delle proprietà per il sito.

  7. Scegliere Pubblica nella barra delle azioni o nel menu di scelta rapida.

    Questa immagine mostra il passo per pubblicare il sito in Site Builder.

  8. Dopo la pubblicazione del sito Web, nella parte superiore della pagina viene visualizzata una notifica per confermarlo.

  9. Nella pagina Siti selezionare di nuovo il sito, quindi fare clic con il pulsante destro del mouse su Metti in linea nella barra delle azioni. Nella finestra di dialogo Metti in linea scegliere Confermare per procedere e fare clic su Metti in linea.

    Questa immagine mostra la procedura per connettere il sito.

    Questa immagine mostra la finestra di dialogo Porta in linea in Site Builder.

Si tratta di un'operazione molto semplice. Il sito web è ora in linea e altri utenti possono visualizzarlo.

Per visualizzare il sito Web, selezionare Visualizza nella barra delle azioni oppure fare clic con il pulsante destro del mouse oppure aprire l'URL nel broker Web.

Come utilizzare il chatbot

Ecco alcuni modi in cui puoi utilizzare il chatbot nel tuo sito: