📘 Dokumentasi Widget Chatbot

Asisten Analisis adalah chatbot berbasis AI dan database, dirancang untuk membantu pengguna mencari prediksi togel, data keluaran, arti mimpi, dan lainnya.

Widget ini dapat disematkan ke website kamu dengan kustomisasi tampilan dan fitur yang fleksibel.

🔗 Cara Menyematkan Widget

<script src="https://chat.wysiwygscan.com/widget.php?token=TOKENANDA"></script>

⚙️ Parameter yang Didukung

Parameter	Deskripsi	Contoh
`token`	Token client (wajib)	`abc123xyz789`
`theme`	`dark` untuk tema gelap, `custom` jika pakai CSS sendiri	`dark`
`css`	URL file CSS eksternal (digunakan jika `theme=custom`)	`https://domainmu.com/chat-style.css`
`position`	Posisi tombol: `bottom-right` atau `bottom-left`	`bottom-left`
`promo`	URL gambar promosi di atas tombol (opsional, bisa dikosongkan)	`https://domainmu.com/banner.png`
`width`	Lebar tampilan chat dalam piksel (opsional)	`400`
`height`	Tinggi tampilan chat dalam piksel (opsional)	`700`
`responsive`	Jika diisi `true`, widget akan menyesuaikan ukuran layar	`true`

📨 Contoh Lengkap

<script src="https://chat.wysiwygscan.com/widget.php?token=123456&theme=custom&css=https://domainmu.com/chat-style.css&position=bottom-right&width=400&height=700&responsive=true&promo=https://domainmu.com/promo.png"></script>

🎨 Tema & Kustomisasi

✅ Default Theme

Jika parameter theme tidak diatur, maka akan digunakan tema terang default dengan warna biru dan tombol 💬 di kanan bawah.

🌙 Dark Theme

Gunakan theme=dark untuk tema gelap.

🛠 Custom Theme

Gunakan theme=custom dan css=URL untuk memakai tampilan sendiri.

Contoh CSS custom:

/* https://domainmu.com/chat-style.css */
.chatbox-container {
  background: #1e1e1e;
  color: #fff;
}
.chatbox-container .header {
  background: #ff9800;
  font-weight: bold;
}
.chatbox-container button {
  background: #4caf50;
  color: white;
}

⚠️ Pastikan file CSS kamu dapat diakses publik dan tidak diblokir oleh CORS atau redirect.

🖼️ Gambar Promo

Jika ingin menampilkan banner promosi di atas tombol, gunakan parameter promo.
Jika ingin menyembunyikan gambar promo, kosongkan parameternya: &promo=

🔒 Validasi & Keamanan

Setiap token bersifat unik dan wajib diisi untuk mengidentifikasi client.
Hanya domain yang terverifikasi melalui HTTP_REFERER yang dapat menggunakan widget.
Komunikasi antara widget dan server menggunakan protokol HTTPS yang aman untuk menjaga kerahasiaan data.
Token dan data pengguna tidak disimpan secara permanen tanpa izin eksplisit dari client.

📦 Tips Hosting File CSS

Letakkan file CSS di folder public (misal: /public/chat-style.css)
Hindari redirect dan pastikan HTTPS aktif

❓ FAQ

Apa yang terjadi jika token salah?
Widget tidak akan dimuat, dan koneksi ditolak oleh server.
Bisakah saya menonaktifkan gambar promo?
Ya, cukup kosongkan parameternya: &promo=
Apakah saya bisa menyesuaikan ukuran chatbox?
Ya, gunakan parameter width dan height.

🛠 Troubleshooting

Widget tidak muncul: Periksa token valid dan domain sudah didaftarkan.
Gagal koneksi ke server: Cek jaringan internet dan pastikan server chatbot online.
CSS tidak berlaku: Pastikan URL css bisa diakses publik dan tanpa redirect.

🎬 Preview Langsung

Widget ini sudah aktif di halaman ini. Silakan klik tombol 💬 di pojok kanan bawah untuk mencoba interaksi langsung dengan chatbot.

Jika tidak muncul, pastikan koneksi internet stabil atau coba muat ulang halaman.

📝 Riwayat Perubahan (Change Log)

Versi	Tanggal	Perubahan
v1.0	22 Juni 2025	Rilis awal widget chatbot Dukungan tema: `default`, `dark`, `custom` Parameter yang didukung: `token`, `theme`, `css`, `promo`, `position`, `width`, `height`, `responsive` Validasi domain berbasis `HTTP_REFERER` Dukungan custom styling via CSS eksternal
v1.1	--	📥 Tambahan fitur input multi-baris dengan `Shift` + `Enter` 📦 Peningkatan respons auto-scroll saat kirim pesan 💬 Dukungan shortcut tombol cepat untuk pertanyaan populer
v1.2	--	🔐 Penyesuaian sistem keamanan token unik per client 🌐 Penyempurnaan validasi domain & pengelolaan client multi-widget

🗓️ Terakhir diperbarui: 22 Juni 2025