Aller au contenu
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é :

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

JavaScript
import { createHmac } from 'crypto'

const hash = createHmac('sha256', process.env.PARLO_IDENTITY_SECRET)
  .update(String(user.id))
  .digest('hex')

PHP

PHP
$hash = hash_hmac('sha256', (string) $user->id, getenv('PARLO_IDENTITY_SECRET'));

Python

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.

Régénérer le secret invalide les hash calculés avec l'ancien : mettez à jour votre serveur juste après. Désactiver la vérification supprime le secret.

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