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.

Sebelum Menginstal

Selesaikan alur Memulai terlebih dahulu: hubungkan URL WordPress publik Anda, tinjau halaman yang diindeks, dan verifikasi jawaban yang representatif di Test Chat. Kemudian buat kunci publik yang aman untuk browser di Public Keys dan salin dari tab Embed proyek.

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.

Unduh ZIP plugin WordPress ChattyBox 0.2.0 dengan versi tetap, atau lihat repositori sumber publik.
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.
Buka Settings > ChattyBox.
Tempel kunci API widget publik dari tab Embed proyek.
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 mode otomatis, <html lang> halaman diprioritaskan dibanding bahasa browser. 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.

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

Plugin memuat widget pada permintaan frontend publik. Plugin sengaja melewati wp-admin, feed, permintaan REST, dan permintaan AJAX, sehingga respons administratif dan respons non-halaman tidak menerima skrip.

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. Plugin tidak melakukan crawl atau sinkronisasi postingan; pengindeksan dan refresh konten terjadi di ChattyBox.

Kunci publik bekerja lintas origin browser secara default. Pembatasan opsional di Public Keys > Edit origins memerlukan skema, hostname, dan port setiap origin yang dituju; origin yang diblokir atau tidak ada menghasilkan 401 Invalid API key.

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. Menghapus skrip maupun menyembunyikan widget dengan CSS bukan teardown UI lengkap atau pencabutan persetujuan.

Lanjutkan ke daftar periksa peluncuran sebelum mengumumkan chatbot. Gunakan Analytics dan Content Gaps untuk meningkatkan konten WordPress setelah pertanyaan nyata mulai masuk.

Sebelum Menginstal​

Instal Plugin​

Konfigurasikan Pemuatan​

Kecualikan Rute Tambahan​

Fallback Skrip Manual​

Verifikasi Instalasi​

Pilihan privasi