Documentation · Identification des utilisateurs
Configurer
Identifier vos utilisateurs
Pour un site avec des comptes (SaaS, espace client). Les retours portent le nom de l'utilisateur, vous pouvez effacer tous ses retours en un clic, et il les retrouve sur sa page de suivi.
Déclarer l'utilisateur
Avant le script du widget, sur les pages où l'utilisateur est connecté :
<script>
window.Parlo = {
user: {
id: 'u_123', // obligatoire : votre identifiant interne
email: 'camille@exemple.fr', // facultatif : permet de lui répondre
name: 'Camille', // facultatif : affiché dans Parlo
hash: 'a3f1…', // recommandé : voir ci-dessous
},
}
</script>Si la connexion se fait sans recharger la page, appelez Parlo.identify({ id, email, name, hash }), et Parlo.logout() à la déconnexion. Quand l'e-mail est connu, le widget ne le redemande pas.
Vérifier l'identité
Sans vérification, n'importe qui peut envoyer un retour au nom d'un autre identifiant en modifiant le code de la page. Ces retours sont marqués « Non vérifié ». Avec la vérification, votre serveur signe l'identifiant avec un secret que seuls Parlo et vous connaissez, et le retour est marqué « Vérifié ».
- Dans Parlo : Sites → votre site → Identification → Activer la vérification d'identité. Copiez le secret (
idsec_…). - Gardez-le côté serveur, par exemple dans la variable d'environnement
PARLO_IDENTITY_SECRET. Ne le mettez jamais dans le code de vos pages. - Calculez le hash : HMAC-SHA256 de l'identifiant (en texte) avec le secret, encodé en hexadécimal.
Node.js
import { createHmac } from 'crypto'
const hash = createHmac('sha256', process.env.PARLO_IDENTITY_SECRET)
.update(String(user.id))
.digest('hex')PHP
$hash = hash_hmac('sha256', (string) $user->id, getenv('PARLO_IDENTITY_SECRET'));Python
import hashlib, hmac, os
hash = hmac.new(
os.environ['PARLO_IDENTITY_SECRET'].encode(),
str(user.id).encode(),
hashlib.sha256,
).hexdigest()Passez ensuite la valeur obtenue dans user.hash.
Exiger une identité vérifiée
Avec l'option « Exiger une identité vérifiée », un identifiant sans hash valide est ignoré : le retour est conservé, mais sans identifiant, nom ni e-mail venant de votre code. Le visiteur peut toujours saisir son e-mail lui-même.
Ce que voit l'utilisateur
Après l'envoi, le widget propose un lien « Suivre mon retour ». Pour une identité vérifiée, cette page montre tous les retours de l'utilisateur sur votre espace, avec leur statut et vos réponses ; sinon, seulement le retour envoyé.