Trasmissione degli attributi di contatto durante l'inizializzazione di una chat

Puoi utilizzare gli attributi del contatto per acquisire informazioni sul contatto che utilizza il widget di comunicazione. È quindi possibile visualizzare tali informazioni all'agente tramite il Pannello di controllo dei contatti (CCP) o utilizzarle altrove nel flusso.

Ad esempio, puoi personalizzare il flusso in modo da pronunciare il nome del cliente nel messaggio di benvenuto. In alternativa, puoi utilizzare attributi specifici della tua attività, come account/membroIDs, identificativi dei clienti come nomi ed e-mail o altri metadati associati a un contatto.

Come trasferire gli attributi del contatto nel widget di comunicazione

1. Se non è già stato fatto, abilita la sicurezza nel widget di comunicazione come descritto in Aggiunta di un'interfaccia utente di chat al sito web:

   1. Al passaggio 2, in Aggiungi le funzionalità di sicurezza per il tuo widget di chat, scegli Sì.

   2. Nel passaggio 3, utilizza la chiave di sicurezza per generare token web. JSON

2. Aggiungi gli attributi di contatto al payload del tuo JWT reclamo. attributes

   Di seguito è riportato un esempio di come è possibile generare un JWT con attributi di contatto in Python:

   import jwt
   
   CONNECT_SECRET = "your-securely-stored-jwt-secret"
   
   payload = {
     'sub': 'widget-id',
     'iat': datetime.datetime.utcnow(),
     'exp': datetime.datetime.utcnow() + datetime.timedelta(seconds=500),
     'attributes': {"name": "Jane", "memberID": "123456789", "email": "[e-mail]", "isPremiumUser": "true", "age": "45"}
   }
   
   header = {
     'typ': "JWT",
     'alg': 'HS256'
   }
   
   encoded_token = jwt.encode((payload), CONNECT_SECRET, algorithm="HS256", headers=header)
   

   Nel payload, devi creare una chiave stringa attributes (così com'è, tutta in minuscolo), con un oggetto come valore. Quell'oggetto deve avere coppie string-to-string chiave-valore. Se in uno degli attributi viene trasmesso qualcosa di diverso da una stringa, la chat non verrà avviata.

   Gli attributi dei contatti devono rispettare le limitazioni stabilite da: StartChatConnectAPI

   • Le chiavi devono avere una lunghezza minima pari a 1

   • I valori possono avere una lunghezza minima pari a 0

Metodo alternativo: passa gli attributi dei contatti direttamente dal codice dello snippet

Nota

• Il codice dello snippet viene aggiunto HostedWidget- a tutte le chiavi degli attributi di contatto che passa. Nell'esempio seguente, la parte agente vedrà la coppia chiave-valore. HostedWidget-foo: 'bar'

• Sebbene questi attributi rientrino nell'ambito del HostedWidget- prefisso, sono comunque modificabili a seconda del sito client. Usa la JWT configurazione se hai bisogno di dati immutabili nel tuo PII flusso di contatti.

L'esempio seguente mostra come passare gli attributi dei contatti direttamente dal codice dello snippet senza abilitare la sicurezza dei widget.

<script type="text/javascript">
  (function(w, d, x, id){ /* ... */ })(window, document, 'amazon_connect', 'widgetId');
  amazon_connect('snippetId', 'snippetId');
  amazon_connect('styles', /* ... */);
  // ...

  amazon_connect('contactAttributes', {
   foo: 'bar'
  })
<script/>

Utilizzo degli attributi nei flussi di contatto

Il blocco di flusso Check contact attributes fornisce l'accesso a questi attributi tramite lo spazio dei nomi definito dall'utente, come mostrato nell'immagine seguente. È possibile utilizzare il blocco di flusso per aggiungere una logica di ramificazione. Il percorso completo è$.Attributes.HostedWidget-attributeName.

Cose da sapere

• Il widget di comunicazione ha un limite di 6.144 byte per l'intero token codificato. Poiché JavaScript utilizza la codifica UTF -16, vengono utilizzati 2 byte per carattere, quindi la dimensione massima deve essere di circa 3000 caratteri. encoded_token

• L'encoded_token deve essere trasmesso a callback(data). Il frammento authenticate non necessita di ulteriori modifiche. Per esempio:

  amazon_connect('authenticate', function(callback) {
    window.fetch('/token').then(res => {
      res.json().then(data => {
        callback(data.data);
      });
    });
  });

• L'utilizzo degli attributi di contatto JWT a to pass garantisce l'integrità dei dati. Se salvaguardi il segreto condiviso e segui le pratiche di sicurezza appropriate, puoi contribuire a garantire che i dati non possano essere manipolati da un malintenzionato.

• Gli attributi di contatto sono codificati solo inJWT, non crittografati, quindi è possibile decodificare e leggere gli attributi.

• Se desideri testare l'esperienza di chat con l'esperienza di chat simulata e includere gli attributi di contatto, assicurati di racchiudere sia la chiave sia il valore tra virgolette, come mostrato nell'immagine seguente.