Vérifier l’identité de vos Contacts

Quand une personne est connectée sur votre site, votre serveur signe un jeton avec le secret d’identité de l’App. Le chat le transmet et le Contact devient un Contact vérifié, avec la même conversation sur tous ses appareils.

1. Ouvrez Paramètres de l’App > Développeurs et cliquez sur « Générer le secret », sous « Vérification d’identité ».
2. Gardez ce secret sur votre serveur, par exemple dans une variable d’environnement. Ne le mettez jamais dans le code de votre site.
3. Sur votre serveur, créez une adresse qui renvoie un jeton JWT signé en HS256 pour la personne connectée. Tout langage serveur convient.
4. Sur votre page, une fois le code d’installation chargé, appelez window.zean.identify avec une fonction qui demande ce jeton. À la déconnexion, appelez window.zean.signOut().

Sur votre serveur (Node.js)

import jwt from 'jsonwebtoken';

app.get('/api/zean-token', (req, res) => {
	const token = jwt.sign(
		{ sub: req.user.id, name: req.user.name, email: req.user.email },
		process.env.ZEAN_IDENTITY_SECRET,
		{ algorithm: 'HS256', expiresIn: '1h' }
	);
	res.type('text/plain').send(token);
});

Sur votre page

window.zean.identify(async () => {
	const response = await fetch('/api/zean-token');
	return response.ok ? await response.text() : null;
});

window.zean.signOut();

Le contenu du jeton

• sub : l’identifiant de la personne chez vous, en texte ou en nombre, 200 caractères au maximum. Obligatoire.
• exp : la date d’expiration du jeton. Obligatoire.
• name et email : le nom et l’e-mail affichés à votre équipe. Facultatifs.

Le chat demande un nouveau jeton une minute avant l’expiration du précédent. Votre fonction renvoie null quand personne n’est connecté. Un jeton invalide ou expiré laisse le Contact anonyme. Seul un jeton refusé, par exemple mal signé, affiche un avertissement dans la console du navigateur.