Lewati ke konten utama
ChattyBox Logo

Pemecahan masalah

Gunakan halaman ini ketika widget dipasang tetapi tidak berfungsi seperti yang diharapkan.

Widget Tidak Muncul​

Periksa konsol browser terlebih dahulu. ChattyBox melaporkan atribut yang diperlukan tidak ada di sana.

Penyebab umum:

  • Skrip tidak ada di sumber halaman yang diterapkan.
  • Skrip ditambahkan ke template, tata letak, wadah pengelola tag, atau area kode CMS yang salah.
  • Skrip berada di balik pemicu aturan izin atau pengelola tag yang tidak diaktifkan.
  • Shell aplikasi yang sama menghapus skrip selama navigasi sisi klien.
  • Kebijakan Keamanan Konten memblokir https://chattybox.ai/widget.js.
  • CSS atau widget lain tumpang tindih dengan peluncur.

Perbaikan terkecil:

  1. Buka halaman publik yang diterapkan di jendela penyamaran.
  2. Sumber halaman pencarian untuk chattybox.ai/widget.js.
  3. Konfirmasikan skrip muncul satu kali dan menyertakan data-api-key dan data-api-url.
  4. Pindahkan skrip ke footer global, tata letak aplikasi, root Docusaurus, atau pemicu GTM Semua Halaman jika tidak ada.

Hilang data-api-url​

Widget keluar lebih awal ketika data-api-url hilang.

Gunakan cuplikan lengkap dari dasbor atau tambahkan atribut yang diperlukan:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Jika dasbor Anda menampilkan URL API yang berbeda, gunakan nilai dasbor, bukan nilai contoh.

Kesalahan Kunci atau Asal API tidak valid​

Penyebab umum:

  • Kunci widget publik salah disalin.
  • Kunci telah dihapus, kedaluwarsa, atau dibuat untuk proyek lain.
  • Kunci penahapan diterapkan ke produksi atau kunci produksi diterapkan ke penahapan.
  • Kuncinya telah mengizinkan asal dan asal situs saat ini tidak disertakan.
  • Halaman dimuat dari http://localhost, URL pratinjau, atau domain khusus yang tidak diizinkan untuk kunci tersebut.

Perbaikan:

  1. Buka proyek di dasbor ChattyBox.
  2. Salin cuplikan baru dari tab Sematkan.
  3. Jika asal yang diizinkan dikonfigurasi, tambahkan asal persis yang melayani halaman tersebut, termasuk protokol dan nama host.
  4. Terapkan ulang atau terbitkan ulang situs dan uji lagi di jendela penyamaran.

Bahasa yang Salah​

Chatbot tanpa halusinasi yang andal membutuhkan konten sumber yang jelas untuk setiap jawaban.

Widget memilih bahasa dalam urutan ini:

  1. data-locale pada skrip widget.
  2. Nilai halaman <html lang>.
  3. Bahasa browser pengunjung.
  4. kemunduran bahasa Inggris.

Perbaikan:

  • Hapus nilai data-locale yang salah jika halaman harus mendeteksi bahasa secara otomatis.
  • Tetapkan <html lang="de">, <html lang="fr">, atau kode bahasa yang cocok pada halaman yang dilokalkan.
  • Tambahkan data-locale="de" hanya ketika halaman harus memaksakan bahasa UI widget tertentu.
  • Kikis ulang semua versi bahasa jika jawaban mengutip atau mengambil konten dari bahasa yang salah.

Tidak Ada Kutipan atau Jawaban Lemah​

ChattyBox jawaban dari konten yang diindeks. Kutipan yang hilang atau jawaban yang lemah biasanya berarti konten sumber yang diperlukan tidak diambil atau tidak menjawab pertanyaan dengan jelas.

Perbaikan:

  • Ajukan pertanyaan yang sama di obrolan uji dasbor dan bandingkan halaman yang dikutip.
  • Pastikan halaman sumber bersifat publik dan disertakan dalam perayapan.
  • Tambahkan judul yang jelas, contoh, FAQ, dan teks jawaban langsung ke halaman sumber.
  • Hindari mengandalkan tangkapan layar, video, akordeon tersembunyi, atau konten iframe sebagai satu-satunya sumber.
  • Kikis ulang halaman yang diperbarui, lalu uji lagi.

Halaman Tidak Tergores atau Kontennya Basi​

Penyebab umum:

  • Halaman tersebut hilang dari peta situs yang dikirimkan.
  • Mode URL manual tidak menyertakan halaman.
  • Halaman dialihkan, memblokir crawler, memerlukan autentikasi, atau dikecualikan oleh aturan robot.
  • Konten halaman berubah setelah goresan terakhir.
  • Konten dirender sedemikian rupa sehingga perayap tidak dapat mengekstrak teks yang berguna.

Perbaikan:

  1. Konfirmasikan bahwa halaman dibuka secara publik di jendela browser pribadi.
  2. Gunakan mode peta situs untuk cakupan luas atau URL manual untuk kumpulan yang dikurasi.
  3. Kirimkan URL kanonik, bukan URL pelacakan, URL pengalihan, atau URL masuk.
  4. Kikis ulang setelah memublikasikan perubahan konten.
  5. Periksa dasbor apakah ada halaman yang gagal atau dilewati.

Masih Terjebak​

Kumpulkan detail berikut sebelum menghubungi dukungan:

  • URL halaman publik tempat widget akan muncul.
  • Tangkapan layar atau salinan kesalahan konsol browser apa pun.
  • Apakah halaman menggunakan HTML biasa, Next.js, Docusaurus, WordPress, CMS, atau Google Tag Manager.
  • Apakah cuplikan menyertakan data-api-key dan data-api-url.
  • Satu pertanyaan tes yang seharusnya berfungsi dan halaman sumber yang menjawabnya.