JivoChat-Integration: Einrichtung und Hilfe

Verbinden Sie Ihren Shop mit JivoChat. Sie benötigen ein bestehendes Dienstkonto und dessen Kennwert Widget-ID. Konfigurieren Sie Unterhaltungen und das sichtbare Widget im Dienstkonto.

Die Aktion "Configure" des Moduls öffnet JivoChat-Konfiguration. Die Konfigurationsseite zeigt außerdem einen Hinweis zur erforderlichen Konfiguration und ein Integritätsbanner an. Verwenden Sie die Modulseiten Konfiguration, "Integrity", Lizenz, Support und Aktualisieren für die jeweiligen Wartungsarbeiten.

Verbindungswert finden

Kopieren Sie die Widget-ID aus dem Installationscode für Ihren Website-Kanal in JivoChat. Der Einrichtungsbereich verweist auf "Manage" > "Channels" > "Website widget". 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 5 bis 128 Buchstaben oder Ziffern. Bei einer abgelehnten Kennung bleibt die zuvor gespeicherte Konfiguration erhalten. Korrigieren Sie den Wert und speichern Sie erneut.

Legen Sie diese Felder in JivoChat-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

Wenn Kundendaten übermitteln aktiviert und der Kunde angemeldet ist, registriert das Modul vor dem Laden des Widgets window.jivo_onLoadCallback. Wenn JivoChat diesen Callback aufruft und jivo_api verfügbar ist, übermittelt er Name und E-Mail-Adresse über jivo_api.setContactInfo. Wählen Sie Nein, um diese Übergabe zu unterlassen.

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.

Das Modul registriert displayBeforeBodyClosingTag. Zuerst prüft es den Aktivierungsschalter, den Verbindungswert sowie die Geräte- und Seitenregel. Anschließend fügt es einen verzögerten Loader nahe dem Seitenende ein.

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. Der gemeinsame Loader entfernt die interne Vorlagenverzögerung, sodass die beiden Wartezeiten nicht addiert werden. 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:

//code.jivosite.com/widget/{Widget ID}

Öffnen Sie das Widget und senden Sie eine Testnachricht. Prüfen Sie, ob sie im Posteingang des Dienstes ankommt. Testen Sie abschließend die ausgeschlossenen Seiten und Mobilgeräte.

Verwalten Sie Mitarbeiter, Kanäle, Weiterleitung, Offline-Formulare und Automatisierung in JivoChat. Dieses Modul stellt den Widget-Loader für den Shop und die Anzeigeregeln bereit.

• Wenn kein Loader ausgegeben wird, prüfen Sie JivoChat aktivieren, Widget-ID, 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 Name oder E-Mail-Adresse des angemeldeten Kunden fehlen, prüfen Sie Kundendaten übermitteln, laden Sie die Seite neu und suchen Sie nach Fehlern oder einer anderen Integration, die window.jivo_onLoadCallback ersetzt.
• 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/mprjivochat/views/templates/hook/displayBeforeBodyClosingTag.tpl

nach:

themes/your-theme/modules/mprjivochat/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 MPRJIVO_. Die aktuelle Speicherung erfolgt für das Modul mprjivochat in der gemeinsamen Tabelle mpr_config mit kurzen Schlüsseln:

ENABLED
WIDGET_ID
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 JivoChat 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.