À 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
- Allez dans Canaux → Chat du site web → Installation.
- Sous Reconnaître les visiteurs connectés, cliquez sur Activer la vérification. Seuls les propriétaires et les administrateurs peuvent le faire.
- Copiez la clé secrète (commence par
bgl_) et placez-la dans les paramètres de votre serveur, par exemple dans la variable d'environnementBUGALOU_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.userest-il bien placé avant le code d'installation, etemailethashsont-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.