GetMyBot-Wissensdatenbank

Installation in React-, Next.js- oder Vue-Anwendungen

Binden Sie den Chat in React, Next.js oder Vue so ein, dass er bei Seitenwechseln erhalten bleibt.

Auf dieser Seite

In React-, Next.js- oder Vue-Anwendungen wechseln Seiten häufig ohne vollständiges Neuladen des Browsers. Binden Sie den Widget-Code im gemeinsamen Anwendungslayout ein, damit der Chat beim Wechsel nicht verschwindet.

Kopieren Sie das Snippet unter Widget → Installation und tragen Sie die Domain der Anwendung unter Erlaubte Websites ein. Die nachfolgenden Einbauorte sind für die Entwickler Ihrer Website gedacht. Die Chat-Einstellungen erklärt Widget auf der Website.

Wo wird das Snippet eingefügt?

Fügen Sie das vollständige Snippet einmal in ein gemeinsames Layout ein, das beim Seitenwechsel bestehen bleibt. Der Ort hängt vom Framework ab:

  • Next.js (App Router): app/layout.tsx im Wurzelverzeichnis, innerhalb von <head> oder mit der Komponente Script und strategy="afterInteractive".
  • Next.js (Pages Router): pages/_document.tsx innerhalb von <Head>.
  • Vue mit Vite oder Vue Router: index.html im Projektwurzelverzeichnis innerhalb von <head>. Bei Nuxt übergeben Sie das Snippet den Entwicklern; es gehört in das gemeinsame Anwendungslayout.
  • React mit Create React App: public/index.html innerhalb von <head>. React mit Vite: index.html im Projektwurzelverzeichnis innerhalb von <head>.

Fügen Sie das Snippet nicht in eine einzelne Seite ein: Beim Wechsel kann die Anwendung diese Seite mitsamt geöffnetem Chat entfernen.

Installation prüfen

Veröffentlichen Sie die Änderung. Öffnen Sie den Chat und wechseln Sie über das Anwendungsmenü auf eine andere Seite. Chat und laufende Unterhaltung müssen erhalten bleiben. Senden Sie danach eine Nachricht und prüfen Sie sie im Dashboard.

Starten Sie anschließend unter Widget → Installation die Funktion Installation prüfen auf einer veröffentlichten Seite. Die Ergebnisse erklärt Automatische Diagnose.

Warum der Code nur einmal eingebunden wird

Der geöffnete Chat soll beim Seitenwechsel bestehen bleiben. Deshalb gehört das Widget in ein gemeinsames Layout, das beim Wechsel nicht entfernt wird, und nicht in eine einzelne Seite.

Der Loader erhält die bestehende Sitzung über window.mybot = window.mybot || {}; erneutes Einbinden erzeugt kein zweites Widget. Entfernt die Anwendung jedoch die Seite samt Chat, kann ungespeicherter Zustand verloren gehen. Starten Sie das Skript daher nicht bei jedem Wechsel erneut.

Häufige Stolperstellen

  • Fügen Sie das Snippet nicht zusätzlich auf einzelnen Seiten ein: Die Anwendung könnte sie beim Wechsel mitsamt Chat entfernen.
  • Verwenden Sie für den Loader mit der Next.js-Komponente Script strategy="afterInteractive" statt "beforeInteractive", damit das erste Rendern nicht blockiert wird.
  • Leeren Sie beim Veröffentlichen gegebenenfalls den Cache von Server oder CDN. Sonst sehen Besucher weiterhin die alte Seite ohne neuen Code.

Weiterführende Artikel