Lewati ke konten utama

Daftar Periksa Peluncuran

Gunakan daftar periksa ini sebelum menampilkan ChattyBox kepada pelanggan. Daftar ini menangkap celah penyiapan umum yang membuat chatbot terlihat terpasang tetapi belum siap.

Untuk peluncuran dukungan, padukan daftar periksa ini dengan panduan chatbot AI untuk dukungan pelanggan agar jawaban dari konten publik memiliki jalur eskalasi yang jelas untuk pertanyaan khusus akun, sensitif, atau belum terselesaikan.

Kesiapan Konten​

  • Konten publik yang dapat di-crawl telah dipilih sebagai sumber jawaban chatbot.
  • Halaman privat, admin, checkout, akun, draf, dan staging dikecualikan melalui pemilihan sumber yang disengaja, bukan hanya robots.txt (yang tidak diterapkan crawler).
  • Anda memilih input yang tepat: sitemap, URL manual, hanya beranda, atau crawl. Crawl memakai sitemap konvensional yang ditemukan sebelum fallback ke tautan; crawler tidak mengisi sitemap tidak lengkap dengan mengikuti tautan.
  • Halaman produk, harga, kebijakan, dukungan, FAQ, onboarding, dan pemecahan masalah yang penting disertakan.
  • Situs multibahasa menyertakan versi bahasa yang Anda harapkan menjadi sumber jawaban widget.

Validasi Scraping​

  • Scraping berakhir, jumlah tersimpan/terpilih dibandingkan, dan halaman yang diharapkan ada. Badge Selesai saja tidak membuktikan cakupan penuh.
  • Jumlah halaman yang diindeks sesuai dengan perkiraan untuk paket dan cakupan peluncuran Anda.
  • Halaman Diindeks sebagian ditinjau untuk teks yang hilang setelah batas 512 KiB; halaman panjang dipisah bila perlu.
  • Pekerjaan embedding terpisah selesai dan pengambilan representatif diuji.
  • Halaman yang baru-baru ini diedit atau dimigrasikan sudah di-scrape ulang.
  • Halaman hilang diperiksa untuk autentikasi, tantangan bot, redirect gagal/tidak aman, filter sumber, atau konten yang hanya dimuat JavaScript. Teks penting harus tersedia dalam HTML yang diambil tanpa perlu merender JavaScript.
  • Halaman tersimpan yang usang dihapus dari Pengetahuan → Halaman, bukan hanya dari sitemap, lalu sumbernya disesuaikan agar halaman itu tidak ditemukan lagi.

Penggunaan dan Kepemilikan​

  • Pemilik proyek dapat membuka dasbor dan mengelola chatbot; kunci publik serta keanggotaan organisasi bukan izin untuk mengakses dasbor.
  • Akun & Tagihan di /settings/account menunjukkan kuota pesan yang cukup untuk pengujian dan trafik peluncuran di seluruh chatbot milik pemilik.
  • Periksa batas halaman tersimpan dan anggaran refresh halaman bulanan yang terpisah. Keduanya dibagi di seluruh chatbot/proyek pemilik; anggaran direset pada awal bulan kalender UTC. Rebuild indeks manual juga memakai anggaran refresh.
  • Jadwal refresh sesuai paket: Free maksimal mingguan, paket berbayar maksimal harian. Cooldown untuk percobaan scraping manual sama (7 hari untuk Free, 24 jam untuk paket berbayar), termasuk setelah tugas gagal; tugas yang masih tertunda atau berjalan juga memblokir scraping manual baru.
  • Pada Pro/Business, PAYG dinonaktifkan, dibatasi per fitur, atau sengaja dibiarkan tanpa batas. PAYG tidak menghapus cooldown crawler atau anggaran refresh bulanan.
  • Jika kunci konfigurasi digunakan, pahami bahwa pembatasannya tidak dapat dibatalkan dan alur kerja token deployment rahasia terpisah.

Kualitas Jawaban​

  • Anda mengajukan pertanyaan pengujian nyata dari kasus penggunaan penjualan, dukungan, onboarding, dan dokumentasi.
  • Jawaban yang representatif didasarkan pada konten terindeks, dan pertanyaan yang tidak didukung konten mendapat fallback yang diharapkan. Tinjau jawabannya; tes yang berhasil tidak menjamin semua jawaban berikutnya akurat.
  • Sitasi sumber muncul pada jawaban yang bermanfaat.
  • Tautan sitasi membuka halaman sumber publik yang diharapkan.
  • Jawaban lemah telah diperbaiki dengan meningkatkan konten sumber atau menambahkan halaman yang hilang, lalu melakukan scraping ulang.
  • Jika Persona diubah, pastikan status penyimpanan menunjukkan bahwa perubahan berhasil disimpan; perbaiki kesalahan validasi atau coba simpan ulang jika penyimpanan gagal sebelum menguji. Uji respons fallback yang diberlakukan secara terpisah; redaksi Persona tidak menggantikan respons konteks hilang yang dikonfigurasi.
  • Pertanyaan tes menyertakan konteks yang cukup: generator jawaban menerima maksimal 12 pesan tersimpan terbaru, masing-masing dipotong hingga 2.000 karakter, bukan seluruh percakapan.

Instalasi Widget​

  • Widget dipasang pada halaman publik yang dituju.
  • Skrip dimuat hanya sekali per halaman.
  • Skrip menyertakan data-api-key.
  • Skrip menyertakan data-api-url.
  • Deteksi otomatis / Tetap dan Izinkan override skrip diatur dengan sengaja. data-locale hanya menang saat override diaktifkan, bahkan dalam mode Tetap.
  • Bahasa UI widget, bahasa pertanyaan/jawaban, dan versi bahasa terindeks diuji secara terpisah.
  • Widget terbuka dan mengirim pertanyaan uji di jendela penyamaran.
  • Pengujian viewport seluler memastikan peluncur dan panel chat dapat digunakan.

Pemeriksaan Kunci API dan Pembatasan Origin Opsional​

  • Kunci publik yang dituju dipilih di Pasang → Instalasi situs web; pengaturannya dikelola di Kunci & domain.
  • Saat merotasi kunci, pasang dan uji kunci baru sebelum menghapus yang lama. Nama kunci saja tidak membatasi environment.
  • Kunci publik diuji pada situs produksi, pratinjau/staging, dan localhost yang dituju. Periksa pembatasannya: kunci yang disiapkan untuk suatu situs mungkin sudah dibatasi ke origin situs tersebut; kunci tanpa pembatasan berfungsi dari semua origin.
  • Jika penguatan opsional diaktifkan, Kunci & domain > Edit origin mencantumkan origin tepat yang dituju (skema, hostname, dan port harus cocok). Pembatasan origin bukan autentikasi pengunjung; kunci browser publik bukan rahasia.
  • Tidak ada kunci API server privat, token admin, atau rahasia dalam kode frontend, GTM, HTML kustom CMS, atau sumber halaman.

Pemeriksaan Browser dan Deployment​

  • Konsol browser tidak memiliki error ChattyBox.
  • Content Security Policy mengizinkan skrip widget dan URL API jika situs menggunakan CSP.
  • Pemblokir iklan atau alat persetujuan tidak memblokir widget pada halaman tempat widget diharapkan muncul.
  • Situs final yang di-deploy, bukan hanya pengembangan lokal, telah diuji.

Setelah Peluncuran​

  • Tinjau Percakapan → Riwayat (tersedia di semua paket). Analisis dan Pertanyaan yang belum terjawab hanya tersedia di Pro atau Business. Uji chatbot juga tersedia di semua paket.
  • Pahami Analisis sebagai maksimal 5.000 interaksi tercatat dari 30 hari terakhir, termasuk Uji chatbot. Ini bukan bukti akurasi jawaban dan bukan laporan trafik pengunjung saja. Chat uji memakai kuota pesan pemilik.
  • Tinjau kesenjangan yang terdeteksi, uji ulang konten yang diperbaiki, lalu tandai kesenjangan sebagai selesai secara manual. Daftar default menyembunyikan kesenjangan yang sudah selesai; Sertakan kesenjangan yang sudah diselesaikan. menampilkannya dan Urungkan membukanya kembali. Kesenjangan tidak terbuka kembali otomatis saat pertanyaannya muncul lagi.
  • Jika atribusi halaman penting, periksa Pemicu Populer. Widget ter-host mengirim konteks halaman, termasuk pathname (tanpa query string atau fragmen); jangan muat atau biarkan widget aktif di rute sensitif/privat. Pemicu rute di SPA saja tidak menghapus widget yang sudah diinisialisasi di rute lain; lakukan teardown secara sengaja. sendMessage() pada SDK headless tidak mengirim konteks halaman.
  • Tambahkan dokumentasi, FAQ, atau contoh yang hilang berdasarkan pertanyaan pengunjung nyata.
  • Scrape ulang halaman yang diperbarui setelah perubahan konten.
  • Rotasi kunci widget publik bila perlu; perbarui pembatasan origin hanya jika pembatasan opsional diaktifkan dan domain yang diizinkan berubah.
  • Penghapusan percakapan tidak digunakan untuk mereset pemakaian atau analytics; catatan tersebut terpisah.

Jika ada item yang gagal, gunakan Pemecahan Masalah sebelum peluncuran.