Impostare il nome e l' indirizzo e-mail di un visitatore nel modulo di pre-chat utilizzando l'API JavaScript

Le istruzioni seguenti sono valide solo per desktop e laptop.

Puoi utilizzare l’API di tawk.to per compilare automaticamente nome e email di un visitatore nella scheda Dettagli, nel Modulo Pre-Chat e nel Modulo Offline.

Questo ti permette di:

• Riconoscere i visitatori di ritorno,

• Collegare le conversazioni ai profili dei contatti esistenti,

• Sostituire gli ID anonimi dei visitatori (ad esempio V1234567890123456) con nomi ed email reali.

Assicurati che:

• Il nome o l’email del visitatore siano già disponibili sul tuo sito — ad esempio, tramite un modulo di login o registrazione. L’API può impostare solo i dettagli che il tuo sistema è in grado di fornire.

• Hai accesso alle impostazioni dell’API JavaScript della tua proprietà tawk.to, tramite Amministrazione → Panoramica → API JavaScript.

• La Modalità Sicura (Secure Mode) sia attivata se prevedi di inviare informazioni sensibili (come email o ID utente). Questo garantisce che i dati siano verificati tramite un hash sicuro generato sul tuo server.

Per maggiori dettagli su come abilitare la Modalità Sicura e generare un hash, consulta questa guida: Come generare un hash per l’API JavaScript.

Questo è il metodo più sicuro ed è consigliato per tutti gli ambienti di produzione.

Con la Modalità Sicura (Secure Mode) abilitata, puoi generare un hash (una firma crittografata) sul tuo server utilizzando la tua chiave segreta e l’ID univoco del visitatore. Il widget utilizza questo hash per confermare che i dati del visitatore provengono dal tuo sistema e non sono stati manomessi.

Passaggi:

1. Genera l’hash sul tuo server usando la tua chiave segreta e l’ID univoco del visitatore o l’ID utente.
   Per maggiori informazioni, consulta questa guida: Come generare un hash per l’API JavaScript

2. Nella pagina in cui il widget è incorporato, definisci i dettagli del visitatore prima di caricare lo script di tawk.to:

Note:

L’hash deve corrispondere all’ID del visitatore o dell’utente utilizzato per generarlo sul tuo server.

Puoi anche includere l’hash successivamente in una chiamata a login() o setAttributes() se il visitatore effettua l’accesso dopo che il widget è già stato caricato.

Se l’hash manca o non corrisponde, il widget non aggiornerà i dettagli del visitatore per motivi di sicurezza.

Applicazioni a pagina singola (SPA) / login con AJAX

Se il tuo sito utilizza un framework SPA (come React, Vue o Angular) o gestisce i login dinamicamente tramite AJAX, i dettagli del visitatore potrebbero diventare disponibili solo dopo che il widget è già stato caricato.

In questi casi, usa il metodo setAttributes() per aggiornare le informazioni del visitatore non appena sono disponibili.

Suggerimenti:

• Chiama sempre setAttributes() dopo Tawk_API.onLoad per assicurarti che il widget sia completamente inizializzato.

• Usa la Modalità Sicura e un hash valido quando gestisci dati sensibili o utenti autenticati.

• Per login ripetuti o cambi di sessione, puoi rieseguire setAttributes() ogni volta che sono disponibili nuovi dati del visitatore.

Opzione B: Senza hash (semplice ma meno sicura)

Se non hai accesso a un generatore di hash lato server o vuoi solo una configurazione rapida per test, puoi definire direttamente il nome e l’email del visitatore nello script.

Questo metodo funziona bene per casi d’uso non sensibili, ma non dovrebbe essere usato in produzione se stai esponendo informazioni personali identificabili (PII).

Quando aggiunto prima dello script di embedding del widget, questo codice compila automaticamente il nome e l’email del visitatore nei moduli Pre-Chat e Offline. La sessione di chat mostrerà anche il nome reale del visitatore invece del normale ID anonimo.

Aggiungere un numero di telefono

Puoi includere anche un numero di telefono nei dettagli del visitatore usando il metodo visitor() con la proprietà phone. Assicurati di usare il formato internazionale E.164 (ad esempio, +1234567890).

Per capire come il campo del numero di telefono appare e funziona nel tuo modulo Pre-Chat, consulta questa guida: Utilizzare il modulo Pre-Chat.

Considerazioni aggiuntive

Evita duplicati
Se lo stesso visitatore viene identificato con email o ID diversi, potresti visualizzare profili duplicati. Per imparare a unirli, consulta questa guida: Come unire i contatti.

Gestisci i dati in modo responsabile
Non includere chiavi segrete o informazioni private nel codice lato client. Segui la politica sulla privacy della tua organizzazione e le leggi vigenti sulla protezione dei dati. Inoltre, abilita sempre la Modalità Sicura (Secure Mode) quando invii dati identificabili o sensibili. Questo previene la manomissione dei dati e protegge le informazioni degli utenti.

Testa in un ambiente di staging
Verifica che i profili dei visitatori corretti compaiano nel cruscotto e che la validazione della Modalità Sicura funzioni come previsto.

Esplora l’API
Per scoprire altri metodi per gestire i dati dei visitatori, consulta la documentazione della JavaScript API.

Se hai commenti su questo articolo o hai bisogno di ulteriore assistenza: