Integración de Oracle Digital Assistant en un sitio web creado en Oracle Content Management

Introducción

A menudo, las organizaciones buscan crear sitios web de uso compartido de contenido (como sitios de marketing, portales de ventas y hubs de partners) para distribuir contenido a públicos internos o externos. Oracle Content Management ofrece herramientas con potentes funciones para crear dichos sitios web de uso compartido de contenido.

Los asistentes digitales y bots conversacionales permiten a los equipos de ventas y marketing acelerar su expansión empresarial digital y mejorar la experiencia de sus clientes.

Oracle Digital Assistant es una plataforma que permite crear y desplegar asistentes digitales, que son interfaces basadas en inteligencia artificial que ayudan a los usuarios a realizar una variedad de tareas en conversaciones de lenguaje natural. Pero, ¿qué sucede cuando se necesita un sistema de gestión de contenido (CMS) para servir todo el contenido? Afortunadamente, Oracle Content Management, con sus completas capacidades de CMS sin cabecera, tiene una solución elegante para todas sus necesidades de administración y gobernanza de contenido.

En este tutorial, primero crearemos un bot conversacional en Oracle Digital Assistant con Oracle Content Management como CMS sin cabecera, así como su kit de desarrollo de software (SDK) para la entrega de contenido en JavaScript. A continuación, utilizaremos Site Builder de Oracle Content Management para crear y editar un sitio web de activación de ventas y agregar el bot conversacional mediante un componente personalizado de Oracle Content Management.

El tutorial consta de cuatro pasos:

  1. Configure el sitio web de habilitación de ventas de Café Supremo.
  2. Crear la habilidad de Oracle Digital Assistant.
  3. Configurar el componente personalizado de Oracle Content Management
  4. Agregar el componente personalizado al sitio web

Requisitos

Antes de continuar con este tutorial, le recomendamos que lea primero la siguiente información:

Para seguir este tutorial, necesitará:

Lo que estamos creando

Café Supremo es una cadena de cafeterías ficticia, que tiene tiendas en todo el mundo. El sitio web de habilitación de ventas de Café Supremo se crea con Oracle Content Management.

El sitio web de habilitación de ventas Café Supremo permite a los representantes de ventas de la compañía Café Supremo de todo el mundo obtener toda la información que necesitan sobre las ventas. Para ver una introducción al sitio web de habilitación de ventas de Café Supremo, consulte Más información sobre la creación de un sitio web de habilitación de ventas.

Se trata de una versión mejorada del sitio de habilitación de ventas de Café Supremo, que incluye un bot conversacional desarrollado con Oracle Digital Assistant (ODA) que extrae el contenido de un canal de Oracle Content Management.

Este es el aspecto que tendrá el sitio de activación de ventas al final de este tutorial:

En esta imagen se muestra la página de llegada del sitio de activación de ventas con la ventana de bots conversacionales abierta y una conversación continua.

Tarea 1: configurar el sitio web de habilitación de ventas de Café Supremo

En esta sección, podrá configurar el sitio web de habilitación de ventas de Café Supremo utilizando Oracle Content Management.

Para comenzar, deberá descargar el archivo zip con la plantilla y el código de muestra del sitio web de habilitación de ventas de Café Supremo en la página de descargas de Oracle Content Management. Una vez que haya obtenido una copia de la plantilla, cárguela en Oracle Content Management, donde la utilizará para crear el sitio web de activación de ventas.

El archivo zip contiene un archivo Readme (Léame), archivos de licencia y el archivo zip de plantilla.

Nota: Las imágenes utilizadas en la plantilla de ejemplo y en el sitio web de habilitación de ventas de Café Supremo son imágenes de Shutterstock. Para reutilizar estas imágenes, debe tener una licencia de Shutterstock. Puede reemplazarlas por sus propias imágenes.

Para configurar el sitio web de habilitación de ventas de referencia de Café Supremo:

  1. Conéctese a Oracle Content Management como administrador. Si no ve una sección ADMINISTRATION en el menú de navegación izquierdo de la interfaz web de Oracle Content Management, no tiene privilegios de administrador. En ese caso, póngase en contacto con el administrador de servicio.

  2. En el menú de navegación de la izquierda, haga clic en Desarrollador y, a continuación, en Ver todas las plantillas.

En esta imagen se muestra la página Desarrollador de la interfaz web de Oracle Content Management, con enlaces a componentes, plantillas, temas e interfaz de usuario embebible.

  1. En la página Plantillas, haga clic en Crear y seleccione Importar un paquete de plantillas.

  2. En el cuadro de diálogo Seleccionar un archivo, navegue hasta la carpeta en la que desea cargar el archivo o crear una nueva carpeta y haga clic en Cargar.

  3. Busque y seleccione el paquete de plantillas CafeSupremoSalesEnablement.zip y haga clic en Abrir. Espere a que se cargue el archivo. Una vez cargado el archivo, estará disponible para su selección.

  4. Seleccione la casilla de control CafeSupremoSalesEnablement.zip y haga clic en Aceptar. La plantilla CafeSupremoSalesEnablement ahora se incluye en la lista de plantillas de la página Plantillas.

  5. Haga clic en Contenido en ADMINISTRATION en el menú de navegación de la izquierda.

  6. Ahora, cree un repositorio, que es una ubicación de almacenamiento para gestionar todos los activos digitales que utiliza en su sitio web en un solo lugar:

    1. Seleccione Repositorios en la lista desplegable y haga clic en Crear en la esquina superior derecha.

    2. En el campo Nombre, introduzca un nombre de repositorio significativo para su sitio web (por ejemplo, 'CafeSupremoSalesEnablement Repositorio').

    3. En el campo Idioma por defecto, asegúrese de que Inglés (Estados Unidos) (en-US) esté seleccionado.

    4. Haga clic en Guardar. El repositorio recién creado ahora se incluye en la lista de repositorios de la página Contenido.

    En esta imagen se muestra la página Crear repositorio de activos en la interfaz web de Oracle Content Management.

  7. Haga clic en Sitios en el menú de navegación de la izquierda.

  8. En la página Sites, haga clic en Crear en la esquina superior derecha.

En esta imagen se muestra la página de llegada de Sites en la interfaz web de Oracle Content Management, con un botón Create en la esquina superior derecha.

  1. En el cuadro de diálogo Crear sitio, seleccione la plantilla CafeSupremoSalesEnablement.

  2. Complete los siguientes campos:

    • Repositorio de activos: seleccione el repositorio de activos que ha creado anteriormente (por ejemplo, 'CafeSupremoSalesEnablement Repository').

    • Política de localización: la política de localización se selecciona automáticamente porque está disponible como parte del código de ejemplo y la plantilla.

    • Idioma por defecto: este campo se define en inglés (Estados Unidos) (en-US) por defecto.

En esta imagen, se muestra la página Crear sitio en la interfaz web de Oracle Content Management.

  1. Haga clic en Siguiente y agregue detalles al sitio:

    • Nombre: introduzca un nombre para su sitio web (por ejemplo, CafeSupremoSalesEnablement).

    • Prefijo para valores de URL fáciles de recordar: se agregará a los valores de URL fáciles de recordar para los elementos de contenido.

    • Descripción: proporcione una descripción opcional del sitio.

    En esta imagen, se muestra la página de detalles del sitio en la interfaz web de Oracle Content Management.

  2. Haga clic en Crear.

El sitio web de activación de ventas se ha creado y ahora se muestra en la página Sitios.

Tarea 2: Creación de la habilidad de Oracle Digital Assistant

Para consumir nuestro contenido de Oracle Content Management en una aplicación de bot conversacional de ODA, podemos utilizar el ejemplo de bot conversacional de ODA de Oracle Content Management, disponible en un repositorio de código abierto en GitHub.

Nota: Recuerde que el uso del ejemplo de bot conversacional de ODA es opcional y lo utilizamos en este tutorial para empezar a utilizarlo rápidamente. También puede crear su propia aplicación de bot conversacional.

Para crear la aptitud del bot conversacional en ODA:

  1. Clonar el repositorio de ejemplo
  2. Importar la aptitud de ODA a su instancia
  3. Configurar y configurar el servicio de componentes personalizados
  4. Trabajar con el SDK de contenido
  5. Utilizar el SDK de contenido para recuperar el contenido
  6. Empaquetar y desplegar el servicio de componentes personalizados

Clonación del repositorio de ejemplo

El ejemplo de bot conversacional de ODA de Oracle Content Management está disponible en un repositorio de código abierto en GitHub. Primero deberá clonar el repositorio de ejemplo de GitHub en la computadora local y cambiar el directorio para trabajar con este ejemplo.

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

Ahora que tiene su base de código, veamos de cerca las carpetas que utilizará en este tutorial:

Nota: La carpeta headless-chatbot-sample forma parte del ejemplo de bot conversacional sin cabecera. Puede obtener más información sobre este ejemplo de bot conversacional sin cabecera aquí.

Importar la aptitud ODA a la instancia

La carpeta SalesEnablementChatbotIntegration es la aptitud ODA utilizada en este tutorial. Siga estos pasos para crear y entrenar la aptitud en la instancia de ODA:

  1. En la instancia de Oracle Digital Assistant, abra el menú de navegación de la izquierda, haga clic en Desarrollo y, a continuación, en Aptitudes.

    En esta imagen se muestra la instancia de Oracle Digital Assistance con el menú de navegación izquierdo abierto y la opción Aptitudes resaltada.

  2. Busque la aptitud Integración de bot conversacional para la activación de ventas.

    Nota: si la instancia no tiene esta aptitud, seleccione el contenido de la carpeta SalesEnablementChatbotIntegration y compríquelos en un único archivo zip. En la página Aptitudes de la instancia de ODA, haga clic en Importar aptitud e importe el archivo zip que acaba de crear. Al comprimir directamente la carpeta SalesEnablementChatbotIntegration, se producirá un error al importar.

  3. En la tarjeta de aptitudes Integración de bot conversacional de activación de ventas, haga clic en el icono de opciones y, a continuación, en Clonar.

    En esta imagen se muestra el menú contextual de una aptitud Integración de bot conversacional de activación de ventas.

  4. Asigne a la aptitud clonada un nombre mostrado único; por ejemplo, agregue sus iniciales al principio, como "AB - Integración de bot conversacional de activación de ventas". Deje todos los demás valores sin cambios. Seleccione Abrir aptitud clonada posteriormente y, a continuación, haga clic en Clonar.

    Nota: El nombre debe comenzar con una letra y solo puede contener letras, números, puntos y caracteres de subrayado. No puede superar los 100 caracteres.

    En esta imagen se muestra el cuadro de diálogo para crear un clon de aptitud.

  5. Haga clic en Entrenar, asegúrese de que se ha seleccionado Trainer Ht y, a continuación, haga clic en Enviar para entrenar la aptitud.

    Nota: En este tutorial, se utiliza la formación Ht, que es rápida pero superficial. Para el trabajo de producción, debe utilizar el entrenamiento de Tm, lo que da como resultado una mejor resolución de intenciones.

    En esta imagen se muestran las opciones de formación de la aptitud.

Habilidad de integración de bots conversacionales de activación de ventas

Las aptitudes son bots conversacionales individuales que se han diseñado para interactuar con los usuarios y realizar tipos específicos de tareas, como pedidos de comida, reservas y cambios en la información de contacto. La aptitud ODAChatbot ayuda a un usuario a encontrar anuncios e historias de activación de ventas adecuados mediante una combinación de mensajes de texto y elementos de interfaz de usuario simples, como listas de selección.

Antes de entrar en el asistente digital y el desarrollo de aptitudes, debería familiarizarse con estos conceptos:

Para obtener más información sobre Oracle Digital Assistant y sus aptitudes, consulte la documentación del producto.

Configuración y configuración del servicio de componentes personalizados

La carpeta oda-custom-component de la base de códigos es el componente personalizado de ODA que se utiliza para recuperar contenido de un canal seguro en OCM. En primer lugar, necesitamos descargar dependencias para este componente personalizado de ODA. Ejecute el siguiente comando desde el directorio site-integration-chatbot-sample/oda-custom-component:

npm install

A continuación, debemos configurar algunos datos para que nuestro SDK de Oracle Content Management Content (y cualquier otra solicitud) pueda dirigirse a la URL de instancia y la versión de API correctas con el token de canal correcto.

Estos valores se utilizan en los componentes/server-config-utils.js para instanciar un nuevo cliente de entrega.

Abra el archivo server-config-utils.js en un editor de texto. Verá lo siguiente:


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

Cambie cada par clave-valor para reflejar la URL de la instancia, la versión de API a la que desea dirigirse y el token de canal asociado al canal de publicación del sitio CafeSupremoSalesEnablement.

Trabajar con el SDK de Oracle Content Management Content

Oracle Content Management ofrece un SDK para ayudar a detectar y utilizar contenido en sus aplicaciones. El SDK se publica como un módulo NPM y el proyecto se aloja en GitHub.

Obtenga más información sobre el SDK aquí.

El SDK se ha registrado como una dependencia de tiempo de ejecución del componente personalizado de ODA en el archivo package.json.

Uso del SDK de contenido para recuperar el contenido

Ahora podemos aprovechar el SDK de contenido para recuperar el contenido de la aptitud del bot conversacional a través del componente personalizado de ODA.

La carpeta Components/services.js contiene el código para obtener datos de Oracle Content Management mediante el SDK de contenido.

El archivo component/server-config-utils.js importa el SDK de contenido y, a continuación, crea un cliente de entrega mediante la configuración especificada en él.

El siguiente comando importa el SDK:

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

El siguiente comando crea el cliente de entrega:

deliveryClient = createDeliveryClient(serverconfig);

El archivo component/services.js contiene todo el código para obtener los elementos de contenido para el bot conversacional. Hay una función principal para recuperar todo el contenido del bot conversacional.

Se llaman las siguientes funciones para recuperar todos los datos de una categoría de taxonomía concreta del repositorio 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 función getStoryData realiza dos juegos diferentes de llamadas en función de si se realiza la solicitud para la categoría announcements o story.

Datos de anuncios

Necesita una llamada de datos para obtener todos los elementos de contenido para los anuncios.

La función getStoryData llama a fetchItemsForAnnouncements, que obtiene todos los elementos de contenido del tipo 'SE2-Announcements'. A continuación, se llama a la función retrieveAnnouncementsObject y los campos de título y resumen del objeto de resultado se rellenan con los datos de fetchItemsForAnnouncements.

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

Datos de historia

Necesita varias llamadas de datos para obtener todos los elementos de contenido de las historias.

  1. En primer lugar, se obtienen todos los elementos de contenido para la categoría solicitada por el usuario.

  2. Para cada elemento de contenido que obtenemos, hacemos una llamada para recuperar la URL de medios.

La función getStoryData llama a fetchItemsForCategoryName, que obtiene todos los elementos de contenido de tipo 'SE2-Story' y el nombre de categoría de taxonomía, según lo especificado por el usuario.

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,
     });
    }

El elemento de contenido recuperado por fetchItemsForCategoryName tiene un campo de ID de medio. La función retrieveMediaURL utiliza este identificador de medio para recuperar la URL de medio.

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];
     });
    }

Empaquetado y despliegue del servicio de componentes personalizados

Puede desplegar componentes personalizados en un contenedor embebido para una aptitud, un servidor de nodos remoto u Oracle Mobile Hub. En este tutorial, desplegará el servicio de componentes personalizados en un contenedor embebido. Para ello, primero debe empaquetar el servicio de componentes personalizados en un archivo desplegable:

  1. Guarde el trabajo en el IDE de JavaScript.

  2. Abra una ventana de terminal y navegue hasta la carpeta site-integration-chatbot-sample/oda-custom-component.

  3. En la carpeta oda-custom-component, introduzca el siguiente comando npm

    bots-node-sdk pack

    Debido a la secuencia de comandos prepack en el archivo package.json, el comando ejecuta primero el comando prepack para verificar el paquete. A continuación, el comando empaqueta el proyecto Node y sus dependencias en un tarball desplegable denominado oda-custom-component-1.0.0.tgz.

    El tarball debe incluir todas las dependencias, excepto devDependencies.

  4. En la aptitud del bot conversacional de la instancia de ODA, haga clic en el icono Componentes de la barra izquierda para abrir la página de servicio del componente. Haga clic en + Servicio para crear un nuevo servicio.

    Esta imagen muestra una página de servicios vacía para una aptitud.

  5. En el cuadro de diálogo Crear servicio, haga lo siguiente:

    1. En el campo Name, introduzca SalesEnablementCustomComponent.

    2. En el campo Descripción, puede agregar una descripción opcional.

    3. Asegúrese de que la opción Contenedor embebido esté seleccionada.

    4. Arrastre y suelte o cargue el archivo oda-custom-component-1.0.0.tgz en el campo Archivo de paquete.

    5. Haga clic en Crear.

En esta imagen se muestra el cuadro de diálogo Crear servicio.

  1. Espere a que el campo Estado muestre Listo, que puede tardar unos segundos.

  2. Con el servicio de componentes personalizados desplegado en el contenedor incrustado de la aptitud, está listo para probar el componente.

Para obtener más información sobre Oracle Digital Assistant y los componentes personalizados, consulte la documentación de formación.

Creación de un canal web de Oracle Digital Assistant

Creará un canal de usuario de Oracle Digital Assistant que permita que un cliente web de Oracle acceda a la aptitud. Para garantizar que solo sus clientes web puedan utilizar este canal, lo configurará para requerir autenticación de cliente.

  1. En la instancia de Oracle Digital Assistant, abra el menú de navegación de la izquierda, haga clic en Desarrollo y, a continuación, en Canales.

    En esta imagen se muestra la instancia de asistencia digital de Oracle con el menú de navegación izquierdo abierto y la opción Canales resaltada.

  2. En la página Canales, haga clic en + Canal para agregar un canal.

  3. En la página Crear canales, introduzca esta información como se muestra en la captura de pantalla siguiente:

    • Nombre: nombre único que comienza con una letra y contiene solo letras, números, puntos y guiones bajos (_), por ejemplo, AB_SalesEnablementChatbotIntegration.
    • Descripción: (opcional) para qué se utiliza el canal.
    • Tipo de canal: Oracle Web.
    • Dominios permitidos: * (un solo asterisco permite cualquier dominio).
    • Autenticación de cliente activada: déjela en la posición desactivada.

    En esta imagen se muestra la instancia de asistencia digital de Oracle con el menú de navegación izquierdo abierto y la opción Canales resaltada.

  4. Haga clic en Crear.

  5. En la lista desplegable Direccionar a, seleccione la aptitud que ha creado para este tutorial.

    En esta imagen se muestra la página Canales con la lista desplegable Direccionar a abierta.

  6. Active la opción Canal activado.

  7. Observe el ID de canal que se muestra para este canal. Posteriormente, en este tutorial, utilizará este valor en la aplicación web.

    En esta imagen se muestra la página Canales con la información de enrutamiento del bot conversacional.

  8. Observe también el host y el dominio de Oracle Digital Assistant (al que se hace referencia como el nombre de dominio completo) de la URL de instancia que aparece en el campo de dirección del explorador web, por ejemplo oda-xxxx.data.digitalassistant.oci.oraclecloud.com. Utilizará este valor más adelante en el tutorial.

La instancia ahora está configurada para que conecte un bot conversacional del sitio web a la aptitud.

Tarea 3: Configuración del componente personalizado de Oracle Content Management

Ahora debe importar el componente personalizado SE2-ODA-Chatbot en la instancia de Oracle Content Management.

La configuración del componente personalizado de Oracle Content Management es un proceso de tres pasos:

  1. Agregar SDK web de Oracle Digital Assistant
  2. Importe el componente personalizado SE2-ODA-Chatbot
  3. Publique el componente personalizado SE2-ODA-Chatbot

Agregar SDK web de Oracle Digital Assistant

Necesitamos agregar el archivo web-sdk.js de ODA en el componente personalizado SE2-ODA-Chatbot. El SDK se conecta al servidor de chat de Oracle, que se encuentra entre Oracle Digital Assistant y la aptitud (o asistente digital). A continuación, el servidor de chat transfiere los mensajes a la aptitud para el procesamiento y entrega la respuesta de la aptitud al cliente.

  1. Descargue la última versión del SDK web de Oracle y descomprímala en una carpeta de su elección. También puede ir a la página de descarga de este SDK desde la instancia de Digital Assistant abriendo el menú lateral y, a continuación, haciendo clic en Downloads.

  2. Copie el archivo nativo-client-sdk-js/web-sdk.js de la carpeta Oracle Web SDK y colóquelo en la carpeta SE2-ODA-Chatbot/assets/chatbot.

En esta imagen se muestra el archivo web-sdk en la carpeta SE2-ODA-Chatbot/assets/chatbot.

Importar el componente personalizado SE2-ODA-Chatbot

Para importar el componente personalizado SE2-ODA-Chatbot:

  1. Navegue hasta la carpeta site-integration-chatbot-sample y comprima la carpeta SE2-ODA-Chatbot en un archivo zip.

  2. Conéctese a la interfaz web de Oracle Content Management como administrador.

  3. Haga clic en Developer en el menú de navegación izquierdo y, a continuación, en View All Components. Si no puede ver la opción Desarrollador, no tiene los roles de usuario necesarios.

  4. En la página Componentes, haga clic en Crear y seleccione Importar componente.

    En esta imagen se muestra la página Componentes con el menú desplegable Crear abierto. En la parte inferior de ese menú desplegable se encuentra la opción Importar componente.

  5. Vaya a la carpeta de la instancia de Oracle Content Management en la que desea cargar el componente o crear una nueva carpeta. Haga clic en Cargar y, a continuación, busque el archivo SE2-ODA-Chatbot.zip y haga clic en Abrir.

  6. Seleccione el archivo SE2-ODA-Chatbot.zip y haga clic en Aceptar.

    En esta imagen se muestra la página Seleccionar un archivo con el archivo SE2-ODA-Chatbot.zip seleccionado y la opción Aceptar activada.

Si el nombre o el ID del componente o diseño ya existen, se le solicita que resuelva los conflictos. Es posible que necesite crear un nuevo componente, o bien, puede sobrescribir el componente existente con la versión importada.

Una vez que el componente SE2-ODA-Chatbot se ha cargado correctamente, se muestra en la página Componentes.

Publique el componente personalizado SE2-ODA-Chatbot

A continuación, debe publicar el componente SE2-ODA-Chatbot que ha importado:

  1. En la página Componentes, seleccione el componente SE2-ODA-Chatbot y haga clic en Publicar en la barra de acciones o en el menú contextual.

    En esta imagen se muestra la página Componentes con el componente SE2-ODA-Chatbot seleccionado y la opción Publicar activada.

  2. En el cuadro de diálogo Publicar componente, seleccione Confirmar para continuar y haga clic en Aceptar.

    En esta imagen se muestra la página Publicar componente con la casilla de control 'Confirmar para continuar' seleccionada y el botón Aceptar activado.

Una vez publicado el componente SE2-ODA-Chatbot, se muestra una notificación en la parte superior de la página para confirmarlo.

Tarea 4: Adición del componente personalizado al sitio web

Como paso final, agregaremos el componente personalizado SE2-ODA-Chatbot al sitio de activación de ventas arrastrándolo y soltándolo en Site Builder.

Agregar nuestro bot conversacional al sitio de activación de ventas es un proceso de dos pasos:

  1. Editar el sitio web
  2. Publicar el sitio web

Edición del sitio web

El primer paso es agregar un bot conversacional al sitio de activación de ventas mediante el componente personalizado SE2-ODA-Chatbot:

  1. Conéctese a la interfaz web de Oracle Content Management y abra la página Sites.

  2. Seleccione el sitio web que acaba de crear y elija Abrir en la barra de acciones o haga clic con el botón derecho en el menú para abrirlo en Site Builder.

  3. Ponga el sitio en modo de edición alternando el conmutador Ver/Editar.

  4. Introduzca un nombre para la actualización y haga clic en Aceptar.

  5. En la barra lateral izquierda, haga clic en Componentes y, a continuación, en Personalizar para mostrar la lista de componentes personalizados.

    En esta imagen se muestra la lista de componentes de Site Builder con la opción Personalizado seleccionada.

  6. Ahora agregemos un widget de bot conversacional de ODA a la página inicial mediante el componente personalizado SE2-ODA-Chatbot. Arrastre y suelte el componente SE2-ODA-Chatbot en cualquier parte de la página. Haga clic en el título del componente SE2-ODA-Chatbot para asegurarse de que su principal es lo que desea. Es una forma muy útil de ver si algún componente reside dentro de la estructura de la página web.

    En esta imagen se muestra el componente personalizado en una página web de Site Builder.

    Complete la configuración personalizada en el separador General:

    • URI de ODA: URL de instancia de ODA (sin http://).
    • ID de canal: ID de canal web de ODA.
    • Título del bot conversacional: título del widget de chat que se muestra en la cabecera.
    • Configuración de bot conversacional: si lo desea, proporcione cualquier configuración adicional para el bot conversacional de ODA como objeto JSON (utilice comillas dobles para cualquier cadena de clave y valor).

Repita los pasos anteriores para agregar el bot conversacional en cualquier página de su sitio web.

Publicar sitio web

Ahora que ha agregado correctamente el bot conversacional a su sitio web, puede publicarlo para que esté disponible en línea y los usuarios lo puedan ver.

  1. Una vez que todo se muestre correctamente, confirme los cambios en el sitio web base haciendo clic en Confirmar en la esquina superior derecha de Site Builder.

    En esta imagen se muestra el paso para confirmar los cambios en Site Builder.

  2. En el cuadro de diálogo Confirmar actualización, haga clic en Confirmar.

    En esta imagen se muestra el cuadro de diálogo de confirmación en Site Builder.

  3. Una vez que haya confirmado los cambios, el sitio web estará listo para su publicación. Cierre Site Builder.

  4. Haga clic en Sitios en el menú de navegación izquierda, en la interfaz web de Oracle Content Management, y seleccione el sitio web.

  5. Haga clic en Barra lateral en la barra de menús y, a continuación, seleccione Propiedades o Propiedades en el menú contextual.

    En esta imagen se muestra el botón de propiedades de su sitio.

  6. En el cuadro de diálogo de propiedades, haga clic en el separador Seguridad y, a continuación, seleccione Sí en el campo Requerir que todos inicien sesión para acceder a este sitio. En el campo ¿Quién puede acceder a este sitio cuando esté en línea?, seleccione la casilla de control Usuarios en la nube y haga clic en Guardar.

    En esta imagen se muestra el cajón de propiedades del sitio.

  7. Seleccione Publicar en la barra de acciones o el menú contextual.

    En esta imagen se muestra el paso para publicar su sitio en Site Builder.

  8. Una vez que se haya publicado el sitio web, se mostrará una notificación en la parte superior de la página para confirmarlo.

  9. En la página Sitios, vuelva a seleccionar el sitio web y, a continuación, elija Poner en línea en la barra de acciones o en el menú contextual. En el cuadro de diálogo Poner en línea, seleccione Confirmar para continuar y haga clic en Poner en línea.

    En esta imagen se muestra el paso para poner su sitio en línea.

    En esta imagen se muestra el cuadro de diálogo Colocar en línea en Site Builder.

Eso es todo. Su sitio web ya está en línea y otros pueden verlo.

Para ver su sitio web, seleccione Ver en la barra de acciones o el menú contextual, o abra la URL en el explorador web.

Cómo utilizar el bot conversacional

A continuación se muestran algunas formas en las que puede utilizar el bot conversacional de su sitio: