La biblioteca WebhookClient del SDK de Node.js de Oracle Digital Assistant simplifica la configuración del envío y la recepción de mensajes en canales de webhook. Si no utiliza el SDK, esto es lo que necesita saber sobre la creación de mensajes entrantes.

La llamada para enviar mensajes al asistente digital (o aptitud) debe incluir estos elementos:

1. Una cabecera X-Hub-Signature que contenga el valor SHA256 de la carga útil. La llamada incluye funciones que crean este valor hash utilizando la clave secreta como clave.

   const body = Buffer.from(JSON.stringify(messageToBot), 'utf8');
       const headers = {};
       headers['Content-Type'] = 'application/json; charset=utf-8';
       headers['X-Hub-Signature'] = buildSignatureHeader(body, channelSecretKey);
   
   ...
   
   function buildSignatureHeader(buf, channelSecretKey) {
       return 'sha256=' + buildSignature(buf, channelSecretKey);
   }
   
   function buildSignature(buf, channelSecretKey) {
       const hmac = crypto.createHmac('sha256', Buffer.from(channelSecretKey, 'utf8'));
       hmac.update(buf);
       return hmac.digest('hex');
   }

   BOT_WEBHOOK_URL y BOT_WEBHOOK_SECRET son variables de entorno que se establecen en el servidor de nodo. El uso de estas variables de entorno le permite evitar la codificación de la información confidencial directamente en el webhook.

2. Un objeto JSON con las propiedades userId, profile y messagePayload:

   {
    "userId": "33c0bcBc8e-378c-4496-bc2a-b2b9647de2317",
    "profile": {
       "firstName": "Bob",
       "lastName": "Franklin",
       "age": 45
      },
    "messagePayload": {....}
   }

   Propiedad	Descripción	Tipo	¿Obligatoria?
   userId	Identificador único para el usuario. Este ID es específico del emisor de llamada.	Cadena	Sí
   profile	Propiedades que representan al usuario, como firstName y LastName.	Objeto JSON	No
   messagePayload	El valor de messagePayload puede ser text, postback, attachment y location.	Objeto JSON	Sí

   Nota
   
   Si la aptitud o el asistente digital necesita detectar el idioma del usuario, asegúrese de que profile.locale y profile.languageTag están definidos como nulos en los mensajes de webhook.

La biblioteca WebhookClient del SDK de Node.js de Oracle Digital Assistant simplifica la configuración del envío y la recepción de mensajes en canales de webhook. Si no utiliza el SDK, esto es lo que debe saber sobre la creación de mensajes salientes.

Debe publicar las llamadas en el formato JSON que espera Digital Assistant, junto con la cabecera de autorización.