Crisp Chat Integration – Dokumentation
Crisp Chat Integration
Fügen Sie das Crisp-Chat-Widget mit Ihrer Crisp Website ID zu Ihrem PrestaShop-Storefront hinzu. Nach der Konfiguration platziert das Modul das JavaScript von Crisp vor dem schließenden Body-Tag, damit Besucher die Chat-Blase auf den Seiten öffnen können, auf denen Sie sie anzeigen möchten.
Das Modul konzentriert sich auf die PrestaShop-Seite der Integration: Widget aktivieren oder deaktivieren, Website ID speichern, Daten angemeldeter Kunden an Crisp übergeben, Widget auf Mobilgeräten ausblenden, Laden des Widgets verzögern und festlegen, wo es erscheint.
Funktionsweise
Geben Sie nach der Installation Ihre Crisp Website ID ein und lassen Sie das Modul aktiviert. Wenn ein Besucher eine zugelassene Seite lädt, gibt das Modul das Loader-Script von Crisp aus:
<script type="text/javascript">
window.$crisp = [];
window.CRISP_WEBSITE_ID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
window.$crisp.push(["set", "user:email", ["customer@example.com"]]);
window.$crisp.push(["set", "user:nickname", ["Jane Customer"]]);
(function() {
var d = document, s = d.createElement("script");
s.src = "https://client.crisp.chat/l.js";
s.async = 1;
d.getElementsByTagName("head")[0].appendChild(s);
})();
</script>
E-Mail-Adresse und Name des Kunden werden nur gesendet, wenn der Besucher angemeldet ist und Pass Customer Data aktiviert ist.
Installation
- Gehen Sie in Ihrem Back Office zu Modules → Module Manager
- Klicken Sie auf Upload a module und wählen Sie die ZIP-Datei aus
- Klicken Sie nach der Installation auf Configure
- Fügen Sie Ihre Crisp Website ID hinzu
- Speichern Sie die Konfiguration
Konfiguration
Enable Crisp Chat, Schaltet das Widget im Storefront ein oder aus. Wenn diese Option deaktiviert ist, gibt das Modul das Crisp-Script nicht aus.
Website ID, Ihre Crisp Website ID im UUID-Format. Dieses Feld ist erforderlich, bevor das Widget geladen werden kann.
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Beispielformat:
12345678-90ab-cdef-1234-567890abcdef
Sie finden sie in Crisp unter Settings → Website Settings → Setup instructions.
Pass Customer Data, Sendet die E-Mail-Adresse und den vollständigen Namen des angemeldeten Kunden an Crisp:
window.$crisp.push(["set", "user:email", ["customer@example.com"]]);
window.$crisp.push(["set", "user:nickname", ["Jane Customer"]]);
Show on Mobile, Steuert, ob das Widget für Besucher angezeigt wird, die von PrestaShop als mobil erkannt werden. Wenn diese Option deaktiviert ist, wird das Widget auf Mobilgeräten nicht gerendert.
Fallback Delay (seconds), Verzögert das Laden des Crisp-Scripts um die von Ihnen eingegebene Anzahl an Sekunden. Verwenden Sie 0, um es sofort zu laden.
0
5
Bei einer Verzögerung größer als null umschließt das Modul den Crisp-Loader wie folgt:
setTimeout(function() {
window.$crisp = [];
window.CRISP_WEBSITE_ID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
/* Crisp loader follows here */
}, 5 * 1000);
Show on Pages, Wählen Sie aus, wo das Chat-Widget erscheint:
all
product
category
checkout
Die Option checkout umfasst diese PrestaShop-Controller:
cart
order
order-opc
orderopc
checkout
Technische Referenz für Shopbetreiber
Das Modul registriert sich an diesem Storefront-Hook:
displayBeforeBodyClosingTag
Die Modulkonfiguration verwendet diese Einstellungsnamen im Admin-Formular:
MPRCRISP_ENABLED
MPRCRISP_WEBSITE_ID
MPRCRISP_SHOW_MOBILE
MPRCRISP_PAGES
MPRCRISP_DELAY
MPRCRISP_PASS_USER_DATA
Standardwerte nach der Installation:
ENABLED=1
WEBSITE_ID=
SHOW_MOBILE=1
PAGES=all
DELAY=0
PASS_USER_DATA=1
Das Modul speichert seine Einstellungen in der gemeinsamen Tabelle mpr_config unter dem Modulnamen:
module=mprcrispchatintegration
context_type=global
context_id=0
key=WEBSITE_ID
value=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Kompatibilität
Kompatibel mit PrestaShop 1.6 bis 9.0 (latest) und PHP 7.1+. Wir unterstützen auch weiterhin kommende PrestaShop-Versionen.
Tipps
- Verwenden Sie Show on Pages, wenn Sie den Chat nur auf wichtigen Kaufseiten anzeigen möchten, etwa auf Produktseiten oder im checkout.
- Lassen Sie Pass Customer Data aktiviert, wenn Ihre Datenschutzerklärung und Ihre Einwilligungslösung dies erlauben; so kann Ihr Team angemeldete Kunden in Crisp besser identifizieren.
- Verwenden Sie Show on Mobile mit Bedacht, wenn Sie bereits feststehende mobile Elemente wie Cookie-Banner oder checkout-Hilfeschaltflächen einsetzen.
- Fügen Sie eine kurze Verzögerung hinzu, wenn der Hauptinhalt des Storefronts geladen werden soll, bevor das Crisp-Script angefordert wird.
- Wenn das Modul eine Konfigurationswarnung anzeigt, prüfen Sie, ob die Website ID vorhanden ist und das UUID-Format verwendet.
Häufig gestellte Fragen
Erscheint das Crisp-Widget auf jeder Seite?
Es erscheint nur dann auf jeder Seite, wenn Show on Pages auf all gesetzt ist. Sie können es außerdem auf Produktseiten, Kategorieseiten oder checkout-Seiten beschränken.
Kann ich das Widget deaktivieren, ohne das Modul zu deinstallieren?
Ja. Setzen Sie Enable Crisp Chat auf No und speichern Sie. Das Modul behält Ihre Einstellungen, gibt das Crisp-Script aber nicht mehr aus.
Gibt das Modul Kundendaten an Crisp weiter?
Ja, wenn Pass Customer Data aktiviert ist und der Besucher angemeldet ist. Das Modul sendet die E-Mail-Adresse und den vollständigen Namen des Kunden an Crisp.
Was passiert, wenn die Website ID leer oder ungültig ist?
Das Widget wird nicht geladen. Außerdem zeigt das Modul einen Konfigurationshinweis an und fordert Sie auf, eine gültige Crisp Website ID hinzuzufügen.
Ändert das Modul Einstellungen im Crisp-Konto?
Nein. Das Modul lädt Crisp nur in Ihrem PrestaShop-Storefront und übergibt die konfigurierten Daten. Gesprächsregeln, Verfügbarkeit, Inbox-Einstellungen und andere Crisp-seitige Funktionen werden in Ihrem Crisp-Konto verwaltet.
Kann ich Farbe oder Position des Widgets über dieses Modul steuern?
Nein. Dieses Modul stellt keine Felder für Farbe oder Position bereit. Verwenden Sie die Einstellungen im Crisp-Dashboard für Darstellungsoptionen auf Crisp-Seite.
