Identifier les utilisateurs

Shayan TaslimMis à jour

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

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

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

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

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

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

Limites 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 respectant Retry-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 renvoie 403 / member_erased), la promesse est rejetée avec IDENTIFY_FAILED et 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é (uj.identify)

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)

Identité signée

Connexion automatique

Portail public et intégrations intégrées (?token=...)

JWT HS256 vérifié côté serveur

Starter & Professional

Connexion automatique

Authentification unique (SSO)

Redirection vers la page de connexion du portail public

JWT HS256 vérifié côté serveur

Professional

Authentification unique

SDK Swift (identify)

Applications iOS et macOS

Signature non signée ou HMAC-SHA256

Starter & Professional (connexion automatique requise)

Authentification avec le SDK Swift

Étape suivante

Vérifiez les identités des utilisateurs depuis votre serveur avec Identité signée.

Cet article a-t-il répondu à votre question ?