Gitaz AI Assistant
Plugin WordPress untuk Asisten Customer Service AI berbasis RAG (Retrieval-Augmented Generation) yang terintegrasi dengan WooCommerce, Elementor, dan WordPress.
Gitaz AI menggunakan Google Gemini untuk memberikan respons kontekstual, menyimpan lead, dan mendeteksi bahasa pengunjung secara otomatis.
Deskripsi
Gitaz AI Assistant adalah plugin chat AI yang dirancang untuk meningkatkan pengalaman pelanggan di situs WordPress dan WooCommerce.
Dengan knowledge base internal, deteksi bahasa otomatis berbasis IP Cloudflare, serta dukungan widget floating dan inline, plugin ini membantu memberikan jawaban yang relevan, cepat, dan profesional.
Fitur Utama
🤖 AI-Powered Chat
– Integrasi Google Gemini (Generative Language API) untuk respons AI
– Logika RAG sederhana dengan halaman aktif, artikel KB terkait, dan aturan website
– Sistem pencegahan halusinasi yang memaksa AI hanya menggunakan konteks data
– Validasi API Key Gemini langsung dari dashboard admin
🌐 Multi-Language Support
– Auto-detection bahasa berdasarkan header Cloudflare `HTTP_CF_IPCOUNTRY`
– Dukungan utama bahasa Indonesia dan Inggris
– Greeting dinamis dan teks UI disesuaikan menurut bahasa deteksi
🛒 WooCommerce dan Produk
– REST API endpoint `gitaz-ai/v1/products` untuk mengambil data produk WooCommerce
– Integrasi WooCommerce bersifat opsional dan bekerja jika WooCommerce terpasang
– Produk dapat digunakan untuk konteks percakapan atau quick button melalui API
📚 Knowledge Base Management
– Custom Post Type `AI Knowledge Base` untuk artikel referensi AI
– Taxonomy `KB Categories` untuk pengelompokan dokumen
– Meta box `Linked Data Sources` untuk relasi dokumen kontekstual
🎨 Personalisasi UI
– Floating chat widget responsif dengan tombol obrolan yang mudah digunakan
– Shortcode inline `gitaz_inline` untuk menempatkan chat widget dalam konten
– Elementor widget `Gitaz AI Chat` untuk penempatan drag-and-drop
– Kustom greeting, ikon chat, dan tampilan widget melalui panel admin
🧠 Lead Capture & Reporting
– Penyimpanan lead ke tabel database `wp_gitaz_ai_leads`
– Skor lead otomatis menggunakan analisis AI Gemini
– Ringkasan dan topik lead disimpan untuk evaluasi lebih lanjut
– Export data lead ke CSV via menu admin
– Webhook integrasi untuk mengirim lead ke layanan eksternal
🔧 Admin Command Center
– License activation & updater built-in
– Pengaturan bot persona dan system prompt
– Auto open delay dan exit-intent message untuk engagement yang lebih baik
– WhatsApp handoff support jika nomor WA dikonfigurasi
Persyaratan Sistem
– WordPress 6.0 atau lebih baru
– PHP 7.4 atau lebih baru
– WooCommerce (opsional, untuk fitur produk)
– Cloudflare (direkomendasikan untuk deteksi bahasa otomatis)
– API Key Google Gemini / Generative Language API
Instalasi
1. Download Plugin
– Download file plugin dari [situs resmi](https://yukdigitalz.com/gitaz-ai-assistant)
2. Upload ke WordPress
– Masuk ke admin WordPress Anda
– Pergi ke Plugins > Add New
– Klik Upload Plugin
– Pilih file ZIP plugin dan klik Install Now
3. Aktivasi Plugin
– Setelah instalasi selesai, klik Activate
4. Konfigurasi Awal
– Pergi ke menu Gitaz AI di sidebar admin
– Masukkan API Key Google Gemini Anda
– Atur license key jika diperlukan untuk updater
– Sesuaikan greeting, bot name, dan pengaturan chat lainnya
Penggunaan
Setup API Key
1. Dapatkan API Key Google Gemini / Generative Language API dari Google Cloud.
2. Masukkan API Key di tab License & API.
3. Klik tombol validasi untuk memeriksa koneksi.
Knowledge Base
1. Buka Gitaz AI > AI Knowledge Base
2. Tambah artikel baru sebagai sumber referensi AI
3. Atur kategori menggunakan KB Categories
4. Gunakan meta box Linked Data Sources untuk menyambungkan konten terkait
Pengaturan Chat Widget
– Atur nama bot, greeting, dan system prompt
– Sesuaikan warna, ikon, dan tampilan chat
– Atur auto open delay dan exit-intent message
– Tambahkan nomor WhatsApp untuk handoff percakapan otomatis
Shortcode Inline
Gunakan shortcode berikut untuk menyisipkan widget chat inline:
“`shortcode
“`
Atribut tambahan juga didukung:
“`shortcode
“`
Elementor Widget
1. Edit halaman dengan Elementor
2. Cari widget Gitaz AI Chat
3. Drag & drop widget ke area yang diinginkan
4. Sesuaikan greeting dan tinggi widget di panel Elementor
Pengaturan Lisensi
Plugin ini mendukung license activation dan updater internal.
1. Beli license dari [YukDigitalz Store](https://yukdigitalz.com)
2. Masukkan license key di halaman pengaturan
3. Aktifkan license untuk mengizinkan pembaruan plugin
API Endpoints
Plugin ini menyediakan REST API endpoints untuk integrasi eksternal:
– `POST /wp-json/gitaz-ai/v1/chat` – Mengirim pesan chat
– `GET /wp-json/gitaz-ai/v1/products` – Mengambil data produk WooCommerce
– `POST /wp-json/gitaz-ai/v1/save-lead` – Menyimpan data lead
Troubleshooting
Chat Tidak Muncul
– Pastikan API Key Gemini sudah terpasang dan tervalidasi
– Periksa console browser untuk error JavaScript
– Pastikan tidak ada konflik dengan plugin lain
Language Detection Tidak Bekerja
– Pastikan situs menggunakan Cloudflare dan header `HTTP_CF_IPCOUNTRY` tersedia
– Jika tidak menggunakan Cloudflare, bahasa default akan tetap ke Indonesia
Knowledge Base Tidak Muncul di Chat
– Pastikan artikel `AI Knowledge Base` sudah dipublikasikan
– Periksa kategori dan relasi dokumen
Lisensi
Plugin ini dilisensikan di bawah [GPL v2 atau lebih baru](https://www.gnu.org/licenses/gpl-2.0.html).
Dukungan
Untuk dukungan teknis:
– Email: support@yukdigitalz.com
– Website: [https://yukdigitalz.com](https://yukdigitalz.com)
– Dokumentasi: [https://yukdigitalz.com/dokumentasi-gitaz-ai-assistant](https://yukdigitalz.com/dokumentasi-gitaz-ai-assistant)