Panduan GBotGBot guide

MulaiGet started

1. Buat akun dengan nama toko, email, dan nomor kontak toko.Create an account with your shop name, email, and shop contact number.
2. Di Pengaturan → Informasi toko, isi alamat, jam buka, pengiriman, dan cara bayar (opsional, tapi paling sering ditanyakan).In Settings → Store info, fill in address, opening hours, shipping, and payment (optional, but the most asked).
3. Di dasbor, isi menu Produk dan FAQ. Bot hanya tahu apa yang Anda tulis di sana dan di Informasi toko.In the dashboard, fill in Products and FAQ. The bot only knows what you write there and in Store info.
4. Buka Pengaturan → Pasang widget, salin kodenya, dan tempel di website Anda.Open Settings → Install widget, copy the code, and paste it into your website.
5. Buka website Anda dan tanyakan harga salah satu produk untuk memastikan bot membaca data yang benar.Open your website and ask for the price of one product to confirm the bot reads the right data.

Pasang widgetInstall the widget

Tempel dua baris ini tepat sebelum tag </body>. Ganti API_KEY_ANDA dengan key dari halaman Pengaturan.Paste these two lines right before the </body> tag. Replace YOUR_API_KEY with the key from the Settings page.

Tombol chat muncul di pojok kanan bawah. Kode ini bisa dipakai di HTML biasa, WordPress (lewat plugin header/footer), Webflow, Wix, Shopify, atau builder lain yang mengizinkan custom code.A chat button appears in the bottom-right corner. It works on plain HTML, WordPress (via a header/footer plugin), Webflow, Wix, Shopify, or any builder that allows custom code.

Widget tidak muncul atau tidak menjawabWidget does not show or does not answer

• Buka console browser. Pesan [GBot] apiKey is required berarti apiKey belum diisi.Open the browser console. [GBot] apiKey is required means apiKey is missing.
• Pastikan key disalin utuh, tanpa spasi di awal atau akhir.Make sure the key is copied in full, with no leading or trailing spaces.
• Pastikan baris GBot.init ada setelah baris gbot.js.Make sure the GBot.init line comes after the gbot.js line.
• Kalau akun sedang ditangguhkan admin platform, widget tidak akan menjawab.If the account is suspended by the platform admin, the widget will not answer.

Menulis data yang mudah dijawab botWriting data the bot can answer from

Setiap pesan pengunjung dipecah jadi kata kunci. Bot mencari kata itu di nama, kategori, dan deskripsi produk, serta di pertanyaan dan keywords FAQ. Data yang paling cocok dikirim ke model AI untuk disusun jadi jawaban. Daftar nama dan harga semua produk selalu ikut dikirim.Each visitor message is split into keywords. The bot looks for them in product names, categories, and descriptions, and in FAQ questions and keywords. The best matches are sent to the AI model to write the answer. A list of every product name and price is always included.

Artinya: kata yang tidak pernah Anda tulis sulit ditemukan bot.In short: words you never wrote are hard for the bot to find.

ProdukProducts

• Pakai nama yang biasa diketik pelanggan. "Nastar Keju" lebih mudah ditemukan daripada "NK-500".Use names customers actually type. "Nastar Keju" is easier to find than "NK-500".
• Tulis ukuran, isi, rasa, dan daya tahan di deskripsi.Put size, contents, flavour, and shelf life in the description.
• Satu varian satu produk kalau harganya berbeda.One variant per product when prices differ.

FAQ

• Satu FAQ untuk satu topik: halal, pengiriman, cara bayar, jam buka, alamat, cara pesan.One FAQ per topic: halal status, shipping, payment, opening hours, address, how to order.
• Isi keywords dengan sinonim dan singkatan yang dipakai pelanggan, dipisah koma. Contoh: kirim, ongkir, ekspedisi, luar kota.Fill keywords with synonyms and short forms customers use, comma separated. Example: shipping, delivery, courier, out of town.
• Tulis jawaban lengkap dan pasti. Bot tidak menambah angka yang tidak Anda tulis.Write complete, specific answers. The bot does not add numbers you did not write.

Log pertanyaan & saran FAQQuestion log & FAQ drafts

Log Pertanyaan mencatat setiap pertanyaan dan jawaban bot. Kolom Cocok FAQ = Tidak berarti tidak ada produk atau FAQ yang cocok dengan pertanyaan itu.Question Log records every question and bot answer. Matched = No means no product or FAQ matched that question.

Setiap malam, pertanyaan yang tidak cocok dirangkum jadi draf di menu Saran FAQ. Draf tidak dipakai bot sampai Anda setujui. Anda bisa mengedit draf sebelum menyetujui.Each night, unmatched questions are summarised into drafts under FAQ Drafts. The bot does not use a draft until you approve it. You can edit a draft before approving.

BatasanLimitations

• Jawaban disusun model AI (Gemini) dan tetap bisa keliru. Periksa log secara berkala.Answers are written by an AI model (Gemini) and can still be wrong. Check the log regularly.
• Bot tidak memproses pesanan, pembayaran, atau stok. Untuk itu pengunjung diarahkan menghubungi toko.The bot does not handle orders, payments, or stock. For those, visitors are pointed to contact the shop.
• Bot mengingat beberapa pesan terakhir dalam satu tab browser, termasuk saat pengunjung pindah halaman di website Anda. Percakapan hilang kalau tab ditutup.The bot remembers the last few messages within one browser tab, including when the visitor moves to another page of your site. The conversation is cleared when the tab is closed.
• Kalau layanan AI sedang tidak tersedia, bot menjawab langsung dari data yang cocok (misalnya nama dan harga produk), dengan kalimat yang lebih sederhana.When the AI service is unavailable, the bot answers straight from matching data (such as product names and prices) in simpler sentences.
• Data setiap toko dipisah per API key. Bot toko Anda tidak membaca data toko lain.Each shop's data is separated by API key. Your bot does not read other shops' data.

API

Untuk developer yang ingin memakai engine tanpa widget. Kirim API key lewat header X-API-Key. Jangan taruh key di aplikasi yang bisa dibongkar orang lain kecuali Anda siap key itu dipakai pihak lain.For developers who want to use the engine without the widget. Send the API key in the X-API-Key header. Do not ship the key inside an app others can inspect unless you accept it being reused.

POST /chat

history opsional: pesan sebelumnya (paling lama di atas), peran user atau bot. Engine hanya memakai 6 pesan terakhir dan memotong tiap pesan maksimal 500 karakter.history is optional: earlier messages (oldest first), role user or bot. The engine uses only the last 6 messages and cuts each to 500 characters.

Respons sukses:Successful response:

wa_link berisi tautan kontak toko kalau bot menyarankan pengunjung menghubungi toko, selain itu kosong.wa_link holds the shop contact link when the bot suggests contacting the shop, otherwise it is empty.

Error selalu berbentuk {"error": "pesan"}.Errors always look like {"error": "message"}.

GET /info

Mengembalikan nama toko untuk API key tersebut, dipakai widget untuk judul jendela chat.Returns the shop name for that API key; the widget uses it as the chat window title.