Dati utente & lead matching
Passare email, telefono, nome e dati custom dell'utente loggato al widget Audin per collegare la conversazione a un lead, e come funziona il visitorId.
Versione Markdown di questa pagina
Scarica o copia il contenuto di questa pagina in formato .md — utile per fornirlo a un agente AI che integra questa specifica feature.
Quando inizializzi il widget puoi passargli i dati dell'utente loggato sul tuo sito. Audin li usa per collegare la conversazione a un lead del tuo Account, così la chat di un utente già noto non parte "anonima" ma è riconducibile al suo profilo.
Il passaggio dei dati utente è opzionale: senza, il widget funziona comunque
e la conversazione resta legata al solo visitorId (vedi più sotto).
I campi user
I dati utente si passano nell'oggetto user dell'opzione di init() — valido sia
per il popup (AudinChat) sia per l'embedded (AudinEmbed):
AudinChat.init({
user: {
email: "utente@esempio.com",
phone: "+39123456789",
fullName: "Nome Cognome",
customData: {
piano: "premium",
clienteDa: "2023"
}
}
});Tutti i campi sono opzionali: passa solo quelli che hai realmente.
| Campo | Tipo | Uso |
|---|---|---|
email | string | Email dell'utente. Tra i criteri più affidabili per il matching con un lead esistente. |
phone | string | Numero di telefono. Consigliato in formato internazionale (E.164, es. +39123456789). |
fullName | string | Nome e cognome dell'utente. |
customData | Record<string, unknown> | Coppie chiave/valore libere con contesto aggiuntivo (es. piano di abbonamento, ID interno, segmento). |
Questi sono tutti i campi accettati da init(). L'aspetto del widget, il
bot collegato e i testi non si passano qui: si configurano nel dashboard
(app.audin.ai). Vedi Configurazione & comportamento.
Quando passare i dati
Passa i dati utente solo quando li conosci — tipicamente per un utente autenticato sul tuo sito. Recuperali dal tuo stato applicativo (sessione, profilo) e iniettali al momento dell'inizializzazione:
// Esempio: utente loggato sul tuo sito
const currentUser = getLoggedInUser(); // dal tuo sistema
AudinChat.init({
user: {
email: currentUser.email,
fullName: currentUser.name,
customData: { piano: currentUser.plan }
}
});Per un visitatore anonimo, chiama semplicemente AudinChat.init() senza argomenti.
Il visitorId
Indipendentemente dai dati utente, il widget assegna a ogni browser un
visitorId generato automaticamente e persistito nel localStorage alla
chiave audin_visitor_id.
- Viene creato la prima volta che il widget si carica e riutilizzato nelle visite successive dallo stesso browser, così le conversazioni dello stesso visitatore restano collegate nel tempo.
- È un identificativo casuale (UUID): non contiene dati personali e non è
ricavabile dai campi
user. - Se l'utente svuota il
localStorage(o cambia browser/dispositivo), riceve un nuovovisitorId— verrà trattato come un nuovo visitatore finché non lo ricolleghi tramite i datiuser.
Per riconoscere lo stesso utente su browser o dispositivi diversi, passa i
dati user (es. email): è il modo affidabile per ricollegare le conversazioni
a un unico lead, dato che il visitorId è per-browser.
Privacy
Passa al widget solo i dati di cui hai effettivamente diritto e per cui hai
raccolto il consenso necessario. I campi user sono pensati per dati di un
utente autenticato che ha già una relazione con te.
Linee guida pratiche:
- Non inserire in
customDatainformazioni sensibili o non necessarie al servizio. - Non passare dati di terzi o di utenti che non hanno acconsentito al trattamento.
- Tratta email e telefono come dati personali: la responsabilità della base giuridica per il loro trattamento resta tua (titolare), Audin li elabora per fornirti il servizio.
Prossimi passi
Installazione
I tre snippet per installare il widget Audin — popup, popup con dati utente ed embedded — dove incollarli e come ottenere il widget-id dal dashboard.
API & eventi
L'API JavaScript del widget Audin — i metodi e gli eventi di AudinChat (popup) e AudinEmbed (embedded), con le differenze tra le due modalità.