Intercom Chat-Integration: Einrichtung und Hilfe

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

Die Aktion "Configure" des Moduls öffnet Intercom-Konfiguration. Der Konfigurationscontroller 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 App-ID aus dem Installationscode Ihres Intercom-Arbeitsbereichs oder den Wert nach /apps/ in dessen URL. Der Einrichtungsbereich des Moduls verweist auf "Settings" > "Installation" > "Web". 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 64 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 Intercom-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 Ihre App-ID. Mit aktiviertem Kundendaten übermitteln sendet es auch E-Mail-Adresse und vollständigen Namen des angemeldeten Kunden. Ein vorhandenes Intercom-Widget wird erneut verbunden und aktualisiert, ohne eine zweite Kopie zu laden.

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:

https://widget.intercom.io/widget/{App ID}

Ö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.

Verwalten Sie die Posteingangszuweisung, Mitarbeiter, Bots, ausgehende Nachrichten, Touren und das Erscheinungsbild in Intercom. Dieses Modul hat kein Feld "Identity Verification HMAC". Es fügt weder Bestellverlauf, Warenkorbinhalt, gekaufte Produkte, Browserverlauf noch eigene Attribute hinzu.

• Wenn kein Loader ausgegeben wird, prüfen Sie Intercom Chat aktivieren, App-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 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/mprintercom/views/templates/hook/displayBeforeBodyClosingTag.tpl

nach:

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

ENABLED
APP_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 Intercom 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 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.