Gebruikers identificeren
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
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:
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.
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:
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:
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 adjustedSnelheidslimieten 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
429past de SDK lokaal een cooldown-periode toe (met inachtneming vanRetry-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
409retourneert of een GDPR-gewist lid waarvoor403/member_erasedwordt geretourneerd), wordt de promise afgewezen metIDENTIFY_FAILEDen 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 ( | 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) | |
Automatisch inloggen | Openbaar portaal & ingesloten elementen ( | HS256 JWT geverifieerd door de server | Starter & Professional | |
Eenmalige aanmelding (SSO) | Omleiding naar inloggen op het openbare portaal | HS256 JWT geverifieerd door de server | Professional | |
Swift SDK ( | iOS- en macOS-apps | Niet-ondertekend of HMAC-SHA256-handtekening | Starter & Professional (Automatisch inloggen vereist) |
Volgende stap
Verifieer gebruikersidentiteiten vanuit je backend met Ondertekende identiteit.