Vérifier l'identité de vos visiteurs
Indiquez au chat qui est un visiteur connecté avec Chatixy.identify() et signez son adresse e-mail sur votre serveur : votre équipe voit une identité vérifiée sur la conversation.
Comment fonctionne la vérification d'identité
Lorsqu'un visiteur est connecté à votre site, votre page peut indiquer au chat qui il est avec Chatixy.identify(). Son adresse e-mail, son nom et son téléphone apparaissent alors sur la conversation dans votre boîte de réception, et le chat ne lui demande plus son adresse e-mail.
Sans signature, identify() fonctionne comme le formulaire d'avant-chat : les informations ne remplissent que les champs encore vides et la conversation est marquée comme non vérifiée. Ajoutez une signature calculée sur votre serveur, le user_hash, et Chatixy marque l'identité comme vérifiée : les informations remplacent ce que le visiteur a saisi, et la fiche contact de votre boîte de réception affiche le badge Vérifié. Votre agent de support n'est informé que l'identité est vérifiée que lorsqu'elle l'est réellement.
Conseils
- Les règles du formulaire d'avant-chat s'appliquent : un numéro de téléphone n'est enregistré que si votre chat en demande un, et un nom sauf si le champ du nom est désactivé dans votre chat.
Trouver votre secret d'identité
Chaque chat possède son propre Secret d'identité. Seuls les administrateurs de votre espace de travail peuvent le voir.
Étapes
- 1
Ouvrez les réglages du chat
Dans votre projet, cliquez sur Configurer sur le site, puis ouvrez Paramètres avancés.
- 2
Copiez le secret
Sous Secret d'identité, cliquez sur Afficher, puis sur Copier.
- 3
Conservez-le sur votre serveur
Stockez-le à un endroit que seul votre serveur peut lire, par exemple dans la variable d'environnement
CHATIXY_IDENTITY_SECRET.
Important
- Ne placez jamais le secret d'identité dans le code de votre page, dans votre JavaScript ni dans un dépôt public. Quiconque le détient peut faire passer n'importe quelle adresse e-mail pour vérifiée.
- Régénérer crée un nouveau secret, et les signatures faites avec l'ancien cessent immédiatement d'être reconnues. Utilisez-le si le secret a pu fuiter, et installez aussitôt le nouveau secret sur votre serveur.
Signer l'adresse e-mail sur votre serveur
La signature est un HMAC-SHA256 de l'adresse e-mail du visiteur, calculé avec votre secret d'identité comme clé et écrit en hexadécimal minuscule : 64 caractères.
Signez exactement l'adresse e-mail que vous transmettez à identify(). Chatixy ne modifie pas la casse avant de vérifier : Ann@Example.com et ann@example.com donnent des signatures différentes. Calculez la signature sur votre serveur, au moment où vous générez la page ou répondez à votre propre API, jamais dans le navigateur.
Node.js
const crypto = require('crypto');
const userHash = crypto
.createHmac('sha256', process.env.CHATIXY_IDENTITY_SECRET)
.update(user.email)
.digest('hex');PHP
$userHash = hash_hmac('sha256', $user->email, getenv('CHATIXY_IDENTITY_SECRET'));Python
import hashlib
import hmac
import os
user_hash = hmac.new(
os.environ['CHATIXY_IDENTITY_SECRET'].encode(),
user.email.encode(),
hashlib.sha256,
).hexdigest()Ruby
require 'openssl'
user_hash = OpenSSL::HMAC.hexdigest('SHA256', ENV.fetch('CHATIXY_IDENTITY_SECRET'), user.email)Transmettre l'identité au chat
Appelez Chatixy.identify() avec l'adresse e-mail du visiteur et la signature dans user_hash ; name et phone sont facultatifs. Écrivez dans la page les valeurs produites par votre serveur - l'exemple ci-dessous montre des valeurs fictives.
Vous pouvez l'appeler dès que votre page sait qui est le visiteur. Les appels faits avant que le chat soit prêt attendent et s'exécutent dès qu'il l'est, et une identité transmise avant le premier message est rattachée à la conversation que ce message ouvre.
HTML
<script>
window.chatixyAsyncInit = function (Chatixy) {
Chatixy.identify({
email: 'ann@example.com',
name: 'Ann',
user_hash: 'SIGNATURE_FROM_YOUR_SERVER',
});
};
</script>
<script src="https://chatixy.com/source/YOUR_WIDGET_KEY.js" async></script>Si une signature ne correspond pas
Un user_hash qui ne correspond pas n'enregistre rien de cet appel : ni adresse e-mail, ni nom, ni téléphone, ni badge Vérifié. Le chat continue de fonctionner normalement et le visiteur ne voit aucune erreur.
Une conversation vérifiée le reste : un appel identify() ultérieur sans signature ne peut pas l'annuler.
Pourquoi le badge Vérifié n'apparaît-il pas ?
Vérifiez que vous signez exactement l'adresse e-mail que vous transmettez, à la lettre près ; que vous utilisez le secret de ce chat, car chaque chat a le sien ; que la signature est écrite en hexadécimal ; et que personne n'a régénéré le secret depuis que vous l'avez copié.
Dois-je obligatoirement signer l'adresse e-mail ?
Non. identify() sans user_hash transmet tout de même les informations du visiteur à votre boîte de réception. Elles sont marquées comme non vérifiées et ne remplissent que les champs encore vides.