La libreria WebhookClient nell'SDK Node.js di Oracle Digital Assistant semplifica l'impostazione dell'invio e della ricezione di messaggi nei canali Webhook. Se non si utilizza l'SDK, ecco cosa è necessario sapere sulla creazione di messaggi in entrata.

La chiamata per l'invio di messaggi al tuo assistente digitale (o abilità) deve avere:

1. Un'intestazione X-Hub-Signature contenente il valore SHA256 del payload. La chiamata include funzioni che creano questo hash utilizzando la chiave segreta come chiave.

   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 e BOT_WEBHOOK_SECRET sono variabili di ambiente impostate sul server Node. L'uso di queste variabili di ambiente consente di evitare di codificare le informazioni riservate direttamente nel webhook

2. Oggetto JSON con proprietà userId, profile e messagePayload:

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

   Proprietà	descrizione;	Digita	Richiesto?
   userId	Identificativo univoco dell'utente. Questo ID è specifico per il chiamante.	Stringa	Sì
   profile	Proprietà che rappresentano l'utente, ad esempio firstName e LastName.	Oggetto JSON	No
   messagePayload	Il valore messagePayload può essere text, postback, attachment e location.	Oggetto JSON	Sì

   Nota
   
   Se lo skill o l'assistente digitale deve rilevare la lingua utente, assicurarsi che profile.locale e profile.languageTag siano impostati su null nei messaggi del webhook.

La libreria WebhookClient nell'SDK Node.js di Oracle Digital Assistant semplifica l'impostazione dell'invio e della ricezione di messaggi nei canali Webhook. Se non si utilizza l'SDK, ecco cosa è necessario sapere sulla creazione di messaggi in uscita.

È necessario pubblicare le chiamate nel formato JSON previsto da Digital Assistant, insieme all'intestazione di autorizzazione.