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 baik di HTML yang di-deploy maupun DOM langsung.
  • 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.
  • Komponen aplikasi yang memasang loader tidak pernah berjalan pada rute tersebut.
  • 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. Cari chattybox.ai/widget.js di sumber halaman dan panel Elements browser; loader yang disuntikkan SDK atau JavaScript mungkin hanya ada di DOM langsung.
  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.

Untuk proyek yang dikelola konfigurasi, widget.enabled: false mencegah widget ter-host diinisialisasi dan membuat request publik POST /chat mengembalikan 403 Widget is disabled, termasuk request SDK headless. Ubah pengaturan itu melalui alur deployment konfigurasi, bukan dengan merotasi kunci publik. Menghapus skrip setelah inisialisasi tidak menghapus widget yang sudah dirender.

401 Invalid API key Generik​

Penyebab umum:

  • Kunci widget publik salah disalin.
  • Kunci dihapus, kedaluwarsa, atau disalin dari deployment backend yang berbeda dari URL API.
  • Proyek atau pemilik kunci sedang dihapus.
  • Pembatasan origin opsional diaktifkan dan origin situs saat ini tidak tercantum.

Perbaikan:

  1. Buka proyek di dasbor ChattyBox.
  2. Salin cuplikan baru dari tab Sematkan.
  3. Periksa Public Keys > Edit origins hanya jika Restrict this key to specific origins diaktifkan. Tambahkan origin persis yang menyajikan halaman atau nonaktifkan pembatasan opsional. Skema, hostname, dan port harus cocok; path tidak memerlukan entri terpisah.
  4. Terapkan ulang atau terbitkan ulang situs dan uji lagi di jendela penyamaran.

Kunci valid untuk chatbot lain pada backend yang sama biasanya memilih chatbot tersebut alih-alih menghasilkan 401; periksa proyek jika jawaban tidak terkait. Nama kunci seperti “production” dan “staging” tidak menegakkan environment. Pembatasan origin bukan pengganti autentikasi pengunjung.

Bahasa yang Salah​

Widget memilih bahasa dalam urutan ini:

  1. data-locale pada skrip widget, hanya jika Allow script override diaktifkan.
  2. Dalam mode Fixed, bahasa default yang dikonfigurasi.
  3. Dalam mode Auto-detect, <html lang> halaman, lalu bahasa browser, lalu default yang dikonfigurasi.

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.
  • Untuk memaksa bahasa yang dikonfigurasi, pilih Fixed dan nonaktifkan Allow script override. Jika override aktif, data-locale tetap diprioritaskan bahkan dalam mode Fixed.
  • Simpan pengaturan, muat ulang widget terpasang, dan uji lagi. Locale ditentukan saat inisialisasi, bukan pada setiap perubahan rute sisi klien.
  • 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, markup tersembunyi yang dikecualikan, konten khusus JavaScript, atau iframe sebagai satu-satunya sumber.
  • Kikis ulang halaman yang diperbarui ketika cooldown mengizinkan, tunggu tugas embedding, lalu uji lagi.
  • Periksa peringatan Partially indexed; teks setelah batas 512 KiB per halaman tidak dipertahankan. Pisahkan halaman sumber panjang.
  • Buat setiap pertanyaan mandiri; riwayat percakapan tersimpan saat ini tidak disertakan dalam prompt generator jawaban.

Halaman Tidak Tergores atau Kontennya Basi​

Penyebab umum:

  • Halaman tersebut hilang dari peta situs yang dikirimkan.
  • Mode URL manual tidak menyertakan halaman.
  • Halaman memblokir fetch HTTP biasa, memerlukan autentikasi, mengembalikan CAPTCHA/error, atau dialihkan ke target yang diblokir.
  • Konten halaman berubah setelah goresan terakhir.
  • Konten hanya dirender JavaScript atau berada di luar root konten semantik yang dipilih.
  • URL terpilih melampaui kuota halaman, anggaran refresh bulanan habis, atau difilter aturan include/exclude.

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 dan cooldown refresh: minimal tujuh hari sejak tugas terakhir dibuat di Free atau 24 jam di paket berbayar, termasuk jika tugas itu gagal.
  5. Bandingkan jumlah tersimpan/terpilih tugas dan daftar Content dengan URL yang dituju. Completed dapat mencakup URL terlewati/gagal; Completed with warnings secara khusus menandai teks halaman yang disimpan sebagian, bukan semua kegagalan crawl.

ChattyBox tidak membaca atau menerapkan robots.txt. Jangan hilangkan perlindungan akses atau membuat konten privat menjadi URL publik agar dapat di-crawl. Jika URL dihapus dari situs atau pilihan sumber, halaman tersimpannya dapat tetap dipakai; hapus juga dari Content. Rebuild Index memakai teks tersimpan, bukan fetch jaringan baru.

Pengaturan Tidak Tersimpan​

Simpan General Settings dengan Save Changes dan Scraping Configuration dengan Save Config sebelum scraping pertama. Menyimpan satu formulir tidak menyimpan yang lain; dasbor memerlukan Website URL tersimpan bahkan untuk URL Manual.

Jika proyek Config locked, konfigurasi harus di-deploy melalui alur CLI. Lock tidak dapat dibuka; penyimpanan Persona, konfigurasi scraping, Scrape Now, penghapusan konten, dan rebuild indeks ditolak meskipun kontrol masih terlihat. Hanya preferensi branding tetap dapat diedit di dasbor dalam batas paket.

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.

Pilihan privasi

Kami menggunakan alat analitik dan pengelolaan tag opsional untuk memahami penggunaan situs. Pilih apakah Anda ingin mengizinkan alat berikut: Ahrefs Web Analytics, PostHog, dan Google Tag Manager. Menonaktifkan analitik akan memuat ulang halaman ini agar perubahan diterapkan dengan baik. Fungsi penting situs dan pemantauan kesalahan tidak dikendalikan oleh pilihan ini. Baca kebijakan privasi kami.