GetMyBot 知识库

在 React、Next.js 或 Vue 应用中安装

在应用公共布局中安装聊天组件,使页面跳转时保留对话。

本页内容

React、Next.js 和 Vue 应用经常在不完整刷新浏览器的情况下切换页面。小组件代码应放在应用的公共布局中,让聊天窗口不会随页面切换而消失。先从小组件 → 安装复制代码,并在允许的网站中添加应用域名。以下代码放置步骤适合交给网站开发者。聊天设置见网站小组件。

代码放在哪里

将完整片段只插入一次,放在页面切换时仍保留的应用公共布局中:

  • Next.js App Router:根 app/layout.tsx 的 <head> 中,或使用 strategy="afterInteractive" 的 Script 组件。
  • 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> 中。

不要放在单个页面里;路由跳转时应用可能连同打开的聊天一起移除该页面。

如何检查安装

发布修改,打开聊天并通过应用菜单跳到另一页,确认聊天窗口和当前对话仍在。随后发送消息,并在管理页面确认收到。再从小组件 → 安装对已发布页面运行检查安装,结果说明见自动诊断。

为什么只插入一次

切换页面时,打开的聊天应保持原样,因此加载脚本要放在不会被路由移除的公共布局,而不是单页。加载器通过 window.mybot = window.mybot || {} 保留已有会话,重复加载不会创建第二个小组件。但应用如果把聊天所在页面移除,未保存的界面状态仍可能丢失,无需每次跳转都重新运行脚本。

常见问题

  • 不要再把片段重复放入单页;路由跳转可能连同聊天一起移除它。
  • Next.js 的 Script 加载器使用 strategy="afterInteractive",而不是 "beforeInteractive",避免阻塞首次渲染。
  • 发布后清理服务器或 CDN 页面缓存,否则访客可能继续看到没有脚本的旧页面。

下一步