HubSpot Chat-Integration: Einrichtung und Hilfe

Mit dieser Anleitung verbinden Sie Ihren Shop mit HubSpot. Sie benötigen ein bestehendes Dienstkonto und den Wert für Portal-ID. Konfigurieren Sie Unterhaltungen und das sichtbare Widget im Dienstkonto.

Die Modulaktion "Configure" öffnet HubSpot Chat-Konfiguration. Der Konfigurationscontroller zeigt außerdem einen Hinweis auf erforderliche Konfiguration und ein Integritätsbanner. Verwenden Sie die Modulseiten Konfiguration, "Integrity", Lizenz, Support und Aktualisieren für die jeweiligen Wartungsarbeiten.

Verbindungswert finden

Kopieren Sie Ihre numerische HubSpot-Portal-ID, auch Hub ID genannt, aus den Kontodetails oder dem Installationscode. Das Einrichtungspanel verweist auf "Settings" > "Account Defaults" > "Account Info". Fügen Sie nur die Kennung ein, keine vollständige URL und kein Skript. Die Navigation im Anbieterkonto stammt aus der Einrichtungsanleitung des Moduls und kann in Ihrem Konto abweichen.

Der Standardwert ist leer. Bei neuen oder geänderten Kennungen erwartet das Modul 1 bis 20 Ziffern. Bei Ablehnung bleibt die zuvor gespeicherte Konfiguration erhalten. Korrigieren Sie den Wert und speichern Sie erneut.

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

Seitengruppen

Die Ausrichtung verwendet 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 statt allein die Browserbreite.

Kundenfelder

Vor dem Laden des Skripts stellt das Template für einen angemeldeten Kunden mit aktivierter Datenübermittlung _hsq.push(['identify', {email: 'customer@example.com'}]) in die Warteschlange. Es sendet nur die E-Mail-Adresse; Kundennamen werden nicht gesendet. Der Loader verwendet hs-script-loader und fügt kein zweites Element mit dieser ID ein.

Gästen übermittelt dieses Modul keine PrestaShop-Kundenidentitätsfelder. Der Dienst kann über sein eigenes Widget weiterhin Daten erfassen. Dieses Modul synchronisiert weder Bestellverlauf noch Warenkorbinhalte.

Beispielkonfiguration

Wählen Sie für Checkout-Seiten 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. Es prüft zuerst Aktivierungsschalter, Verbindungswert, Geräte- und Seitenregel. Danach fügt es einen verzögerten Loader nahe dem Seitenende ein.

Scrollen, klicken, berühren Sie die Seite oder drücken Sie eine Taste, um den Loader auszulösen. Warten Sie ohne Interaktion auf die konfigurierte Ersatzladezeit. Der gemeinsame Loader entfernt die interne Template-Verzögerung, sodass sich die Wartezeiten nicht addieren. Warten Sie beim Installationsstandard 0 10 Sekunden, bevor Sie eine Seite ohne Interaktion als Ladefehler einstufen.

Prüfen Sie in den Entwicklertools des Browsers, ob eine passende Anfrage vorliegt:

//js.hs-scripts.com/{Portal ID}.js

Öffnen Sie das Widget und senden Sie eine Testnachricht. Prüfen Sie den Eingang im Dienstpostfach. Testen Sie bei aktiviertem Kundendaten übermitteln mit einem angemeldeten Konto und prüfen Sie, welche Identitätsfelder der Dienst erhält. Testen Sie abschließend ausgeschlossene Seiten und Mobilgeräte.

Veröffentlichen und konfigurieren Sie Ihren Chatflow in HubSpot. Verwalten Sie Darstellung, Postfach-Routing, Termine und CRM-Verhalten in HubSpot.

• Wenn kein Loader ausgegeben wird, prüfen Sie HubSpot Chat aktivieren, Portal-ID, Auf Seiten anzeigen und Auf Mobilgeräten anzeigen.
• Warten Sie auf einer Seite ohne Interaktion auf die Ersatzladezeit oder interagieren Sie mit ihr. "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 bei einem Live-Test keine Platzhalter-Zugangsdaten.
• Wenn die externe Anfrage fehlschlägt, prüfen Sie Browserkonsolenfehler, Skriptblockierung, Content Security Policy und Einwilligungstools Ihres Shops.
• Wenn das Skript lädt, aber die Startschaltfläche fehlt, prüfen Sie Widget-Veröffentlichung, Kontoverfügbarkeit und Anzeigeregeln beim Dienst.
• Wenn ein Kundenfeld fehlt, melden Sie sich an und prüfen Sie, ob Kundendaten übermitteln auf Ja steht. Vergleichen Sie mit den oben genau aufgeführten Feldern.
• Wenn eine andere Integration ebenfalls das Dienstskript 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, falls er im Theme fehlt:

{hook h='displayBeforeBodyClosingTag'}

Kopieren Sie für eine Anpassung des Theme-Templates:

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

nach:

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

Behalten Sie die Smarty-Variablen und das Escaping der Kennung bei. Der gemeinsame Interaktions-Wrapper gilt weiterhin für dieses Hook-Template.

Das Formular verwendet für übermittelte Feldnamen das Präfix MPRHSCHAT_. Aktuell werden die Werte für Modul mprhubspotchat in der gemeinsamen Tabelle mpr_config mit kurzen Schlüsseln gespeichert:

ENABLED
PORTAL_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 Formularfeldnamen nicht als aktuelle Datenbankschlüssel.

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

Verwenden Sie zum Entfernen "Uninstall" im "Module Manager" und bestätigen Sie. Die Deinstallation entfernt die Modulkonfiguration und Admin-Menüeinträge. Sie schließt weder das externe Dienstkonto noch entfernt sie Code aus anderen Modulen oder dem Theme.