Savoir qui clavarde : identifier les utilisateurs connectés
Ajoutez Alori("identify") dès que les personnes se connectent. Le clavardage les reconnaît, les associe à leur entreprise et enregistre vos propres champs dans le CRM.
Quand les gens se connectent sur votre site Web ou votre produit, le clavardage sait qui ils sont : nom et courriel remplis, leur entreprise dans votre CRM, vos propres champs (comme leur forfait) enregistrés, et leurs conversations les suivent sur n'importe quel appareil.
Aussi appelé : identify, signed-in users, Intercom boot, user hash, custom attributes, identifier les utilisateurs, champs personnalisés
Vous migrez depuis Intercom? Votre code d'installation continue de fonctionner : boot, update, shutdown, user_id, user_hash et custom_attributes fonctionnent aussi. Remplacez le script et signez avec votre clé Alori.
1. Ajouter l'appel identify
Le clavardage doit déjà être sur votre site Web. Une fois votre utilisateur connecté, ajoutez ceci à la page :
<script>
window.Alori=window.Alori||function(){(Alori.q=Alori.q||[]).push(arguments)};
Alori("identify", {
userId: "USER_ID",
email: "USER_EMAIL",
fullName: "USER_FULL_NAME",
userHash: "USER_HASH",
plan: "Pro",
company: {
id: "COMPANY_ID",
name: "COMPANY_NAME",
seats: 12
}
});
</script>userId: leur identifiant sur votre site Web.fullName: leur nom complet, oufirstNameetlastName.emailetphone: leurs coordonnées.company:idregroupe tous les membres de cette entreprise dans votre CRM, même si son nom change.nameest son nom.
2. Envoyer vos propres champs
Ajoutez tout autre champ, comme plan: "Pro". L'endroit où vous le placez détermine où il va :
À côté de
userId: il va sur le contact.Dans
company: il va sur l'entreprise, commeseats: 12.
Si votre CRM n'a pas encore ce champ, Alori le crée pour vous, nommé d'après la clé (signup_date devient Signup date) et typé selon la valeur : nombre, oui/non, date, lien ou texte. Renommez-les dans Paramètres › Champs personnalisés. Jusqu'à 20 champs chacun.
Les 5 premiers champs créés pour le contact et pour l'entreprise s'affichent dans Conversations sous la personne et son entreprise; envoyez donc les plus utiles en premier. Cliquez sur l'icône des curseurs sur la fiche Client ou Entreprises pour afficher ou masquer les autres.
3. Signer avec votre clé secrète
userHash prouve que l'utilisateur est bien celui indiqué sur la page. Les champs et les entreprises sont enregistrés seulement si la clé est exacte.
Ouvrez Réception › Paramètres, et sous Installation, cliquez sur Savoir qui clavarde.
Cliquez sur Afficher la clé secrète et copiez-la.
Conservez la clé sur votre serveur, jamais dans la page. Calculez le HMAC-SHA256 de l'identifiant utilisateur avec la clé, et mettez le résultat dans
userHash.
Dans Node :
const userHash = crypto.createHmac("sha256", SECRET_KEY).update(userId).digest("hex");Si vous n'envoyez pas de userId, signez plutôt le courriel.
Si Nora fait des recherches dans vos autres logiciels, transmettez aussi mcpToken à côté de userHash : un jeton tout neuf que votre serveur génère à chaque chargement de page, avec les permissions propres à cet utilisateur. Consultez Comment connecter Nora à mes autres logiciels?.

4. Les déconnecter
Lorsque votre utilisateur se déconnecte, appelez Alori("logout"), afin que la prochaine personne sur cet ordinateur reparte à zéro.
Bon à savoir
Alori("open")etAlori("close")ouvrent ou ferment le clavardage à partir de votre bouton.Dans Conversations, un utilisateur connecté affiche Connecté sur le site Web avec un crochet, son nom et son entreprise. Pointez dessus pour voir tout ce que votre site Web a envoyé : courriel, identifiants et champs.

Les champs qui existaient déjà avant votre premier appel identify ne s'affichent pas automatiquement. Activez-les avec l'icône des curseurs.
Seul ce que vous signez est jugé fiable : sans signature, Nora ne sait que ce que le visiteur a tapé.
Si ça ne fonctionne pas
Aucun champ ni aucune entreprise dans le CRM. Le
userHashest manquant ou erroné. Vérifiez qu'il est signé avec la clé obtenue sous Afficher la clé secrète, sur le même identifiant d'utilisateur que vous envoyez.Un champ reste vide. La valeur ne correspond pas au champ, comme du texte dans un champ numérique.