Do czego to służy
Zwykle odwiedzający wpisuje imię i adres e-mail, zanim zacznie się czat z twoim zespołem. Ten adres nie jest weryfikowany: każdy może wpisać dowolny adres. Dlatego w Bugalou taki odwiedzający zawsze dostaje własny kontakt, a przy znanym adresie widzisz komunikat Możliwe, że to ten sam klient co… z przyciskiem Połącz z.
Gdy odwiedzający jest zalogowany na twojej stronie lub w sklepie, twoja strona może to potwierdzić. Wtedy:
- odwiedzający nie musi wpisywać imienia i e-maila (formularz pokazuje Zalogowano jako …, a gdy nie ma innych pytań, czat zaczyna się od razu);
- rozmowa trafia od razu do istniejącego kontaktu, z wcześniejszymi rozmowami i zamówieniami obok;
- nikt nie może podszyć się pod tego klienta: Bugalou ufa tylko temu, co potwierdzi twój sklep lub twój własny serwer.
Shopify i WooCommerce: automatycznie
- Shopify: z aplikacją Bugalou w sklepie zalogowany klient jest rozpoznawany automatycznie. Nie trzeba niczego konfigurować.
- WooCommerce: z wtyczką Bugalou for WooCommerce (wersja 1.8 lub nowsza), czatem włączonym we wtyczce i sklepem połączonym z Bugalou. Bugalou sprawdza klienta w twoim sklepie przez to połączenie.
Własna strona z logowaniem
Twoja strona ma własne logowanie (np. sklep zbudowany na zamówienie lub portal klienta)? Wtedy twój serwer przekazuje zalogowanego użytkownika do czatu wraz z hashem: podpisem, który może utworzyć tylko twój serwer.
Krok 1: włącz weryfikację
- Przejdź do Kanały → Czat na stronie → Instalacja.
- W sekcji Rozpoznawaj zalogowanych odwiedzających kliknij Włącz weryfikację. Mogą to zrobić tylko właściciele i administratorzy.
- Skopiuj tajny klucz (zaczyna się od
bgl_) i umieść go w ustawieniach serwera, np. jako zmienną środowiskowąBUGALOU_SECRET.
Klucz powinien znajdować się wyłącznie na twoim serwerze. Nigdy nie umieszczaj go na stronie, w JavaScripcie ani w publicznym repozytorium.
Krok 2: utwórz hash na serwerze
Hash to HMAC-SHA256 adresu e-mail użytkownika z tajnym kluczem. Jedna linia kodu:
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()
Krok 3: umieść użytkownika na stronie
Umieść to na każdej stronie, na której użytkownik jest zalogowany, przed kodem instalacyjnym czatu (przykład w 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>
Gdy nikt nie jest zalogowany, po prostu pomiń ten blok: czat działa wtedy jak zawsze. Imię jest opcjonalne.
Czat tylko dla zalogowanych odwiedzających
Chcesz oferować czat tylko własnym klientom, np. w portalu klienta? W sekcji Rozpoznawaj zalogowanych odwiedzających włącz Czat tylko dla zalogowanych odwiedzających.
- Niezalogowani odwiedzający nie widzą przycisku czatu.
- Bugalou odrzuca też nowe czaty, zgłoszenia i pytania do AI bez ważnego potwierdzenia, więc czatu nie da się użyć tylnymi drzwiami.
- Przełącznik działa z weryfikacją na własnej stronie oraz z połączonym sklepem Shopify lub WooCommerce. Bez żadnego z nich nie możesz go włączyć, więc nie ukryjesz przypadkiem czatu przed wszystkimi.
Dobrze wiedzieć
- Klucz wyciekł? Kliknij Nowy klucz. Stary od razu przestaje działać; natychmiast umieść nowy na serwerze.
- Bugalou akceptuje hash adresu e-mail w takiej postaci, w jakiej go przechowujesz, oraz jego wersji zapisanej małymi literami.
- Potwierdzenie jest ważne przez 30 minut, a czat sam je odświeża.
- Kontakt dostaje potwierdzony adres e-mail. Jeśli kontakt z tym adresem już istnieje, rozmowa trafia do niego.
- Jeśli wyłączysz weryfikację, zalogowani odwiedzający twojej własnej strony przestaną być rozpoznawani. Bez połączonego sklepu wyłącza się też Czat tylko dla zalogowanych odwiedzających.
Nie działa?
- Odwiedzający nadal musi wpisywać imię i e-mail: hash się nie zgadza. Sprawdź, czy używasz aktualnego klucza i czy hashujesz dokładnie ten adres e-mail, który jest w polu
email. - Nic się nie dzieje: czy
window.BugalouWidget.userjest przed kodem instalacyjnym i czy polaemailihashsą wypełnione? - Nikt już nie widzi czatu: czy opcja Czat tylko dla zalogowanych odwiedzających jest włączona, choć twoja strona jeszcze nie przekazuje użytkownika? Wyłącz ją, dopóki nie skończysz kroku 3.