Identificare gli utenti

Shayan TaslimAggiornato

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

JavaScript
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():

JavaScript
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.

JavaScript
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:

JavaScript
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:

JavaScript
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 adjusted

Limiti 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 (rispettando Retry-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 restituisce 403 / member_erased), la promise viene rifiutata con IDENTIFY_FAILED e 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 (uj.identify)

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)

Identità firmata

Accesso automatico

Portale pubblico e incorporamenti in linea (?token=...)

JWT HS256 verificato dal server

Starter e Professional

Accesso automatico

Single sign-on (SSO)

Reindirizzamento all'accesso del portale pubblico

JWT HS256 verificato dal server

Professional

Single sign-on

SDK Swift (identify)

App iOS e macOS

Non firmata o con firma HMAC-SHA256

Starter e Professional (richiede l'accesso automatico)

Autenticazione con SDK Swift

Passaggio successivo

Verifica le identità degli utenti dal tuo backend con Identità firmata.

Ha risposto alla tua domanda?