Cơ sở kiến thức GetMyBot

Cài widget trong ứng dụng React, Next.js hoặc Vue

Thêm chat vào ứng dụng React, Next.js hoặc Vue để cuộc trò chuyện không biến mất khi chuyển trang.

Trên trang này

Ứng dụng React, Next.js hoặc Vue thường chuyển trang mà không tải lại toàn bộ trình duyệt. Hãy đặt mã widget trong bố cục chung của ứng dụng để chat vẫn còn khi khách chuyển trang.

Sao chép đoạn mã tại Widget → Cài đặt và thêm tên miền ứng dụng vào Website được phép. Vị trí chèn mã dưới đây dành cho người phát triển website. Các lựa chọn chat được giải thích trong Widget trên website.

Chèn mã ở đâu

Chèn toàn bộ đoạn mã một lần vào bố cục chung không bị tháo khi chuyển trang:

  • Next.js App Router: app/layout.tsx ở gốc, trong <head>, hoặc dùng thành phần Script với strategy="afterInteractive".
  • Next.js Pages Router: pages/_document.tsx, trong <Head>.
  • Vue với Vite hoặc Vue Router: index.html ở gốc dự án, trong <head>. Với Nuxt, hãy nhờ người phát triển đặt mã vào bố cục chung.
  • React Create React App: public/index.html, trong <head>. React Vite: index.html ở gốc dự án, trong <head>.

Không đặt mã trong một trang riêng: ứng dụng có thể tháo trang đó cùng cửa sổ chat khi chuyển trang.

Kiểm tra cài đặt

Xuất bản thay đổi. Mở chat, chuyển trang qua menu ứng dụng và kiểm tra rằng cửa sổ chat cùng cuộc trò chuyện vẫn còn. Sau đó gửi tin và kiểm tra trong GetMyBot.

Vào Widget → Cài đặt và chạy Kiểm tra cài đặt trên trang đã xuất bản. Xem Chẩn đoán tự động để hiểu kết quả.

Vì sao chỉ chèn mã một lần

Cửa sổ chat cần tồn tại khi đổi trang, nên trình tải widget phải nằm trong bố cục chung. Nó giữ phiên bằng window.mybot = window.mybot || {}; tải lại mã không tạo widget thứ hai. Nhưng nếu ứng dụng tháo cả trang chứa chat, trạng thái chưa lưu sẽ mất. Vì vậy không cần chạy lại script sau mỗi lần chuyển trang.

Lưu ý

  • Không chèn lại đoạn mã ở từng trang.
  • Với thành phần Script của Next.js, dùng strategy="afterInteractive" cho trình tải thay vì "beforeInteractive" để không cản trở lần hiển thị đầu.
  • Khi xuất bản, xóa bộ nhớ đệm máy chủ hoặc CDN nếu có, tránh khách tiếp tục nhận trang cũ.

Bước tiếp theo