La bibliothèque WebhookClient de la trousse SDK Node.js d'Oracle Digital Assistant simplifie la configuration de l'envoi et de la réception de messages dans les canaux Webhook. Si vous n'utilisez pas la trousse SDK, voici ce que vous devez savoir sur la création de messages entrants.

L'appel pour envoyer des messages à votre assistant numérique (ou compétence) doit comporter :

1. Un en-tête X-Hub-Signature contenant la valeur SHA256 des données utiles. L'appel comprend des fonctions qui créent ce code de hachage en utilisant la clé secrète comme clé.

   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 et BOT_WEBHOOK_SECRET sont des variables d'environnement que vous avez définies sur le serveur Node.js. L'utilisation de ces variables d'environnement vous évite de coder de façon permanente les informations sensibles directement dans le webhook

2. Un objet JSON avec les propriétés userId, profile et messagePayload :

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

   Propriété	Description	Type	Obligatoire?
   userId	Identificateur unique de l'utilisateur. Cet ID est propre à l'appelant.	Chaîne	Oui
   profile	Propriétés qui représentent l'utilisateur, comme firstName et LastName.	Objet JSON	Non
   messagePayload	Les données utiles du message, messagePayload, peuvent être text. postback, attachment et location.	Objet JSON	Oui

   Note
   
   Si votre compétence ou votre assistant numérique doit détecter la langue de l'utilisateur, assurez-vous que profile.locale et profile.languageTag sont réglés à une valeur nulle dans les messages du webhook.

La bibliothèque WebhookClient de la trousse SDK Node.js d'Oracle Digital Assistant simplifie la configuration de l'envoi et de la réception de messages dans les canaux Webhook. Si vous n'utilisez pas la trousse SDK, voici ce que vous devez savoir sur la création de messages sortants.

Vous devez publier les appels au format JSON attendu par Digital Assistant, ainsi que l'en-tête d'autorisation.