Identificare gli utenti
Per impostazione predefinita, il widget considera anonimi i visitatori. Chiama uj.identify per associare feedback, voti, commenti, notifiche e conversazioni all’account di un cliente.
Identificazione di base
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
firstName: 'Ada',
lastName: 'Lovelace',
avatar: 'https://example.com/avatar.jpg'
}
});user.id è obbligatorio. Usa un ID stabile del tuo database, anziché un indirizzo email o un nome visualizzato che potrebbe cambiare. email è facoltativo, ma fortemente consigliato, affinché UserJot possa riconciliare l’utente tra bacheche, inoltro delle email e conversazioni. Passando un email si effettua il collegamento solo a un account UserJot esistente il cui indirizzo email è stato confermato.
Quando chiamare identify
Chiama uj.identify quando la tua app sa chi ha effettuato l'accesso. Se la richiami con lo stesso identico payload mentre la sessione è ancora attiva, non succede nulla. Alla scadenza della sessione, o se cambia un qualsiasi campo (inclusi email e attributi), l'SDK invia una nuova richiesta. Se passi un utente diverso, la sessione cambia immediatamente.
Quando l'utente esce dalla tua app, chiama uj.logout():
if (user) {
uj.identify({
user: {
id: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
}
});
} else {
uj.logout();
}Aggiungere attributi
Gli attributi sono caratteristiche personalizzate associate al profilo di un membro e visualizzate accanto alle sue richieste e conversazioni nella dashboard.
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
traits: {
plan: 'pro',
seats: 12,
trialing: false
}
}
});I valori degli attributi possono essere stringhe, numeri, valori booleani o null (monthlySpend, se inviato, deve essere un numero non negativo). Le chiavi riservate (come id, email, role o companies) vengono ignorate e segnalate in result.warnings. Consulta l’elenco completo nel riferimento dell’SDK.
Aggiungere aziende
Per i prodotti B2B, associa una o più aziende all'utente:
uj.identify({
user: { id: 'user-123', email: 'ada@example.com' },
companies: [
{
id: 'acme',
name: 'ACME Inc.',
domain: 'acme.com',
logo: 'https://acme.com/logo.png',
traits: { plan: 'enterprise', arr: 24000 }
}
]
});id è obbligatorio per ogni azienda. name, domain, logo (URL HTTPS) e traits sono facoltativi. Se l’opzione Richiedi token firmati è attiva in Impostazioni → Accesso, le aziende passate al di fuori di un JWT firmato vengono ignorate e viene mostrato un avviso UNSIGNED_COMPANY_IGNORED.
Cosa restituisce identify
Una volta caricato lo script dell'SDK, uj.identify restituisce una promise:
const result = await uj.identify({
user: { id: 'user-123', email: 'ada@example.com' }
});
result.viewer; // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings; // fields the server ignored or adjustedLimiti di frequenza ed errori
Limite di frequenza e backoff del client: le richieste di identificazione sono limitate a 30 al minuto e 300 all’ora per indirizzo IP e spazio di lavoro. Il superamento del limite orario comporta un blocco di 1 ora. Dopo aver ricevuto HTTP
429, l’SDK applica localmente un periodo di attesa (rispettandoRetry-After, con un limite compreso tra 1 secondo e 1 ora e un valore predefinito di 60 secondi), in modo che i cicli di nuovi tentativi falliscano localmente senza inondare l’API.Chiamate rifiutate: se il server rifiuta una chiamata di identificazione (ad esempio, per un token non valido, se Richiedi token firmati è attiva ma non è stato fornito un token, per un conflitto tra indirizzi email che restituisce
409, o se il membro è stato eliminato in base al GDPR e restituisce403/member_erased), la promise viene rifiutata conIDENTIFY_FAILEDe il visitatore rimane anonimo.
Identità e conversazioni
Quando Conversations è attivo:
Gli utenti identificati saltano la richiesta dei dati del visitatore e ricevono le risposte del team all'indirizzo email associato al loro account.
I visitatori anonimi possono avviare conversazioni come ospiti, associate al browser, con la possibilità di acquisire i dati di contatto in base alle impostazioni del widget.
Nel widget, i visitatori anonimi possono inviare feedback e reagire agli aggiornamenti, mentre per votare i feedback, commentare e aprire la campanella delle notifiche è necessario chiamare uj.identify. Per modificare o eliminare i propri post e commenti nel widget è necessaria l’identità firmata.
Se Richiedi token firmati è attiva in Impostazioni → Accesso, le chiamate identify non firmate vengono rifiutate con HTTP 403 e il visitatore rimane anonimo. Usa Identità firmata per verificare gli account lato server.
Quale metodo di autenticazione devo usare?
Metodo | Dove funziona | Sicurezza | Piano | Guida |
|---|---|---|---|---|
Non firmata ( | Widget in-app | Fornita dal browser (può essere falsificata) | Tutti i piani | Questo articolo |
Identità firmata (JWT HS256) | Widget in-app (+ link al portale pubblico se l'accesso automatico è attivo) | JWT verificato dal server | Starter e Professional (per la modalità rigorosa) | |
Accesso automatico | Portale pubblico e incorporamenti in linea ( | JWT HS256 verificato dal server | Starter e Professional | |
Single sign-on (SSO) | Reindirizzamento all'accesso del portale pubblico | JWT HS256 verificato dal server | Professional | |
SDK Swift ( | App iOS e macOS | Non firmata o con firma HMAC-SHA256 | Starter e Professional (richiede l'accesso automatico) |
Passaggio successivo
Verifica le identità degli utenti dal tuo backend con Identità firmata.