• Canal web de Oracle. Al crear el canal se genera el ID de canal y la clave secreta necesarios para inicializar la aplicación de chat.
• URL del servidor de chat de Oracle.
• El SDK web de Oracle (ubicado en los SDK de cliente nativo de Oracle para entornos nativos de OCI) de la página de descarga de ODA y OMC de Oracle Technology Network. Descargue este ZIP y extráigalo en su sistema local. Este ZIP incluye una guía de usuario que describe las clases de SDK y una aplicación de ejemplo que demuestra muchas de sus funciones.

• La autenticación se aplica mediante tokens web de JSON (JWT). El servidor backend del cliente genera el token JWT, que luego se transfiere al SDK de Oracle Web. Este token se utiliza para cada solicitud a un servidor de voz, texto o anexos de ODA.

  Nota
  
  Para proteger el acceso al canal, el token siempre lo debe generar siempre un servidor remoto. Nunca debe generarse en el explorador del cliente.

  Cuando la aplicación web necesita conectarse a un servidor ODA, primero solicita el token del servidor backend y, a continuación, lo agrega a la cabecera de autorización. El servidor ODA valida el token, evalúa las reclamaciones y, a continuación, abre el socket o rechaza la conexión.

  Consejo:

  Este artículo le guiará a través de la ejecución del SDK con un canal autenticado.
• Modo no autenticado: utilice el modo no autenticado cuando el cliente no pueda generar tokens de JWT firmados, cuando no se aplique ningún mecanismo de autenticación o cuando el widget de cliente ya esté protegido y visible para los usuarios autenticados.

1. Seleccione Desarrollo y, a continuación, Canales en el menú.
2. Seleccione Usuarios.
3. Haga clic en Agregar canal y, a continuación, en Oracle Web como tipo de canal.
4. Complete el cuadro de diálogo:
   • Introduzca el nombre del canal.
   • Para conexiones autenticadas:
     • Active el conmutador Autenticación de cliente activada para determinar si el SDK se conecta a un canal con la autenticación de cliente activada.
     • El canal solo se comunicará con los sitios de los dominios que agregue como una lista separada por comas. Por ejemplo, *.corp.example.com, *.hdr.example.com. La introducción de un solo asterisco (*) permite el acceso sin restricciones al canal desde cualquier dominio. Normalmente, solo se introduce un asterisco durante el desarrollo. Para la producción, se agregaría una lista de permitidos de los dominios.
     • En el campo Caducidad máxima de token (minutos), defina la cantidad máxima de tiempo para el token de JWT.
   • Para conexiones no autenticadas:
     • Desactive el conmutador Activación de la autenticación del cliente.
     • Introduzca una lista separada por comas de los dominios que pueden acceder al canal. Si los dominios de esta lista de permitidos incluyen asteriscos (*.hdr.ejemplo.com) o si la lista de permitidos no se conoce por completo, puede considerar una conexión autenticada.
   • Defina la hora de caducidad de la sesión.
   • Haga clic en Crear. Oracle Digital Assistant generará el ID de canal y la clave secreta necesarios para inicializar el SDK. Manténgalos a mano porque los necesitará al configurar la página HTML para alojar el widget de chat.
5. Enruta el canal a su aptitud o asistente digital.
6. Active Canal activado.

1. En el archivo ZIP extraído del SDK web de Oracle descargado, localice el archivo web-sdk.js (ubicado en el directorio native-client-sdk-js).
2. Guarde web-sdk.js (situado en el directorio native-client-sdk-js del ZIP extraído) en el directorio del proyecto. Observe la ubicación del archivo, ya que tendrá que definir la propiedad <WebSDK URL> en el código de la etiqueta <script>.
3. Cree un archivo JavaScript con la siguiente función que inicializa el SDK. Este archivo se denomina settings.js en el ejemplo que se incluye con el SDK.

   //settings.js
   var chatSettings = {
       URI: '<Server URI>',
       channelId: '<Channel ID>',
       userId: '<User ID>'
   };
   
   function initSDK(name) {
       // If WebSDK is not available, reattempt later
       if (!document || !WebSDK) {
           setTimeout(function() {
               initSDK(name);
           }, 2000);
           return;
       }
   
       // Default name is Bots
       if (!name) {
           name = 'Bots';
       }
   
       setTimeout(function() {
           var Bots = new WebSDK(chatSettings);    // Initiate library with configuration
   
           var isFirstConnection = true;
           Bots.on(WebSDK.EVENT.WIDGET_OPENED, function() {
               if (isFirstConnection) {
                   Bots.connect()                          // Connect to server
                       .then(function() {
                           console.log('Connection Successful');
                       })
                       .catch(function(reason) {
                           console.log('Connection failed');
                           console.log(reason);
                       });
                      isFirstConnection = false;
               }
           });
   
           window[name] = Bots;
       }, 0);
   }

4. Defina las siguientes propiedades:
   • URI: nombre de host en la URL de instancia de Oracle Digital Assistant. Aquí solo se debe transferir la primera ruta (/). Puede transferir esta URL con o sin el protocolo (https://).
   • channelId: ID de canal que se genera al crear el canal web de Oracle. Esta propiedad es necesaria porque conecta el widget a la aptitud subyacente.
   • userId: ID de usuario. Al proporcionar este valor, las métricas de usuario únicas de Insights pueden realizar un seguimiento de la base de usuarios de esta aptitud. Si no proporciona un ID de usuario, pero el SDK generará uno con cada nueva sesión. Esta propiedad es opcional para conexiones no autenticadas.
5. En la página HTML, haga referencia a las ubicaciones del archivo JS (setting.js en el siguiente ejemplo) de la biblioteca web-sdk.js y del espacio de nombres del SDK web, que normalmente es Bots. Utilice este espacio de nombres para llamar a las API públicas. Por ejemplo, si define el espacio de nombres en Bots, llame a las API como Bots.<API>(). Para obtener más información sobre las distintas funciones y eventos, consulte la guía del usuario (disponible como archivo Léame y documento HTML) que se incluye en el archivo ZIP del SDK de Oracle Web.

      <script src="scripts/settings.js"></script>
      <script src="scripts/web-sdk.js" onload="initSdk('Bots')"></script>    

//settings.js
var chatSettings = {
    URI: '<Server URI>',
    clientAuthEnabled: true
};

function generateToken() {
    return new Promise(function(resolve) {
        fetch('https://yourbackend.com/endpointToGenerateJWTToken')
            .then(function(token) {
               resolve(token);
            })
            .catch(function(error) {
                console.log('Token generation error:', error);
            });
    });
}

function initSDK(name) {
    // If WebSDK is not available, reattempt later
    if (!document || !WebSDK) {
        setTimeout(function() {
            initSDK(name);
        }, 2000);
        return;
    }

    // Default name is Bots
    if (!name) {
        name = 'Bots';
    }

    setTimeout(function() {
        var Bots = new WebSDK(chatSettings, generateToken);    // Initiate library with configuration

        var isFirstConnection = true;
        Bots.on(WebSDK.EVENT.WIDGET_OPENED, function() {
            if (isFirstConnection) {
                Bots.connect()                          // Connect to server
                    .then(function() {
                        console.log('Connection Successful');
                    })
                    .catch(function(reason) {
                        console.log('Connection failed');
                        console.log(reason);
                    });
                   isFirstConnection = false;
            }
        });

        window[name] = Bots;
    }, 0);
}