GetMyBot 知識庫

在 React、Next.js 或 Vue 應用程式安裝聊天小工具

將聊天程式碼加入共用版型,讓對話在 React、Next.js 或 Vue 換頁後仍保留。

本頁內容

React、Next.js 和 Vue 應用程式常在不重新載入瀏覽器的情況下換頁。請把聊天小工具加入不會隨頁面切換而移除的共用版型,讓開啟的對話得以保留。

先從**「聊天小工具 → 安裝」複製程式碼,並把應用程式網域加入「允許的網站」**。以下程式碼位置供網站開發者使用;聊天設定見網站聊天小工具。

插入位置

將完整程式碼在共用版型中加入一次:

  • Next.js App Router:根目錄 app/layout.tsx 的 <head>,或使用 Script 並設定 strategy="afterInteractive"。
  • Next.js Pages Router:pages/_document.tsx 的 <Head>。
  • Vue + Vite / Vue Router:專案根目錄 index.html 的 <head>。Nuxt 應由開發者加入應用程式共用版型。
  • React Create React App:public/index.html 的 <head>。React + Vite:根目錄 index.html 的 <head>。

不要放在個別頁面,否則換頁時開啟的聊天可能一起被移除。

驗證安裝

發佈變更後開啟聊天,透過應用程式選單換頁,確認聊天與目前對話仍在。接著傳送訊息,並在 GetMyBot 後台確認收到。

再到**「聊天小工具 → 安裝」對已發佈頁面執行「檢查安裝」**,結果見自動診斷。

為何只加入一次

載入器使用 window.mybot = window.mybot || {} 保留既有工作階段;重複載入不會建立第二個小工具。但如果應用程式連同頁面移除了聊天,尚未保存的狀態可能遺失。因此不必每次換頁都重新執行指令碼。

常見問題

  • 不要在個別頁面重複加入程式碼;換頁可能移除聊天。
  • Next.js 的 Script 請使用 strategy="afterInteractive",不要用 "beforeInteractive" 阻塞首次畫面繪製。
  • 伺服器或 CDN 若快取頁面,發佈後請清除快取,避免訪客繼續看到沒有程式碼的舊頁面。

下一步