Wat het doet
Normaal vult een bezoeker naam en e-mailadres in voordat de chat met je team begint. Dat adres is niet gecontroleerd: iedereen kan elk adres typen. Daarom krijgt zo'n bezoeker in Bugalou altijd een eigen contact, en zie je bij een bekend adres de melding Mogelijk dezelfde klant als… met de knop Koppel aan.
Is de bezoeker ingelogd op je website of webshop, dan kan je site dat bevestigen. Dan:
- hoeft de bezoeker naam en e-mail niet in te vullen (in het formulier staat Ingelogd als …, en zijn er geen andere vragen, dan start de chat meteen);
- komt het gesprek direct bij het bestaande contact, met de eerdere gesprekken en bestellingen erbij;
- kan niemand zich als die klant voordoen: Bugalou vertrouwt alleen wat je winkel of je eigen server bevestigt.
Shopify en WooCommerce: gaat vanzelf
- Shopify: met de Bugalou-app in je winkel wordt een ingelogde klant automatisch herkend. Je hoeft niets in te stellen.
- WooCommerce: met de plugin Bugalou for WooCommerce (versie 1.8 of nieuwer), de chat aan in de plugin en je winkel gekoppeld aan Bugalou. Bugalou controleert de klant bij je winkel via die koppeling.
Eigen website met een login
Heeft je site een eigen login (bijvoorbeeld een maatwerkwebshop of een klantportaal)? Dan geeft je server de ingelogde gebruiker door aan de chat, met een hash: een handtekening die alleen je server kan maken.
Stap 1: zet de verificatie aan
- Ga naar Kanalen → Websitechat → Installatie.
- Klik bij Ingelogde bezoekers herkennen op Verificatie aanzetten. Dit kunnen alleen eigenaren en admins.
- Kopieer de geheime sleutel (begint met
bgl_) en zet hem in de instellingen van je server, bijvoorbeeld als omgevingsvariabeleBUGALOU_SECRET.
De sleutel hoort alleen op je server. Zet hem nooit in de pagina, in JavaScript of in een openbare repository.
Stap 2: maak de hash op je server
De hash is HMAC-SHA256 van het e-mailadres van de gebruiker, met de geheime sleutel. Eén regel 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()
Stap 3: zet de gebruiker op de pagina
Zet dit op elke pagina waar een gebruiker is ingelogd, vóór de installatiecode van de chat (voorbeeld in 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>
Is niemand ingelogd, laat dit blok dan gewoon weg: de chat werkt dan zoals altijd. De naam is optioneel.
Chat alleen voor ingelogde bezoekers
Wil je de chat alleen aanbieden aan je eigen klanten, bijvoorbeeld in een klantportaal? Zet dan onder Ingelogde bezoekers herkennen de schakelaar Chat alleen voor ingelogde bezoekers aan.
- Bezoekers die niet zijn ingelogd zien de chatknop niet.
- Bugalou weigert ook nieuwe chats, tickets en AI-vragen zonder geldig bewijs, dus de chat is niet via een omweg te gebruiken.
- De schakelaar werkt met de verificatie van je eigen site, en met een gekoppelde Shopify- of WooCommerce-winkel. Zonder een van die drie kun je hem niet aanzetten, zodat je de chat niet per ongeluk voor iedereen verbergt.
Goed om te weten
- Sleutel gelekt? Klik op Nieuwe sleutel. De oude werkt dan meteen niet meer; zet de nieuwe direct op je server.
- Bugalou accepteert de hash van het e-mailadres zoals je het opslaat, en ook van de versie in kleine letters.
- Het bewijs is 30 minuten geldig en wordt door de chat vanzelf ververst.
- Het contact krijgt het bevestigde e-mailadres. Bestaat er al een contact met dat adres, dan komt het gesprek daar.
- Zet je de verificatie uit, dan worden ingelogde bezoekers van je eigen site niet meer herkend. Is er geen gekoppelde winkel, dan gaat Chat alleen voor ingelogde bezoekers mee uit.
Werkt het niet?
- De bezoeker moet toch naam en e-mail invullen: de hash klopt niet. Controleer dat je de huidige sleutel gebruikt en de hash maakt van precies het e-mailadres dat in
emailstaat. - Er gebeurt niets: staat
window.BugalouWidget.uservóór de installatiecode, en zijnemailenhashallebei gevuld? - Niemand ziet de chat meer: staat Chat alleen voor ingelogde bezoekers aan terwijl je site de gebruiker nog niet doorgeeft? Zet de schakelaar uit tot stap 3 klaar is.