Freshchat-Integration: Einrichtung und Hilfe

Verbinden Sie Ihren Shop mit Freshchat über ein bestehendes Dienstkonto und dessen Token. Konfigurieren Sie Unterhaltungen und das sichtbare Widget im Dienstkonto.

Die Modulaktion "Configure" öffnet Freshchat-Konfiguration. Die Seite zeigt außerdem einen Hinweis zur erforderlichen Konfiguration und ein Integritätsbanner. Verwenden Sie die Modulseiten Konfiguration, "Integrity", Lizenz, Support und Aktualisieren für die jeweiligen Wartungsarbeiten.

Verbindungswert finden

Kopieren Sie den Token aus Ihrem Freshchat-Web-Messenger-Installationscode. Das Modul verweist auf "Settings" > "Web Messenger". Fügen Sie nur die Kennung ein. Fügen Sie keine vollständige URL und kein vollständiges Skript ein.

Der Standardwert ist leer. Bei neuen oder geänderten Kennungen erwartet das Modul eine UUID mit Hexadezimalziffern im Format 8-4-4-4-12. Bei einer abgelehnten Kennung bleibt die zuvor gespeicherte Konfiguration erhalten. Korrigieren Sie den Wert und speichern Sie erneut.

Legen Sie diese Felder in Freshchat-Konfiguration fest und klicken Sie auf Speichern.

Seitengruppen

Die Auswahl erfolgt anhand der Controllernamen. Ein eigener Checkout-Controller außerhalb dieser Liste wird von Nur Bestellseiten nicht erfasst. Es gibt kein Feld für eigene URL-Regeln. Auf Mobilgeräten anzeigen verwendet die Mobilgeräteerkennung von PrestaShop und nicht nur die Browserbreite.

Kundenfelder

Das Widget verwendet den gespeicherten Token und verbindet sich mit https://wchat.freshchat.com. Wenn Kundendaten übermitteln aktiviert ist, sendet es die E-Mail-Adresse des angemeldeten Kunden als Kundenkennung und E-Mail-Adresse sowie seinen vollständigen Namen als Vornamen.

Gäste erhalten durch dieses Modul keine PrestaShop-Felder zur Kundenidentität. Der Dienst kann weiterhin über sein eigenes Widget Informationen erfassen. Dieses Modul synchronisiert weder den Bestellverlauf noch den Warenkorbinhalt.

Beispielkonfiguration

Wählen Sie für Bestellseiten auf Desktopgeräten Nur Bestellseiten, setzen Sie Auf Mobilgeräten anzeigen auf Nein und "Fallback Delay (seconds)" auf 2. Der Loader startet bei der ersten Interaktion oder nach zwei Sekunden ohne Interaktion.

Der Widget-Loader erscheint nahe dem Ende zugelassener Shopseiten, wenn das Modul aktiviert, der Verbindungswert ausgefüllt und das Gerät zugelassen ist.

Scrollen, klicken oder tippen Sie auf die Seite oder drücken Sie eine Taste, um den Loader auszulösen. Warten Sie ohne Interaktion die konfigurierte Ersatzwartezeit ab. Warten Sie beim Installationsstandard 0 10 Sekunden, bevor Sie bei einer Seite ohne Interaktion von einem Ladefehler ausgehen.

Prüfen Sie in den Entwicklerwerkzeugen des Browsers, ob eine Anfrage mit folgendem Muster vorhanden ist:

https://wchat.freshchat.com/js/widget.js

Öffnen Sie das Widget und senden Sie eine Testnachricht. Prüfen Sie, ob sie im Posteingang des Dienstes ankommt. Testen Sie mit einem angemeldeten Konto, wenn Sie Kundendaten übermitteln aktiviert haben, und prüfen Sie, welche Identitätsfelder der Dienst erhält. Testen Sie abschließend die ausgeschlossenen Seiten und Mobilgeräte.

Dieses Modul hat keine Einstellung "Host". Ein regionaler oder eigener Host erfordert eine Änderung der Vorlage durch einen Entwickler. Verwalten Sie Begrüßungen, Farben, Bots, Kampagnen, Mitarbeiter und Posteingangsregeln in Freshchat.

• Wenn kein Loader ausgegeben wird, prüfen Sie Freshchat aktivieren, Token, Auf Seiten anzeigen und Auf Mobilgeräten anzeigen.
• Warten Sie bei einer Seite ohne Interaktion die Ersatzwartezeit ab oder interagieren Sie mit der Seite. "Fallback Delay (seconds)" auf 0 bedeutet kein sofortiges Laden.
• Wenn das Speichern fehlschlägt, lassen Sie die Kennung ausgefüllt, prüfen Sie ihr Format, laden Sie die Konfigurationsseite neu und versuchen Sie es erneut. Verwenden Sie für einen Live-Test keine Platzhalter-Zugangsdaten.
• Wenn die externe Anfrage fehlschlägt, prüfen Sie Fehler in der Browserkonsole, Skriptblockierungen, die Content Security Policy und etwaige Einwilligungswerkzeuge in Ihrem Shop.
• Wenn das Skript lädt, aber die Schaltfläche zum Öffnen fehlt, prüfen Sie die Veröffentlichung des Widgets im Dienst, die Verfügbarkeit des Kontos und die Anzeigeregeln.
• Wenn ein Kundenfeld fehlt, melden Sie sich an und prüfen Sie, ob Kundendaten übermitteln auf Ja steht. Vergleichen Sie die Daten mit den oben aufgeführten Feldern.
• Wenn eine andere Integration das Dienstskript ebenfalls einfügt, prüfen Sie die gerenderte Seite auf doppelten oder widersprüchlichen Installationscode.

Eigenes Theme prüfen

Ihr Theme muss den Hook vor dem schließenden body-Tag ausführen. Ein Entwickler kann diesen Aufruf vor </body> ergänzen, wenn er im Theme fehlt:

{hook h='displayBeforeBodyClosingTag'}

Kopieren Sie für eine Anpassung der Theme-Vorlage:

modules/mprfreshchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

nach:

themes/your-theme/modules/mprfreshchat/views/templates/hook/displayBeforeBodyClosingTag.tpl

Behalten Sie die Smarty-Variablen des Moduls und das Escaping der Kennung bei. Der gemeinsame Interaktions-Wrapper gilt weiterhin für diese Hook-Vorlage.

Das Formular verwendet für übermittelte Feldnamen das Präfix MPRFCHAT_. Die aktuelle Speicherung erfolgt für das Modul mprfreshchat in der gemeinsamen Tabelle mpr_config mit kurzen Schlüsseln:

ENABLED
TOKEN
SHOW_MOBILE
PAGES
DELAY
PASS_USER_DATA

Die Datenbanktabelle verwendet das Tabellenpräfix Ihres Shops; ps_mpr_config ist daher nur ein Beispielname. Verwenden Sie für normale Änderungen das Konfigurationsformular. Behandeln Sie die Formularfeldnamen nicht als aktuelle Datenbankschlüssel.

Setzen Sie Freshchat aktivieren auf Nein und speichern Sie mit weiterhin ausgefüllter Kennung, um die Ausgabe dieses Moduls zu pausieren. Sie können das Modul auch unter "Module Manager" deaktivieren.

Verwenden Sie zum Entfernen "Uninstall" unter "Module Manager" und bestätigen Sie. Bei der Deinstallation werden die Modulkonfiguration und die Einträge im Admin-Menü entfernt. Das externe Dienstkonto wird dadurch nicht geschlossen und Code aus anderen Modulen oder Themes wird nicht entfernt.