Reconnaître les visiteurs connectés dans le chat

Indiquez au chat qui est connecté à votre site ou à votre boutique : la conversation va directement au bon contact et le visiteur n'a rien à remplir. En option : le chat réservé aux visiteurs connectés.

À quoi ça sert

Normalement, un visiteur saisit son nom et son adresse e-mail avant que le chat avec votre équipe ne commence. Cette adresse n'est pas vérifiée : n'importe qui peut saisir n'importe quelle adresse. Dans Bugalou, un tel visiteur reçoit donc toujours son propre contact, et pour une adresse connue vous voyez Peut-être le même client que… avec un bouton Associer à.

Lorsque le visiteur est connecté à votre site ou à votre boutique, votre site peut le confirmer. Dans ce cas :

  • le visiteur n'a pas besoin de saisir son nom ni son e-mail (le formulaire affiche Connecté en tant que …, et s'il n'y a pas d'autres questions, le chat démarre aussitôt) ;
  • la conversation va directement au contact existant, avec ses conversations et commandes précédentes à côté ;
  • personne ne peut se faire passer pour ce client : Bugalou ne fait confiance qu'à ce que votre boutique ou votre propre serveur confirme.

Shopify et WooCommerce : automatique

  • Shopify : avec l'application Bugalou dans votre boutique, un client connecté est reconnu automatiquement. Rien à configurer.
  • WooCommerce : avec l'extension Bugalou for WooCommerce (version 1.8 ou ultérieure), le chat activé dans l'extension et votre boutique connectée à Bugalou. Bugalou vérifie le client auprès de votre boutique via cette connexion.

Votre propre site avec un espace de connexion

Votre site a son propre système de connexion (par exemple une boutique développée sur mesure ou un portail client) ? Votre serveur transmet alors l'utilisateur connecté au chat, avec un hash : une signature que seul votre serveur peut générer.

Étape 1 : activer la vérification

  1. Allez dans Canaux → Chat du site web → Installation.
  2. Sous Reconnaître les visiteurs connectés, cliquez sur Activer la vérification. Seuls les propriétaires et les administrateurs peuvent le faire.
  3. Copiez la clé secrète (commence par bgl_) et placez-la dans les paramètres de votre serveur, par exemple dans la variable d'environnement BUGALOU_SECRET.

La clé doit rester uniquement sur votre serveur. Ne la mettez jamais dans la page, dans du JavaScript ou dans un dépôt public.

Étape 2 : générer le hash sur votre serveur

Le hash est le HMAC-SHA256 de l'adresse e-mail de l'utilisateur, calculé avec la clé secrète. Une seule ligne de code :

PHP

$hash = hash_hmac('sha256', $user->email, BUGALOU_SECRET);

Node.js

const crypto = require('crypto');
const hash = crypto.createHmac('sha256', process.env.BUGALOU_SECRET)
  .update(user.email).digest('hex');

Python

import hmac, hashlib, os
hash = hmac.new(os.environ['BUGALOU_SECRET'].encode(),
                user.email.encode(), hashlib.sha256).hexdigest()

Étape 3 : placer l'utilisateur sur la page

Placez ceci sur chaque page où un utilisateur est connecté, avant le code d'installation du chat (exemple en PHP) :

<script>
  window.BugalouWidget = window.BugalouWidget || {};
  window.BugalouWidget.user = {
    email: <?php echo json_encode($user->email); ?>,
    name: <?php echo json_encode($user->name); ?>,
    hash: <?php echo json_encode(hash_hmac('sha256', $user->email, BUGALOU_SECRET)); ?>
  };
</script>

Lorsque personne n'est connecté, omettez simplement ce bloc : le chat fonctionne alors comme d'habitude. Le nom est facultatif.

Chat réservé aux visiteurs connectés

Vous souhaitez proposer le chat uniquement à vos propres clients, par exemple dans un portail client ? Sous Reconnaître les visiteurs connectés, activez Chat réservé aux visiteurs connectés.

  • Les visiteurs non connectés ne voient pas le bouton de chat.
  • Bugalou refuse aussi les nouveaux chats, tickets et questions à l'IA sans preuve valide, pour que le chat ne puisse pas être utilisé par une porte dérobée.
  • L'interrupteur fonctionne avec la vérification de votre propre site et avec une boutique Shopify ou WooCommerce connectée. Sans l'un des deux, vous ne pouvez pas l'activer : vous ne risquez donc pas de masquer le chat pour tout le monde par erreur.

Bon à savoir

  • Clé divulguée ? Cliquez sur Nouvelle clé. L'ancienne cesse aussitôt de fonctionner ; installez immédiatement la nouvelle sur votre serveur.
  • Bugalou accepte le hash de l'adresse e-mail telle que vous l'enregistrez, ainsi que celui de sa version en minuscules.
  • La preuve est valable 30 minutes et le chat la renouvelle tout seul.
  • Le contact reçoit l'adresse e-mail confirmée. Si un contact avec cette adresse existe déjà, la conversation y est rattachée.
  • Si vous désactivez la vérification, les visiteurs connectés de votre propre site ne sont plus reconnus. Sans boutique connectée, Chat réservé aux visiteurs connectés se désactive aussi.

Ça ne fonctionne pas ?

  • Le visiteur doit encore saisir son nom et son e-mail : le hash ne correspond pas. Vérifiez que vous utilisez la clé actuelle et que vous hachez exactement l'adresse e-mail présente dans email.
  • Rien ne se passe : window.BugalouWidget.user est-il bien placé avant le code d'installation, et email et hash sont-ils tous deux renseignés ?
  • Plus personne ne voit le chat : Chat réservé aux visiteurs connectés est-il activé alors que votre site ne transmet pas encore l'utilisateur ? Désactivez-le jusqu'à ce que l'étape 3 soit terminée.

Vous ne trouvez pas ce que vous cherchez ?

Posez-nous directement votre question et vous recevrez une réponse personnelle.

Poser votre question