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

    Ouvrez les réglages du chat

    Dans votre projet, cliquez sur Configurer sur le site, puis ouvrez Paramètres avancés.

  2. 2

    Copiez le secret

    Sous Secret d'identité, cliquez sur Afficher, puis sur Copier.

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