Lewati ke konten utama

Plugin Chatbot WordPress

Gunakan plugin WordPress resmi ChattyBox jika Anda menginginkan instalasi tanpa kode yang memuat widget ter-host tanpa mengedit file tema. Panduan ini mencakup penyiapan operasional. Halaman chatbot AI WordPress menjelaskan strategi konten dan crawling, sedangkan halaman landing plugin WordPress memberikan gambaran singkat tentang produk.

Bisakah saya menggunakan ChattyBox di WordPress tanpa branding?​

Bisa. Plugin resmi memuat widget ChattyBox ter-host di situs WordPress Anda. Free tetap menampilkan footer “Powered by ChattyBox”. Starter, Pro, dan Business dapat menghapusnya di Sesuaikan → Branding ChattyBox dengan menonaktifkan Tampilkan branding ChattyBox. Lihat penyesuaian widget untuk pengaturan tersebut dan harga untuk paketnya.

Sebelum Menginstal​

Selesaikan alur Memulai terlebih dahulu: hubungkan URL WordPress publik Anda, tinjau halaman yang diindeks, dan verifikasi jawaban yang representatif di Uji chatbot. Periksa pengaturan origin kunci widget publik dan buat kunci bila perlu di Pasang → Kunci & domain. Di Pasang → Instalasi situs web, pilih kunci yang sesuai dan salin dari cuplikan instalasi.

Instal Plugin​

Plugin tidak memiliki dependensi Composer, npm, atau langkah build. Saat ini plugin didistribusikan dari repositori GitHub publik ChattyBox, bukan Direktori Plugin WordPress.org, jadi gunakan alur Upload Plugin WordPress, bukan pencarian direktori. Pembaruan otomatis yang dikelola direktori belum tersedia.

Paket 0.2.0 yang dipin menyatakan WordPress 5.8+ dan PHP 7.4+, dengan metadata pengujian hingga WordPress 6.8. Uji versi WordPress/PHP dan tema Anda; metadata ini bukan jaminan bagi setiap rilis yang lebih baru.

  1. Unduh ZIP plugin WordPress ChattyBox 0.2.0 dengan versi tetap, atau lihat repositori sumber publik.
  2. Di WordPress, buka Plugins > Add New > Upload Plugin, unggah ZIP, dan aktifkan ChattyBox AI Chatbot. Untuk instalasi server manual, salin direktori plugin ke wp-content/plugins/ terlebih dahulu.
  3. Buka Settings > ChattyBox.
  4. Tempel kunci API widget publik dari cuplikan instalasi.
  5. Aktifkan chatbot dan simpan pengaturan.

Plugin menyimpan kunci publik widget dan pengaturan tampilan di opsi WordPress. Jangan pernah menempelkan kredensial manajemen ChattyBox ke plugin.

Konfigurasikan Pemuatan​

Default produksi adalah:

  • Skrip widget: https://chattybox.ai/widget.js
  • Endpoint API: dikonfigurasi secara otomatis oleh plugin
  • Diaktifkan: nonaktif sampai Anda mengaktifkan chatbot dengan kunci publik yang tidak kosong
  • Override locale: kosong; widget ter-host mengikuti kebijakan locale proyek (mode otomatis secara default)

Dalam kode sumber widget ter-host saat ini, mode otomatis mencoba <html lang> halaman yang didukung terlebih dahulu, lalu bahasa browser yang didukung, default yang dikonfigurasi, dan bahasa Inggris. Mode Fixed memakai locale default proyek. Override bahasa opsional plugin menjadi data-locale dan hanya menang bila proyek mengizinkan override skrip. Gunakan kode locale huruf kecil yang didukung; teks header/welcome kustom tidak diterjemahkan otomatis. Periksa versi loader yang di-deploy secara terpisah sebelum mengandalkan perilaku ini.

Endpoint API tertanam di versi plugin ini, bukan ditemukan dari kunci. Mengubah Widget script URL tidak mengubah endpoint itu. Jika cuplikan Instalasi situs web menargetkan deployment API lain, gunakan integrasi skrip manual. URL loader remote harus HTTPS (HTTP hanya untuk host pengembangan lokal).

Plugin mendaftarkan widget pada permintaan enqueue frontend WordPress dan secara eksplisit melewati feed, permintaan REST, dan permintaan AJAX. Guard ini tidak memeriksa setiap jenis respons atau memastikan bahwa setiap halaman frontend bersifat publik.

Guard request ini tidak memeriksa privasi atau status keanggotaan setiap halaman frontend. Halaman checkout, akun, yang dilindungi sandi, dan keanggotaan memerlukan pengecualian eksplisit bila sesuai. Pastikan juga tema Anda memanggil hook footer WordPress agar skrip dapat dimuat. Plugin tidak melakukan crawl atau sinkronisasi postingan; pengindeksan dan refresh konten terjadi di ChattyBox.

Kunci yang dibuat tanpa pembatasan berfungsi dari semua origin browser; kunci yang disiapkan untuk suatu situs mungkin sudah dibatasi ke origin situs tersebut. Pembatasan opsional di Pasang → Kunci & domain memerlukan skema, hostname, dan port untuk setiap origin yang dituju. Untuk kunci yang dibatasi, origin efektif permintaan yang tidak ada atau tidak diizinkan menghasilkan 401 Invalid API key; jika header Origin tidak ada, server dapat memperoleh origin dari Referer yang valid. Pembatasan origin adalah perlindungan tambahan, bukan autentikasi pengunjung, dan kunci browser publik bukan rahasia. Uji halaman produksi yang sebenarnya, bukan hanya dasbor.

Kecualikan Rute Tambahan​

Gunakan filter chattybox_load_widget dari plugin khusus situs atau tema anak ketika rute publik tidak boleh menampilkan widget:

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Pertahankan perilaku default plugin tetap aktif terlebih dahulu, lalu tambahkan hanya pengecualian rute yang diperlukan situs Anda. Setelah mengubah filter, uji rute yang dikecualikan dan halaman publik biasa.

Fallback Skrip Manual​

Gunakan plugin sebagai jalur default. Jika tim WordPress Anda sudah mengelola skrip melalui tema, tema anak, plugin skrip, atau Google Tag Manager, Anda dapat memuat widget ter-host secara manual:

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

Jangan mengaktifkan plugin dan menambahkan cuplikan widget yang sama secara bersamaan. Pilih satu loader agar pengunjung tidak menerima launcher duplikat.

Verifikasi Instalasi​

Setelah mengonfigurasi plugin:

  • Buka halaman WordPress publik di jendela incognito.
  • Pastikan launcher muncul satu kali.
  • Ajukan pertanyaan pengunjung yang nyata.
  • Verifikasi bahwa jawaban yang didukung menyitasi halaman WordPress publik yang diindeks dan pertanyaan yang tidak didukung menampilkan fallback, yang dapat tidak memiliki sumber.
  • Periksa konsol browser untuk data-api-key, data-api-url yang hilang, atau kesalahan kunci.
  • Uji rute checkout, account, atau privat jika Anda mengonfigurasi pengecualian.
  • Bersihkan cache halaman WordPress/CDN yang relevan setelah mengubah pengaturan atau pengecualian, lalu uji pemuatan halaman baru. Pengecualian sisi server tidak menghapus widget yang sudah diinisialisasi saat navigasi sisi klien. Pada rute sensitif atau saat persetujuan dicabut, lakukan teardown aktif melalui integrasi yang didukung loader yang terpasang. Menghapus skrip atau menyembunyikan widget dengan CSS saja bukan teardown lengkap. Teardown tidak dapat membatalkan permintaan yang sudah diproses server.
  • Loader otomatis plugin tidak memeriksa persetujuan pengunjung sebelum memasukkan widget ke antrean pemuatan. Jika persetujuan diperlukan, gunakan integrasi yang mencegah pemuatan sampai persetujuan diberikan, dan verifikasi perilaku saat persetujuan dicabut dengan loader yang di-deploy.

Lanjutkan ke daftar periksa peluncuran sebelum mengumumkan chatbot. Gunakan Percakapan → Riwayat, yang tersedia di semua paket, untuk meninjau percakapan. Pada paket Pro atau Business, gunakan Percakapan → Analisis dan Percakapan → Pertanyaan yang belum terjawab untuk meninjau area yang perlu ditingkatkan setelah pertanyaan nyata mulai masuk.