Angemeldete Besucher im Chat erkennen

Teile dem Chat mit, wer auf deiner Website oder in deinem Shop angemeldet ist: Das Gespräch landet direkt beim richtigen Kontakt und der Besucher muss nichts ausfüllen. Optional: Chat nur für angemeldete Besucher.

Was es macht

Normalerweise gibt ein Besucher Name und E-Mail-Adresse ein, bevor der Chat mit deinem Team beginnt. Diese Adresse ist nicht geprüft: Jeder kann jede Adresse eingeben. Deshalb bekommt ein solcher Besucher in Bugalou immer einen eigenen Kontakt, und bei einer bekannten Adresse siehst du Möglicherweise derselbe Kunde wie … mit der Schaltfläche Verknüpfen mit.

Ist der Besucher auf deiner Website oder in deinem Shop angemeldet, kann deine Website das bestätigen. Dann:

  • muss der Besucher Name und E-Mail nicht eingeben (im Formular steht Angemeldet als …, und ohne weitere Fragen startet der Chat sofort);
  • landet das Gespräch direkt beim bestehenden Kontakt, mit früheren Gesprächen und Bestellungen;
  • kann sich niemand als dieser Kunde ausgeben: Bugalou vertraut nur dem, was dein Shop oder dein eigener Server bestätigt.

Shopify und WooCommerce: automatisch

  • Shopify: Mit der Bugalou-App in deinem Shop wird ein angemeldeter Kunde automatisch erkannt. Nichts einzurichten.
  • WooCommerce: Mit dem Plugin Bugalou for WooCommerce (Version 1.8 oder neuer), dem im Plugin aktivierten Chat und deinem mit Bugalou verbundenen Shop. Bugalou prüft den Kunden über diese Verbindung bei deinem Shop.

Eigene Website mit Login

Hat deine Website ein eigenes Login (zum Beispiel ein individuell entwickelter Shop oder ein Kundenportal)? Dann übergibt dein Server den angemeldeten Nutzer an den Chat, mit einem Hash: einer Signatur, die nur dein Server erzeugen kann.

Schritt 1: Verifizierung aktivieren

  1. Gehe zu Kanäle → Website-Chat → Installation.
  2. Klicke bei Angemeldete Besucher erkennen auf Verifizierung aktivieren. Das können nur Inhaber und Admins.
  3. Kopiere den geheimen Schlüssel (beginnt mit bgl_) und hinterlege ihn in den Einstellungen deines Servers, zum Beispiel als Umgebungsvariable BUGALOU_SECRET.

Der Schlüssel gehört nur auf deinen Server. Nie in die Seite, in JavaScript oder in ein öffentliches Repository.

Schritt 2: den Hash auf deinem Server erzeugen

Der Hash ist der HMAC-SHA256 der E-Mail-Adresse des Nutzers, mit dem geheimen Schlüssel. Eine Zeile 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()

Schritt 3: den Nutzer auf die Seite setzen

Füge das auf jeder Seite mit angemeldetem Nutzer ein, vor dem Installationscode des Chats (Beispiel 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>

Ist niemand angemeldet, lass diesen Block einfach weg: Der Chat funktioniert dann wie immer. Der Name ist optional.

Chat nur für angemeldete Besucher

Willst du den Chat nur deinen eigenen Kunden anbieten, zum Beispiel in einem Kundenportal? Aktiviere unter Angemeldete Besucher erkennen den Schalter Chat nur für angemeldete Besucher.

  • Nicht angemeldete Besucher sehen die Chat-Schaltfläche nicht.
  • Bugalou lehnt außerdem neue Chats, Tickets und KI-Fragen ohne gültigen Nachweis ab, sodass der Chat nicht über einen Umweg nutzbar ist.
  • Der Schalter funktioniert mit der Verifizierung deiner eigenen Website und mit einem verbundenen Shopify- oder WooCommerce-Shop. Ohne eines davon lässt er sich nicht aktivieren, damit du den Chat nicht versehentlich für alle ausblendest.

Gut zu wissen

  • Schlüssel geleakt? Klicke auf Neuer Schlüssel. Der alte funktioniert dann sofort nicht mehr; hinterlege den neuen direkt auf deinem Server.
  • Bugalou akzeptiert den Hash der E-Mail-Adresse so, wie du sie speicherst, und auch der kleingeschriebenen Version.
  • Der Nachweis ist 30 Minuten gültig und wird vom Chat automatisch erneuert.
  • Der Kontakt bekommt die bestätigte E-Mail-Adresse. Gibt es bereits einen Kontakt mit dieser Adresse, landet das Gespräch dort.
  • Deaktivierst du die Verifizierung, werden angemeldete Besucher deiner eigenen Website nicht mehr erkannt. Ohne verbundenen Shop wird Chat nur für angemeldete Besucher ebenfalls deaktiviert.

Funktioniert es nicht?

  • Der Besucher muss trotzdem Name und E-Mail eingeben: Der Hash stimmt nicht. Prüfe, dass du den aktuellen Schlüssel verwendest und genau die E-Mail-Adresse aus email hashst.
  • Es passiert nichts: Steht window.BugalouWidget.user vor dem Installationscode, und sind email und hash beide ausgefüllt?
  • Niemand sieht den Chat mehr: Ist Chat nur für angemeldete Besucher aktiv, während deine Website den Nutzer noch nicht übergibt? Deaktiviere den Schalter, bis Schritt 3 fertig ist.

Nicht gefunden, was du suchst?

Stell uns deine Frage direkt, du bekommst eine persönliche Antwort.

Frage stellen