Lewati ke konten utama

Memulai

Kuota halaman yang termasuk dalam paket dan didokumentasikan dibagikan di antara proyek milik pemilik yang sama. Lihat harga untuk kuota paket dan Akun & Tagihan di dasbor untuk penggunaan saat ini serta kuota akun yang tersedia.

Bangun chatbot yang berguna sebelum memasangnya di situs Anda. Urutan intinya adalah buat → tambahkan konten → tinjau → uji → sesuaikan → integrasikan.

1. Buat Akun dan Proyek​

Masuk ke dasbor ChattyBox, pilih Chatbot Baru, lalu beri nama proyek dan URL Situs Web opsional. Setelah proyek dibuat, Pengetahuan → Impor & segarkan akan terbuka. Jika membuka proyek tanpa memilih tab, tab defaultnya adalah Ringkasan. Pembuatan proyek saja tidak memulai impor.

Lihat harga untuk batas proyek, halaman, dan penggunaan saat ini.

2. Konfigurasikan Sumber Konten​

Di Pengetahuan → Impor & segarkan, hubungkan situs web publik, tinjau halaman yang ditemukan, sesuaikan pilihan yang direkomendasikan atau pilihan khusus, lalu mulai impor atau penyegaran halaman yang dipilih. Perubahan pengaturan sumber tersimpan otomatis: periksa status penyimpanan dan atasi kesalahan validasi atau coba lagi jika penyimpanan gagal sebelum melanjutkan. Pengaturan sumber lanjutan juga menyediakan tindakan Scrape Sekarang terpisah yang menggunakan mode penemuan yang dikonfigurasi. Aturan include/exclude dan kedalaman crawl tersedia melalui konfigurasi sebagai kode, bukan kontrol dasbor.

ChattyBox mengekstrak konten HTML yang mudah dibaca dan mengantrekan konten yang berubah untuk pengindeksan. Penemuan dan penyimpanan otomatis tidak dengan sendirinya memulai impor. Layanan tidak merender JavaScript atau menerapkan robots.txt; gunakan halaman publik yang berhak Anda indeks dan tentukan cakupan peluncuran dengan sengaja. Waktu pemrosesan bergantung pada penemuan, jumlah halaman, dan pekerjaan pengindeksan.

Gunakan Tambahkan dan segarkan konten jika Anda memerlukan panduan tentang sitemap, URL manual, crawl, multibahasa, atau scraping ulang.

3. Tinjau Konten yang Diindeks​

Buka Pengetahuan → Halaman dan bandingkan halaman aktual dengan sumber yang diharapkan. Buka tugas scraping untuk meninjau jumlah dan peringatan konten parsial, lalu periksa tugas embedding terpisah sebelum mengevaluasi jawaban. Scrape yang selesai tidak menjamin setiap halaman atau setiap bagian yang diminta telah diindeks. Lihat progres dan pengindeksan parsial.

4. Uji Kualitas Jawaban​

Buka Uji chatbot dan ajukan pertanyaan representatif yang akan digunakan pengunjung nyata. Pastikan jawaban:

  • menggunakan dokumentasi yang diindeks, bukan asumsi yang tidak didukung;
  • menautkan ke halaman sumber yang bermanfaat;
  • menangani informasi yang hilang dengan fallback yang dimaksudkan;
  • berfungsi untuk bahasa dan terminologi penting.

Perbaiki konten sumber atau pemilihan sumber lalu segarkan lagi ketika cooldown paket mengizinkan: maksimal sekali seminggu pada Free dan sekali sehari pada paket berbayar. Fitur Uji chatbot memakai kuota pesan pemilik dan menyimpan percakapan. Interaksi pengujian dapat muncul di Percakapan → Analisis dan, jika terdeteksi sebagai tidak terjawab, di Percakapan → Pertanyaan yang belum terjawab; penagihan dan pencatatan kesenjangan bergantung pada hasilnya. Jangan memasang chatbot hanya karena scraping pertama selesai.

5. Sesuaikan Pengalaman​

Gunakan Sesuaikan → Perilaku untuk memilih Asisten yang Membantu, Perwakilan Penjualan, Dukungan Teknis, Bot Sarkastik, atau Persona Kustom dan mengedit instruksi. Perubahan disimpan otomatis; periksa status penyimpanan sebelum melanjutkan. Mengedit preset akan mengubahnya menjadi Persona Kustom. Instruksi ini melengkapi aturan grounding dan format bawaan ChattyBox; konten yang diambil ditambahkan secara otomatis, jadi jangan tempel basis pengetahuan ke prompt.

Teks Persona tidak menggantikan fallback yang diwajibkan untuk konteks/kesenjangan konten yang hilang. assistant.fallbackMessage terpisah tersedia melalui konfigurasi sebagai kode, bukan kolom Persona. Uji pertanyaan yang didukung dan perilaku fallback setelah perubahan disimpan.

Jika memakai widget ter-host, gunakan Sesuaikan → Tampilan untuk melihat pratinjau judul, pesan sambutan, warna, ikon, posisi, dan perilaku bahasa. Perubahan disimpan otomatis; periksa status penyimpanan. Mode Tetap dan override skrip hanya memengaruhi bahasa UI widget, bukan bahasa halaman yang diindeks; lihat pemecahan masalah bahasa. Paket Free mencakup pengaturan gaya tetapi tetap menampilkan branding ChattyBox; Starter dan paket yang lebih tinggi dapat menyembunyikannya.

Pilihan ini dibuat setelah pengujian konten agar penyiapan visual tidak menyembunyikan masalah pengambilan atau dokumentasi.

6. Pilih Integrasi​

TujuanLangkah berikutnya
Memasang antarmuka ChattyBox yang dikelola dari kode aplikasiSDK JavaScript
Membangun dan memelihara antarmuka sendiriSDK JavaScript headless
Membiarkan asisten coding AI mengintegrasikan paket npmIntegrasi berbantuan AI
Mengelola konfigurasi proyek dari Git dan CICLI dan deployment konfigurasi
Menggunakan antarmuka terkelola tanpa npm atau proses buildSkrip widget ter-host
Menambahkan widget terkelola ke WordPress tanpa mengedit temaPlugin WordPress
Menambahkan widget terkelola ke Drupal 10 atau 11 dengan ComposerModul Drupal

Integrasi browser memerlukan kunci API widget publik. Periksa pengaturan origin kunci: kunci yang disiapkan untuk suatu situs web mungkin sudah dibatasi ke origin tersebut, sedangkan kunci yang dibuat tanpa pembatasan berfungsi di berbagai origin. Di Pasang → Kunci & domain, gunakan Edit origin untuk mengelola pembatasan opsional dan menambahkan origin produksi, pratinjau, staging, serta localhost yang diperlukan. Origin yang dibatasi harus cocok persis berdasarkan skema, hostname, dan port (misalnya, https://example.com dan http://localhost:3000 adalah origin yang berbeda). Di Instalasi situs web, pilih kunci dan salin cuplikan serta URL API yang dibuat.

Kunci widget publik dirancang untuk muncul dalam kode browser. Token deployment konfigurasi dan kredensial pengelolaan lainnya bersifat privat dan tidak boleh ditambahkan ke situs web. Pembatasan origin adalah hardening opsional, bukan autentikasi pengunjung.

Untuk mengambil kembali kunci publik yang sudah ada, masukkan URL situs web HTTP(S) di Instalasi situs web dan pilih kunci dalam cuplikan. Pemilih hanya menawarkan kunci yang belum kedaluwarsa dan tidak dibatasi atau diizinkan untuk origin URL tersebut. Untuk memilih kunci yang dibatasi, masukkan origin yang diizinkan; gunakan Kelola kunci & domain yang diizinkan untuk memeriksa pembatasannya. Jika formulir instalasi tidak tersedia, selesaikan dahulu langkah penyiapan yang ditampilkan di dasbor. Untuk merotasi kunci, buat kunci baru, perbarui dan uji instalasi Anda, lalu hapus kunci lama. Penghapusan segera menghentikan instalasi yang masih menggunakannya. Satu kunci hanya dimiliki satu chatbot; menamainya "staging" atau "production" tidak menciptakan batas lingkungan.

7. Validasi Sebelum Peluncuran​

Pasang integrasi yang dipilih terlebih dahulu di situs pratinjau atau staging. Uji origin yang di-deploy, navigasi antar-rute, sitasi, perilaku fallback, tata letak seluler, dan konsol browser sebelum menerbitkan secara luas.

Selesaikan daftar periksa peluncuran, lalu gunakan Percakapan → Riwayat pada semua paket atau Percakapan → Analisis dan Pertanyaan yang belum terjawab pada Pro dan Business untuk meningkatkan dokumentasi setelah pertanyaan nyata masuk.

Peta Dasbor​

Buka proyek di /chatbot/<projectId>. Tab memakai parameter kueri tab, bukan subhalaman terpisah:

Tampilan workspaceNilai tabTindakan di sana
RingkasanoverviewTinjau progres penyiapan dan aktivitas terbaru
Pengetahuan → Impor & segarkansettingsTemukan, pilih, impor, dan segarkan halaman; sesuaikan pengaturan sumber
Pengetahuan → HalamancontentTinjau halaman dan tugas scraping, hapus konten, bangun ulang embedding
Uji chatbottestAjukan pertanyaan dan buka kembali percakapan tersimpan
Percakapan → RiwayatlogsBaca percakapan tersimpan dan hapus satu atau semua percakapan
Percakapan → AnalisisanalyticsTinjau interaksi tercatat selama 30 hari terakhir, maksimal 5.000 catatan; Pro/Business
Percakapan → Pertanyaan yang belum terjawabgapsTinjau dan selesaikan pertanyaan tak terjawab yang terdeteksi; Pro/Business
Sesuaikan → PerilakupromptsPilih atau edit instruksi asisten
Sesuaikan → TampilanappearancePratinjau dan sesuaikan tampilan serta bahasa widget ter-host
Pasang → Kunci & domainkeysBuat/hapus kunci widget publik dan edit pembatasan origin opsional
Pasang → Instalasi situs webembedSiapkan instalasi dan salin cuplikan kunci
Pengaturan chatbotmanageKelola detail chatbot, token deployment, dan config lock, atau hapus chatbot

Semua chatbot kembali ke /dashboard. Ikhtisar akun berada di /dashboard/overview; Akun & Tagihan berada di /settings/account dan memuat profil, paket, penggunaan pesan, portal penagihan, serta kontrol PAYG. /settings dan /settings/billing dialihkan ke sana. /settings/keys menyediakan pemilih proyek untuk membuat/menghapus kunci publik; pembatasan origin opsional diedit di tampilan Kunci & domain chatbot.

Izin dan Config Lock​

Akses proyek dasbor hanya untuk pemilik (atau pengguna yang memiliki workspace lama). Kunci widget publik tidak memberi akses ke pengaturan proyek atau riwayat percakapan tersimpan; keanggotaan organisasi saja tidak memberikan izin proyek tersebut.

Untuk pengelolaan Git/CI, Pengaturan chatbot menyediakan token deployment konfigurasi dengan cakupan development, preview, dan/atau production, masa berlaku opsional, serta pencabutan. Berbeda dari kunci widget publik, nilai lengkap token deployment hanya ditampilkan saat dibuat. Bagian ini juga menampilkan riwayat deployment.

Pengaturan Aktifkan penguncian konfigurasi bersifat permanen dan tidak dapat dibatalkan. Pengaturan ini memblokir penulisan konfigurasi dari dasbor dan operasi konten manual, termasuk menyimpan Persona dan menjalankan Scrape Sekarang, meskipun kontrolnya masih terlihat. Setelah itu, deploy konfigurasi melalui alur CLI. Pengelolaan kunci publik, pembersihan percakapan, dan preferensi branding yang diizinkan paket tetap terpisah dari bidang konfigurasi yang dikunci. Cakupan lingkungan token tidak membuat chatbot atau lingkungan kunci browser terpisah.

Konfigurasi sebagai kode juga menyediakan widget.enabled. Mengaturnya ke false menonaktifkan chat publik, termasuk SDK headless, bukan hanya widget mengambang. Tidak ada sakelar aktif/nonaktif yang sesuai di formulir tampilan saat ini.

Paket dan Anggaran​

PaketChatbotHalaman akunPesan per bulan
Free110100
Starter31501.000
Pro105.00010.000
Business2525.00050.000

Kuota pesan dan halaman tersimpan yang termasuk dalam paket adalah kuota tingkat pemilik yang dibagikan seluruh chatbot pemilik, termasuk Uji chatbot. Pekerjaan penyegaran halaman bulanan dan cooldown penyegaran adalah batas yang berbeda; tinjau anggaran refresh sebelum impor atau rebuild besar. Lihat harga untuk kuota paket bersama yang terdokumentasi dan Akun & Tagihan untuk penggunaan serta kuota akun yang tersedia saat ini.

PAYG untuk pesan, halaman, dan situs bersifat opsional pada Pro/Business dan nonaktif secara default. Di Akun & Tagihan, tetapkan anggaran overage bulanan per fitur atau pilih Tanpa batas belanja secara eksplisit. Anggaran nol membuat fitur tersebut tetap dibatasi keras; Tanpa batas belanja mengizinkan biaya penggunaan tanpa batas. PAYG tidak membuka fitur di Free/Starter dan tidak melewati cooldown penyegaran crawler. Nama profil dapat diedit di sana; email dikelola melalui pengaturan akun penyedia login Anda.