13

API Javascript

Ultimo aggiornamento 25 giorni fa

Come massimizzare il widget al caricamento del sito web Come massimizzare il widget dopo l'invio di un trigger Personalizzazione del tuo z-index con l'API JavaScript Impostare il nome e l' indirizzo e-mail di un visitatore nel modulo di pre-chat utilizzando l'API JavaScript Cambiare il widget o la proprietà in base alla lingua della pagina

Come utilizzare setAttributes() con un hash nell'API JavaScript

Le istruzioni qui sotto sono valide solo per desktop e laptop.

Puoi usare il setAttributes() puoi usare la funzione nel nostro JavaScript API puoi usare la funzione nel nostro widget di chat tawk.to per modificare i dettagli dei clienti, come nome e indirizzo email.

Utilizzando un hash con il setAttributes() La funzione è un ottimo modo per proteggere i dati dei clienti. Un hash è una potente funzione di sicurezza che rappresenta una combinazione criptata della tua chiave segreta e dell'ID utente.

In questa guida, ti mostreremo come ottenere la tua chiave segreta, generare un hash e utilizzarlo con il setAttributes() funzione nel nostro JavaScript API.

Prima, ottieni la chiave segreta
Segui questi passaggi per ottenere la tua chiave segreta:


  1. Accedi al tuo account tawk.to

  2. Nel tuo pannello di controllo, seleziona la proprietà per cui hai bisogno della chiave. Passa il cursore sopra il nome della proprietà per assicurarti di aver selezionato quella corretta.




3.Clicca sull'icona dell'ingranaggio nel menu in alto per accedere al pannello di amministrazione.

4.Nel menu di amministrazione, seleziona Panoramica.

5.Scorri verso il basso fino a API JavaScript.


6.Abilita la Modalità Sicura.

7.Clicca sull'icona seguente per copiare la Chiave:

Avrai bisogno di questa chiave per la sezione successiva, dove genereremo l'hash.

Genera l'hash

L'hash viene generato da un servizio che accetta una combinazione della tua chiave segreta e dell'ID utente e li cripta in una stringa di caratteri che le parti non autorizzate non possono leggere.

Puoi utilizzare qualsiasi servizio di crittografia a tua scelta per generare l'hash. In questo esempio, ti mostriamo come farlo utilizzando Crypto.js. Le librerie pertinenti sono disponibili su:

https://cryptojs.gitbook.io/docs

https://www.npmjs.com/package/crypto-js

Segui questi passaggi per generare l'hash:


  1. Copia il seguente codice nella sezione <head> del file HTML del tuo sito web:

  1. <!-- Start of Crypto JS -->
  2. <script
  3. src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/crypto-js.min.js"
  4. integrity="sha512-E8QSvWZ0eCLGk4km3hxSsNmGWbLtSCSUcewDQPQWZF6pEU8GlT8a5fF32wOl1i8ftdMhssTrF/OhyGWwonTcXA=="
  5. crossorigin="anonymous"
  6. referrerpolicy="no-referrer"
  7. ></script>

  9. <script
  10. src="https://cdnjs.cloudflare.com/ajax/libs/crypto-js/4.1.1/hmac-sha256.min.js"
  11. integrity="sha512-HMqYytekgCbPoNWBm9oazvuOJ8sFpw+FWBHRi2QM0f/bV5djDV1sRzWzu5Jq7MAUlm+zDAUCgi/vHBBlUGLroQ=="
  12. crossorigin="anonymous"
  13. referrerpolicy="no-referrer"
  14. ></script>
  15. <!-- End of Crypto JS -->

2.Copia la seguente funzione nel tuo file JavaScript. Questa funzione gestisce la generazione del valore dell'hash.

  1. /**
  2. * Using Crypto JS for the encryption
  3. * @param {int} userId
  4. */
  5. function hashInBase64(userId){
  6. var hash = CryptoJS.HmacSHA256(userId, secretKey);

  8. return CryptoJS.enc.Hex.stringify(hash);
  9. }

3.Sostituisci secretKey con la chiave copiata dal tuo pannello di controllo tawk.to.
  1. var hash = CryptoJS.HmacSHA256(userID, secretKey);

Successivamente, utilizziamo l'hash con la funzione setAttributes().

Utilizzare setAttributes() con l'hash

Segui questi passaggi per usare setAttributes() con l'hash:


  1. Copia la funzione setAttributes() function dalla nostra JavaScript API nel tuo schema API.

  1. window.Tawk_API.setAttributes(attributes, callback);

  3. window.Tawk_API.onLoad = function(){
  4. window.Tawk_API.setAttributes({
  5. 'name' : 'Name',
  6. 'email' : 'email@email.com',
  7. 'hash' : 'hash value'
  8. }, function(error){});
  9. }

  1. Copia l'hash che hai generato nel campo hash.

  1. hash : '',

  1. Assicurati che il valore nel campo userID corrisponda all'ID utente utilizzato nei passaggi di crittografia sopra.

  1. userId : '1234' // 1234 or ‘1234’

Nota: Potrebbe richiedere fino a qualche secondo per aggiornare i dati dei tuoi clienti.

Codici di errore

Questi sono i possibili codici di errore che potresti incontrare:

Questi codici di errore appariranno nella console dello sviluppatore del tuo browser web.

Con questi passaggi, hai ulteriormente rafforzato la sicurezza del tuo widget di chat tawk.to, offrendo ai tuoi clienti un'esperienza più sicura e robusta.

Se dovessi incontrare difficoltà o avere ulteriori domande, non esitare a contattarci.

Se hai dei feedback su questo articolo o se hai bisogno di ulteriore assistenza:

L'articolo ti è stato d'aiuto?

A 3 su 6 è piaciuto quest'articolo

Hai ancora bisogno d'aiuto? Inviaci un messaggio