Wenn Sie den Intercom Messenger installiert haben und er nicht korrekt erscheint, finden Sie hier einige häufige Lösungen.
Dieser Artikel behandelt jede Web-Integration. Die Web-Integration umfasst 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.
Eine Faustregel besagt: Wenn Sie den Intercom ping in der Web-Konsole sehen, sollte der Code korrekt installiert sein.
1. Haben Sie ein Abonnement, das den Messenger beinhaltet?
Sie können den Messenger nicht verwenden, wenn Sie keine Intercom-Testversion oder ein Abonnement haben.
2. Haben Sie den Nutzerverkehr aktiviert?
Stellen Sie sicher, dass Sie den Nutzerverkehr für den Messenger unter Einstellungen > Channels > Messenger > Installieren aktiviert haben.
3. Haben Sie das Intercom JavaScript-Snippet korrekt installiert?
Es gibt zwei Möglichkeiten, den Intercom Messenger mit JavaScript zu installieren:
Installieren Sie Intercom für Besucher oder leads, damit Sie mit ausgeloggten Besuchern chatten können.
Installieren Sie Intercom für users, damit Sie mit eingeloggten users chatten können.
Sie sollten sicherstellen, dass Sie das richtige JavaScript-Code-Snippet an der richtigen Stelle verwenden.
Wenn Sie den obigen Anleitungen zur Installation des Snippets gefolgt sind, den Messenger aber immer noch nicht sehen, sind hier die nächsten Schritte:
Stellen Sie im JavaScript-Code-Snippet sicher, dass Sie den Platzhalter „
app_id“ durch Ihre Workspace-ID ersetzt haben.Sie müssen das Snippet direkt vor dem Ende des schließenden
</body>-Tags auf Ihrer Website oder in Ihrer App hinzufügen.
Hinweis: Wenn Sie eine Single Page Application (SPA) verwenden, lesen Sie den SPA-Integrationsleitfaden für spezifische Schritte zur Integration des Messengers in einer SPA-Umgebung.
4. Wenn Sie Google Tag Manager zur Installation des Messengers verwenden, zeigen Sie auf die richtige Region?
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.
5. Welche APP_ID verwenden Sie? Haben Sie mehrere Apps?
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.
6. Gibt es einen ping auf der Seite?
Ö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.
7. Haben Sie die richtigen Messenger-Einstellungen aktiviert?
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 vor Ihrem Publikum zu verbergen:
Zeigen Sie den Messenger-Launcher den richtigen Personen?
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 zu zeigen, die bestimmten Daten entsprechen, müssen Ihre Kunden (und Sie) diese Daten erfüllen, um den Messenger zu sehen. Zum Beispiel, wenn Sie den Messenger nur users mit dem Status "VIP" zeigen möchten, sehen nur users mit diesen Daten den Messenger.
Haben Sie eine Messenger-Sicherheitseinstellung durchgesetzt, aber nicht korrekt eingerichtet?
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 Benutzer-ID Ihres users generiert.
Bei der Identitätsprüfung verwenden Sie den Geheimschlüssel aus Ihren Intercom-Sicherheitseinstellungen, um für jeden Ihrer eingeloggten users einen eindeutigen Benutzer-Hash zu generieren, den Sie zusammen mit den anderen Benutzerdaten an den Messenger senden.
Wenn Sie eine Messenger-Sicherheitseinstellung durchsetzen, ohne Tokens oder Hashes korrekt über Ihre Messenger-Integration für jeden user zu senden, lädt der Messenger für diese nicht. Ebenso wird der Messenger nicht geladen, 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 über die Fehlerbehebung bei spezifischen JWT-Fehlern hier oder Identitätsprüfungsfehler hier 📚
Sind Sie auf einer vertrauenswürdigen domain?
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:
Öffnen Sie die Konsole, klicken Sie auf Netzwerk und aktualisieren Sie dann die Seite.
Filtern Sie Netzwerk-Anfragen, indem Sie "ping" eingeben.
Klicken Sie auf den Reiter Antwort.
8. Verwenden Sie eine Public Suffix domain?
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.
9. Sehen Sie einen 409-Fehler in der Konsole?
Wenn Sie einen 409-Fehler in der Konsole sehen, deutet dies auf einen Konflikt hin. Typischerweise wird dieser Konflikt durch mehrere vorhandene users mit derselben E-Mail-Adresse verursacht, und Intercom weiß nicht, mit welchem Sie sich anmelden möchten.
Um dies zu beheben, können Sie entweder:
Verwenden Sie eine
user_idals eindeutigen Bezeichner beim Einloggen Ihrer users.
Weitere Dinge zum Überprüfen
Verwenden Sie eine Werbeblocker-Erweiterung oder den privaten Browsing-Modus?
Einige Werbeblocker-Erweiterungen blockieren auch JavaScript, das Tracking-Funktionalität enthält, wie den Messenger. Erfahren Sie warum das passiert und was Sie dagegen tun können.
Haben Sie das Intercom JavaScript-Snippet geändert oder benutzerdefinierte Stile auf den Messenger angewendet?
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.
Verwenden Sie das WordPress-Plugin?
Wenn Sie das Intercom WordPress-Plugin nur verwenden, um mit ausgeloggten Besuchern zu chatten, müssen Sie sich vor dem Besuch Ihrer Website aus dem WordPress-Admin-Dashboard ausloggen, um den Messenger erscheinen zu sehen.
Sie müssen auch 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 Intercom-JavaScript-Snippet vom 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.
Weitere Möglichkeiten, Fehler zu überprüfen
Sie können die Konsole Ihres Browsers auf weitere Fehler überprüfen, wenn Ihr Messenger immer noch nicht korrekt geladen wird. So überprüfen Sie dies in jedem Webbrowser:
In Chrome verwenden Sie die Tastenkombination Strg + Umschalt + J (Windows) oder Befehl + Option + J (Mac), um die Entwicklerkonsole zu öffnen.
In Firefox verwenden Sie die Tastenkombination Strg + Umschalt + K (Windows) oder Befehl + Option + K (Mac). Die Toolbox erscheint unten im Browserfenster mit aktivierter Webkonsole.
In Edge verwenden Sie die F12-Taste, um die F12-Entwicklertools zu öffnen. Navigieren Sie dann zum Reiter Konsole.
In Safari müssen Sie das Entwicklermenü aktivieren. Öffnen Sie das Safari-Menü in der Mac-Menüleiste und wählen Sie „Einstellungen“. Navigieren Sie dann zum Tab Erweitert und aktivieren Sie das Kontrollkästchen „Entwicklermenü in der Menüleiste anzeigen“. Sie können nun die Tastenkombination Befehl + Option + C verwenden, um die Entwicklerkonsole zu öffnen.
Wenn Sie weiterhin Probleme beim Laden des Messengers haben, chatten Sie mit uns im Messenger, wir helfen Ihnen gerne!
Was tun, wenn der Messenger in meinem eigenen inbox nicht erscheint und ich den Support nicht erreichen kann?
Es wurde entschieden, den Messenger in einigen Situationen innerhalb des Inbox zu verbergen, damit er nicht mit der Seitenleiste/Copilot kollidiert. Die Lösung besteht darin, zu einer anderen Seite in der App zu wechseln und den Messenger-Launcher von dort aus zu öffnen.
Hinweis: Wenn Sie keinen Zugriff auf die Messenger-Einstellungen haben, stellen Sie sicher, dass Sie die Berechtigung "Kann auf Messenger-Einstellungen zugreifen" aktiviert haben.