Basis pengetahuan GetMyBot

Memasang chat di aplikasi React, Next.js, atau Vue

Tempat memasang kode chat agar percakapan tetap terbuka saat pengunjung berpindah halaman dalam aplikasi React, Next.js, atau Vue.

Di halaman ini

Situs yang dibuat dengan React, Next.js, atau Vue sering berpindah halaman tanpa memuat ulang seluruh browser. Kode widget perlu dipasang pada bagian umum aplikasi agar chat tidak hilang saat pengunjung berpindah halaman.

Salin kode dari Widget → Instalasi dan tambahkan domain aplikasi ke Situs yang diizinkan. Petunjuk penempatan kode di bawah ini ditujukan kepada pengembang situs. Pengaturan chat dijelaskan di Widget di situs.

Tempat memasang kode

Pasang seluruh kode satu kali pada bagian umum aplikasi yang tetap ada saat halaman berganti. Lokasinya bergantung pada teknologi situs:

  • Next.js (App Router): app/layout.tsx utama, di dalam <head>, atau gunakan komponen Script dengan strategy="afterInteractive".
  • Next.js (Pages Router): pages/_document.tsx, di dalam <Head>.
  • Vue dengan Vite atau Vue Router: index.html di akar proyek, di dalam <head>. Untuk Nuxt, minta pengembang memasangnya pada templat umum aplikasi.
  • React dengan Create React App: public/index.html, di dalam <head>. React dengan Vite: index.html di akar proyek, di dalam <head>.

Jangan pasang kode hanya di satu halaman. Saat berpindah halaman, aplikasi dapat menghapus halaman tersebut bersama chat yang sedang terbuka.

Cara memeriksa

Terbitkan perubahan. Buka chat, lalu berpindahlah ke halaman lain melalui menu aplikasi. Pastikan jendela chat dan percakapan tetap ada. Kirim pesan dan periksa apakah pesan muncul di ruang kerja GetMyBot.

Setelah itu, buka Widget → Instalasi dan jalankan Periksa instalasi pada halaman yang sudah diterbitkan. Arti hasilnya dijelaskan di Pemeriksaan otomatis.

Mengapa kode hanya dipasang sekali

Chat yang sudah dibuka harus tetap ada ketika halaman berubah. Karena itu, pasang widget pada bagian umum aplikasi yang tidak dihapus saat berpindah, bukan di dalam satu halaman.

Kode pemuat mempertahankan sesi yang ada melalui window.mybot = window.mybot || {}. Memuat kode lagi tidak membuat widget kedua. Namun, jika aplikasi menghapus halaman bersama chat, keadaan percakapan yang belum tersimpan dapat hilang. Anda tidak perlu menjalankan ulang skrip pada setiap perpindahan halaman.

Hal yang perlu diperhatikan

  • Jangan memasang kode yang sama lagi pada halaman lain. Aplikasi dapat menghapus halaman itu bersama chat saat berpindah.
  • Jika memakai komponen Script di Next.js, gunakan strategy="afterInteractive", bukan "beforeInteractive", agar pemuatan widget tidak menghambat tampilan awal halaman.
  • Jika server atau CDN menyimpan salinan halaman, bersihkan cache saat menerbitkan perubahan. Jika tidak, pengunjung mungkin masih menerima halaman lama tanpa kode widget.

Langkah berikutnya