Wenn Sie den Intercom Messenger installiert haben und er nicht richtig erscheint, finden Sie hier einige häufige Lösungen.

Dieser Artikel behandelt jede Web-Integration. Die Web-Integration beinhaltet das Hinzufügen des JavaScript-Code-Snippets auf einer Webseite oder kann automatischer erfolgen, wie bei unseren WordPress- und Shopify-Apps, die nur Klicken und Autorisieren erfordern.

Sie können den Messenger nicht verwenden, wenn Sie keine Intercom-Testversion oder ein Abonnement haben.

Stellen Sie sicher, dass Sie den Nutzerverkehr für den Messenger unter Einstellungen > Channels > Messenger > Installieren aktiviert haben.

Es gibt zwei Möglichkeiten, den Intercom Messenger mit JavaScript zu installieren:

Sie sollten sicherstellen, dass Sie das richtige JavaScript-Code-Snippet am richtigen Ort verwenden.

Wenn Sie den obigen Anleitungen zur Installation des Snippets gefolgt sind, aber den Messenger immer noch nicht sehen, sind hier die nächsten Schritte:

Für eine korrekte GTM-Konfiguration stellen Sie sicher, dass das GTM-Skript im <head>-Abschnitt Ihres HTML platziert ist und dass Tags korrekt konfiguriert und veröffentlicht sind. Weitere Informationen finden Sie im GTM-Installationsleitfaden.

Diese App verwendet eine codefreie Methode zur Installation des Intercom Messengers. Wenn Sie GTM mit einem regionalen Workspace verwenden, müssen Sie "api_base" als benutzerdefiniertes Datenattribut unter dem Abschnitt "tracking custom data about your users" mit dem regionalen Wert übergeben:

Weitere Informationen finden Sie in diesem Artikel.

Haben Sie sie falsch eingegeben oder haben Sie mehrere Apps? Überprüfen Sie die app_id in der ping-Anfrage (In Chrome: Rechtsklick auf die Seite > Untersuchen > Netzwerk); wenn Sie den ping nicht sehen, laden Sie die Seite neu.

Sie können auch intercomSettings in der Konsole überprüfen, aber das gilt nur für nicht Single-Page-Apps. Single-Page-Apps haben möglicherweise kein definiertes intercomSettings.

Öffnen Sie die Konsole und versuchen Sie eine schnelle Methode, den Messenger mit Intercom('show'); zu laden.

Wenn das nicht funktioniert, suchen Sie nach der ping-Anfrage (Sie müssen die Seite wahrscheinlich neu laden, um sie zu sehen). Wenn Sie keine ping-Anfrage sehen, ist das Intercom-Snippet wahrscheinlich nicht installiert oder nicht korrekt installiert.

Es gibt verschiedene Möglichkeiten, den Messenger anzupassen und zusätzliche Sicherheitsebenen hinzuzufügen. Einige Einstellungen können jedoch verhindern, dass der Messenger geladen wird, wenn sie falsch konfiguriert sind.

Beim Installieren des Messengers ist es möglich, ihn vor dem Start für Ihr Publikum zu verbergen:

In den Messenger-Einstellungen können Sie "Ihr eingehendes Gesprächsvolumen steuern" und den Messenger-Launcher so konfigurieren, dass er Besuchern oder users angezeigt wird oder wenn sie bestimmten Daten entsprechen.

Wenn Sie sich entscheiden, den Messenger Besuchern oder users anzuzeigen, die bestimmten Daten entsprechen, müssen Ihre Kunden (und Sie) diese Daten erfüllen, um den Messenger zu sehen. Zum Beispiel sehen nur users mit dem Status "VIP" den Messenger, wenn Sie ihn nur für diese anzeigen möchten.

Der Messenger lädt nicht, wenn JWT-Authentifizierung / Identitätsprüfung falsch eingerichtet ist. Außerdem muss die Messenger API in den Einstellungen Ihrer App aktiviert sein, damit die Switch-Oberfläche korrekt funktioniert. Wenn die Messenger API deaktiviert ist, lädt Switch nicht und zeigt möglicherweise eine leere Seite an.

Bei JWTs müssen Sie ein eindeutiges Token für die Anfragen Ihres users generieren und dieses beim Starten des users bereitstellen. Dieses eindeutige Token wird mit Ihrem Messenger API-Geheimschlüssel und mindestens der eindeutigen externen user-ID generiert.

Bei der Identitätsprüfung verwenden Sie den Geheimschlüssel aus Ihren Intercom-Sicherheitseinstellungen, um für jeden Ihrer eingeloggten users einen eindeutigen User-Hash zu generieren, den Sie zusammen mit den anderen Nutzerdaten an den Messenger senden.

Wenn Sie eine Messenger-Sicherheitseinstellung erzwingen, ohne Tokens oder Hashes korrekt über Ihre Messenger-Integration für jeden user zu senden, lädt der Messenger für diese nicht. Ebenso lädt der Messenger nicht, wenn Sie die Identitätsprüfung mit ungültigen Tokens oder Hashes für jeden user erzwingen.

Der einfachste Weg, um zu sehen, ob dies die Ursache Ihres Problems ist, besteht darin, die Browser-Konsole zu öffnen und nach spezifischen Fehlermeldungen zu suchen.

Lesen Sie mehr zur Fehlerbehebung bei spezifischen JWT-Fehlern hier oder zu Identitätsprüfungsfehlern hier 📚

Unter Halten Sie Ihren Messenger sicher können Sie die vertrauenswürdigen domains auflisten, auf denen Sie Intercom installiert haben.

Wenn diese domains falsch hinzugefügt wurden oder die domain, auf der Sie sich befinden, nicht aufgeführt ist, lädt der Messenger nicht und Sie sehen einen 403-Fehler in Ihrer Browser-Konsole.

Schritte zum Finden von vertrauenswürdigen domain-Fehlern in der Konsole:

Die Installation von Intercom auf Ihrer Website hängt davon ab, dass der Messenger ein First-Party-Cookie für Ihre domain erstellen kann, wie *.customer-domain.com. Dies schlägt (bei modernen Browsern) auf jeder domain fehl, die als Public Suffix registriert ist, wie firebaseapp.com oder herokuapp.com. Hier finden Sie die vollständige Liste der Public Suffix domains.

Wenn Sie einen 409-Fehler in der Konsole sehen, deutet dies auf einen Konflikt hin. Typischerweise wird dieser Konflikt durch mehrere existierende users mit derselben E-Mail-Adresse verursacht, und Intercom weiß nicht, mit welchem Sie sich anmelden möchten. Dieser Konflikt kann auch ohne sichtbaren Konsolenfehler auftreten – das Messenger-Panel erscheint möglicherweise leer oder lädt nicht, besonders wenn keine user_id zusammen mit der E-Mail gesendet wird.

Um dies zu beheben, können Sie entweder:

Werbeblocker-Erweiterungen und private Browsing-Modi können verhindern, dass der Messenger geladen wird, indem sie das Intercom-Skript (js.intercomcdn.com) blockieren. Erfahren Sie warum das passiert und was Sie dagegen tun können.

Wie Sie bestätigen, dass ein Werbeblocker die Ursache ist

Wie man es behebt

Das Ändern des Installationscodes oder das Anwenden eigener CSS auf Intercom-Elemente kann unerwartete Ergebnisse haben, daher raten wir davon ab. Wenn Sie einen speziellen Anwendungsfall haben, chatten Sie mit unserem Support-Team im Messenger. Wir können Sie in die richtige Richtung weisen. 😄 Stellen Sie außerdem sicher, dass der Parameter hide_default_launcher im intercomSettings-Objekt nicht auf true gesetzt ist, es sei denn, dies ist beabsichtigt. Passen Sie diesen Parameter an oder entfernen Sie ihn, wenn er mit den Sichtbarkeitsregeln kollidiert.

Wenn Sie das Intercom WordPress-Plugin nur für den Chat mit ausgeloggten Besuchern verwenden, müssen Sie sich vor dem Besuch Ihrer Website aus dem WordPress-Admin-Dashboard ausloggen, um den Messenger zu sehen.

Sie müssen außerdem WordPress 4.2.0 und PHP 5.6 oder höher haben, damit der Messenger korrekt geladen wird, wenn er mit dem Plugin installiert ist.

Bestimmte WordPress-Themes enthalten nicht das Footer-Element, in das das JavaScript-Snippet von Intercom durch das Plugin eingefügt wird. Wenn Sie ein Theme ohne Footer verwenden, müssen Sie Intercom mit dem JavaScript-Snippet direkt auf Ihren WordPress-Seiten installieren.

Sie können die Konsole Ihres Browsers auf weitere Fehler überprüfen, wenn Ihr Messenger immer noch nicht richtig lädt. So prüfen Sie es in jedem Webbrowser:

Wenn Sie weiterhin Probleme beim Laden des Messengers haben, chatten Sie mit uns im Messenger, wir helfen Ihnen gerne!

Es wurde entschieden, den Messenger in einigen Situationen innerhalb des Inbox zu verbergen, damit er nicht mit der Seitenleiste/Copilot kollidiert. Die Lösung ist, zu einer anderen Seite in der App zu wechseln und den Messenger-Launcher von dort zu öffnen.