Memulai

Pada rilis mendatang, halaman yang termasuk dibagikan di antara proyek milik pemilik yang sama; hingga peluncuran, dasbor publik mungkin masih menampilkan batas lama per chatbot.

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 New Chatbot, lalu beri nama proyek dan Website URL opsional. Setelah membuatnya, buka chatbot dari daftar proyek. Tab defaultnya adalah Content, tempat halaman tersimpan dan tugas scraping akan muncul; pembuatan proyek saja tidak memulai scraping.

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

2. Konfigurasikan Sumber Konten

Buka tab Settings. Di General Settings, tambahkan Website URL publik dan pilih Save Changes. Di Scraping Configuration, pilih mode penemuan, jumlah halaman maksimum, serta jadwal refresh opsional dan pilih Save Config. Ini dua formulir terpisah. Aturan include/exclude dan kedalaman crawl tersedia melalui konfigurasi sebagai kode, bukan kontrol dasbor.

Jalankan Scrape Now. ChattyBox menemukan halaman terpilih, mengekstrak HTML yang mudah dibaca, dan mengantrikan konten yang berubah untuk pengindeksan. Crawler tidak merender JavaScript atau menerapkan robots.txt; gunakan halaman publik yang Anda berwenang untuk indeks dan pilih cakupan peluncuran dengan sengaja.

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

3. Tinjau Konten yang Diindeks

Kembali ke Content 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 selesai tidak menjamin setiap halaman atau setiap bagian terindeks.

4. Uji Kualitas Jawaban

Buka Test Chat 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 scrape lagi jika jawaban lemah, ketika cooldown paket mengizinkan. Refresh Free maksimal mingguan; paket berbayar maksimal harian. Test Chat memakai kuota pesan dan masuk ke conversation logs, analytics, serta content gaps yang sama dengan chat publik. Jangan memasang chatbot hanya karena scraping pertama selesai.

5. Sesuaikan Pengalaman

Gunakan Persona untuk memilih Helpful Assistant, Sales Representative, Technical Support, Sarcastic Bot, atau Custom Persona, edit instruksi, lalu pilih Save Changes. Mengedit preset mengubahnya menjadi Custom. Instruksi ini melengkapi aturan grounding dan format bawaan; jangan tempel basis pengetahuan ke prompt.

Teks Persona tidak menggantikan fallback enforced 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 menyimpan.

Jika memakai widget ter-host, gunakan Embed untuk melihat pratinjau serta menyimpan judul, pesan sambutan, warna, ikon, posisi, dan perilaku bahasa. Mode Fixed dan override skrip hanya memengaruhi bahasa UI widget, bukan bahasa halaman yang diindeks.

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

6. Pilih Integrasi

Tujuan	Langkah berikutnya
Memasang antarmuka ChattyBox yang dikelola dari kode aplikasi	SDK JavaScript
Membangun dan memelihara antarmuka sendiri	SDK JavaScript headless
Membiarkan asisten coding AI mengintegrasikan paket npm	Integrasi berbantuan AI
Mengelola konfigurasi proyek dari Git dan CI	CLI dan deployment konfigurasi
Menggunakan antarmuka terkelola tanpa npm atau proses build	Skrip widget ter-host
Menambahkan widget terkelola ke WordPress tanpa mengedit tema	Plugin WordPress
Menambahkan widget terkelola ke Drupal 10 atau 11 dengan Composer	Modul Drupal

Integrasi browser memerlukan kunci API widget publik. Kunci publik secara default berfungsi dari produksi, pratinjau, staging, dan localhost. Untuk hardening defense-in-depth opsional, buka Public Keys > Edit origins, aktifkan Restrict this key to specific origins, dan tambahkan setiap origin browser yang diizinkan. Origin yang dibatasi harus cocok persis berdasarkan skema, hostname, dan port (misalnya, https://example.com dan http://localhost:3000 adalah origin yang berbeda). Kembali ke Embed untuk memilih kunci tersebut dan menyalin 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.

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 Logs pada semua paket atau Analytics dan Content Gaps pada Pro dan Business untuk meningkatkan dokumentasi setelah pertanyaan nyata masuk.

Peta Dasbor

Buka proyek di /chatbot/<projectId>. Tab memakai parameter query tab, bukan subhalaman terpisah: Content (content), Test Chat (test), Logs (logs), Analytics (analytics), Content Gaps (gaps), Persona (prompts), Public Keys (keys), Embed (embed), dan Settings (settings). Analytics menampilkan 30 hari interaksi tercatat terakhir, dibatasi 5.000 catatan, dan Content Gaps/Analytics memerlukan Pro atau Business.

Izin dan Config Lock

Akses proyek dasbor hanya untuk pemilik. Kunci widget publik tidak memberi akses ke pengaturan proyek atau riwayat percakapan. Config-as-code lock tidak dapat dibuka melalui dasbor, CLI, atau API publik; lock memblokir perubahan konfigurasi dasbor dan operasi konten manual. Kelola konfigurasi melalui alur CLI. Kunci publik, pembersihan percakapan, dan preferensi branding yang diizinkan paket tetap terpisah dari bidang konfigurasi yang dikunci.

Paket dan Anggaran

Paket	Chatbot	Halaman	Pesan per bulan
Free	1	10	100
Starter	3	150	1.000
Pro	10	5.000	10.000
Business	25	25.000	50.000

Kuota pesan adalah kuota tingkat pemilik yang dibagikan seluruh chatbot pemilik, termasuk Test Chat. Batas halaman tersimpan, pekerjaan refresh halaman bulanan, dan cooldown refresh adalah batas yang berbeda; tinjau anggaran refresh sebelum impor atau rebuild besar.