在 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 若快取頁面,發佈後請清除快取,避免訪客繼續看到沒有程式碼的舊頁面。