Identifier les utilisateurs
Par défaut, le widget considère les visiteurs comme anonymes. Appelez uj.identify pour associer les retours, les votes, les commentaires, les notifications et les conversations au compte d’un client.
Identification de base
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
firstName: 'Ada',
lastName: 'Lovelace',
avatar: 'https://example.com/avatar.jpg'
}
});user.id est obligatoire. Utilisez un identifiant stable de votre base de données plutôt qu’une adresse e-mail ou un nom d’affichage susceptible de changer. email est facultatif, mais fortement recommandé afin que UserJot puisse rapprocher l’utilisateur sur différents tableaux, transferts d’e-mails et conversations. La transmission d’un email associe uniquement l’utilisateur à un compte UserJot existant dont l’adresse e-mail a été confirmée.
Quand appeler identify
Appelez uj.identify dès que votre application connaît l’identité de l’utilisateur connecté. Si vous le rappelez avec exactement les mêmes données pendant que la session est toujours active, aucun changement ne se produit. Lorsque la session expire, ou si un champ (y compris l’e-mail ou les attributs) change, le SDK envoie une nouvelle requête. Le passage à un autre utilisateur change immédiatement de session.
Lorsque l’utilisateur se déconnecte de votre application, appelez uj.logout() :
if (user) {
uj.identify({
user: {
id: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName
}
});
} else {
uj.logout();
}Ajouter des attributs
Les attributs sont des caractéristiques personnalisées associées au profil d’un membre et affichées à côté de ses demandes et conversations dans le tableau de bord.
uj.identify({
user: {
id: 'user-123',
email: 'ada@example.com',
traits: {
plan: 'pro',
seats: 12,
trialing: false
}
}
});Les valeurs des attributs peuvent être des chaînes de caractères, des nombres, des booléens ou des null (monthlySpend, lorsqu’il est transmis, doit être un nombre non négatif). Les clés réservées (telles que id, email, role ou companies) sont ignorées et signalées dans result.warnings. Consultez la liste complète dans la référence du SDK.
Ajouter des entreprises
Pour les produits B2B, associez une ou plusieurs entreprises à l’utilisateur :
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 est obligatoire pour chaque entreprise. name, domain, logo (URL HTTPS) et traits sont facultatifs. Si l’option Exiger des jetons signés est activée dans Paramètres → Connexion, les entreprises transmises en dehors d’un JWT signé sont ignorées et un avertissement UNSIGNED_COMPANY_IGNORED est émis.
Valeur renvoyée par identify
Une fois le script du SDK chargé, uj.identify renvoie une promesse :
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 adjustedLimites de débit et erreurs
Limitation du débit et temporisation côté client : le nombre de requêtes Identify est limité à 30 par minute et 300 par heure par adresse IP et espace de travail. Le dépassement de la limite horaire entraîne un blocage de 1 heure. Après réception du code HTTP
429, le SDK applique localement une période de pause (en respectantRetry-After, avec une durée comprise entre 1 seconde et 1 heure, et de 60 secondes par défaut), afin que les nouvelles tentatives échouent localement sans surcharger l’API.Appels rejetés : si le serveur rejette un appel d’identification (par exemple, en raison d’un jeton non valide, de l’activation de Exiger des jetons signés sans jeton, d’un conflit d’e-mail qui renvoie
409, ou d’un membre dont les données ont été effacées conformément au RGPD et qui renvoie403/member_erased), la promesse est rejetée avecIDENTIFY_FAILEDet le visiteur reste anonyme.
Identité et conversations
Lorsque Conversations est activé :
Les utilisateurs identifiés ignorent l’invite à saisir leurs coordonnées et reçoivent les réponses de l’équipe à l’adresse e-mail associée à leur compte.
Les visiteurs anonymes bénéficient de conversations d’invité associées à leur navigateur, avec la possibilité de recueillir leurs coordonnées selon les paramètres de votre widget.
Dans le widget, les visiteurs anonymes peuvent envoyer des retours et réagir aux mises à jour. En revanche, voter pour des retours, publier des commentaires et ouvrir la cloche des notifications nécessitent d’appeler uj.identify. Pour modifier ou supprimer ses propres publications et commentaires dans le widget, il faut disposer d’une identité signée.
Si Exiger des jetons signés est activé dans Paramètres → Connexion, les appels identify non signés sont rejetés avec le code HTTP 403 et le visiteur reste anonyme. Utilisez Identité signée pour vérifier les comptes côté serveur.
Quelle méthode d’authentification dois-je utiliser ?
Méthode | Où elle fonctionne | Sécurité | Offre | Guide |
|---|---|---|---|---|
Non signé ( | Widget intégré à l’application | Fourni par le navigateur (peut être falsifié) | Toutes les offres | Cet article |
Identité signée (JWT HS256) | Widget intégré à l’application (+ liens vers le portail public lorsque la connexion automatique est activée) | JWT vérifié côté serveur | Starter & Professional (pour le mode strict) | |
Connexion automatique | Portail public et intégrations intégrées ( | JWT HS256 vérifié côté serveur | Starter & Professional | |
Authentification unique (SSO) | Redirection vers la page de connexion du portail public | JWT HS256 vérifié côté serveur | Professional | |
SDK Swift ( | Applications iOS et macOS | Signature non signée ou HMAC-SHA256 | Starter & Professional (connexion automatique requise) |
Étape suivante
Vérifiez les identités des utilisateurs depuis votre serveur avec Identité signée.