Gebruikers identificeren

Shayan TaslimBijgewerkt:

De widget behandelt bezoekers standaard als anoniem. Roep uj.identify aan om feedback, stemmen, opmerkingen, meldingen en gesprekken aan het account van een klant te koppelen.

Basisidentificatie

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    firstName: 'Ada',
    lastName: 'Lovelace',
    avatar: 'https://example.com/avatar.jpg'
  }
});

user.id is verplicht. Gebruik een stabiele ID uit je database in plaats van een e-mailadres of weergavenaam die kan veranderen. email is optioneel, maar sterk aanbevolen, zodat UserJot de gebruiker kan herkennen op verschillende borden, bij het doorsturen van e-mails en in gesprekken. Als je een email doorgeeft, wordt die alleen gekoppeld aan een bestaand UserJot-account waarvan het e-mailadres is bevestigd.

Wanneer je identify aanroept

Roep uj.identify aan zodra je app weet wie er is ingelogd. Als je de functie opnieuw aanroept met exact dezelfde gegevens terwijl de sessie nog actief is, gebeurt er niets. Zodra de sessie verloopt, of als een veld verandert (waaronder e-mail of kenmerken), stuurt de SDK een nieuw verzoek. Als je een andere gebruiker doorgeeft, wordt de sessie onmiddellijk gewisseld.

Roep uj.logout() aan wanneer de gebruiker zich afmeldt bij je app:

JavaScript
if (user) {
  uj.identify({
    user: {
      id: user.id,
      email: user.email,
      firstName: user.firstName,
      lastName: user.lastName
    }
  });
} else {
  uj.logout();
}

Kenmerken toevoegen

Kenmerken zijn aangepaste attributen die aan een ledenprofiel worden toegevoegd en in het dashboard naast hun verzoeken en gesprekken worden weergegeven.

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    traits: {
      plan: 'pro',
      seats: 12,
      trialing: false
    }
  }
});

Traitwaarden kunnen strings, getallen, booleans of null zijn (monthlySpend moet, als deze wordt meegestuurd, een niet-negatief getal zijn). Gereserveerde sleutels (zoals id, email, role of companies) worden genegeerd en gerapporteerd in result.warnings. Bekijk de volledige lijst in de SDK-referentie.

Bedrijven toevoegen

Koppel voor B2B-producten een of meer bedrijven aan de gebruiker:

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 is verplicht voor elk bedrijf. name, domain, logo (HTTPS-URL) en traits zijn optioneel. Als Ondertekende tokens vereisen is ingeschakeld in Instellingen → Inloggen, worden bedrijven die buiten een ondertekende JWT worden doorgegeven genegeerd en verschijnt er een waarschuwing UNSIGNED_COMPANY_IGNORED.

Wat identify retourneert

Zodra het SDK-script is geladen, retourneert uj.identify een 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

Snelheidslimieten en fouten

  • Snelheidslimiet en clientwachttijd: Identify-aanvragen zijn beperkt tot 30 per minuut en 300 per uur per IP-adres en werkruimte. Als de uurlimiet wordt overschreden, volgt er een blokkering van 1 uur. Na ontvangst van HTTP 429 past de SDK lokaal een cooldown-periode toe (met inachtneming van Retry-After, begrensd op minimaal 1 seconde en maximaal 1 uur, standaard 60 seconden), zodat herhaalpogingen lokaal mislukken zonder de API te overbelasten.

  • Afgewezen aanroepen: Als de server een identify-aanroep afwijst (bijvoorbeeld vanwege een ongeldig token, ingeschakelde optie Ondertekende tokens vereisen zonder token, een e-mailconflict dat 409 retourneert of een GDPR-gewist lid waarvoor 403 / member_erased wordt geretourneerd), wordt de promise afgewezen met IDENTIFY_FAILED en blijft de bezoeker anoniem.

Identiteit en gesprekken

Wanneer Gesprekken is ingeschakeld:

  • Geïdentificeerde gebruikers slaan de vraag om bezoekersgegevens over te slaan en ontvangen reacties van het team op het e-mailadres van hun account.

  • Anonieme bezoekers krijgen gastgesprekken die aan hun browser zijn gekoppeld, met optionele contactgegevensverzameling op basis van je widgetinstellingen.

In de widget kunnen anonieme bezoekers feedback insturen en reageren op updates. Voor stemmen op feedback, opmerkingen plaatsen en de bel voor meldingen openen, moet je uj.identify aanroepen. Om eigen berichten en opmerkingen in de widget te bewerken of te verwijderen, is Ondertekende identiteit vereist.

Als Ondertekende tokens vereisen is ingeschakeld in Instellingen → Inloggen, worden niet-ondertekende aanroepen van identify afgewezen met HTTP 403 en blijft de bezoeker anoniem. Gebruik Ondertekende identiteit om accounts aan de serverzijde te verifiëren.

Welke authenticatiemethode moet ik gebruiken?

Methode

Waar het werkt

Beveiliging

Abonnement

Handleiding

Niet-ondertekend (uj.identify)

Widget in de app

Aangeleverd door de browser (kan worden vervalst)

Alle abonnementen

Dit artikel

Ondertekende identiteit (HS256 JWT)

Widget in de app (+ links naar het openbare portaal wanneer Automatisch inloggen is ingeschakeld)

JWT geverifieerd door de server

Starter & Professional (voor de strikte modus)

Ondertekende identiteit

Automatisch inloggen

Openbaar portaal & ingesloten elementen (?token=...)

HS256 JWT geverifieerd door de server

Starter & Professional

Automatisch inloggen

Eenmalige aanmelding (SSO)

Omleiding naar inloggen op het openbare portaal

HS256 JWT geverifieerd door de server

Professional

Eenmalige aanmelding

Swift SDK (identify)

iOS- en macOS-apps

Niet-ondertekend of HMAC-SHA256-handtekening

Starter & Professional (Automatisch inloggen vereist)

Swift SDK-authenticatie

Volgende stap

Verifieer gebruikersidentiteiten vanuit je backend met Ondertekende identiteit.

Heeft dit je vraag beantwoord?