Konfigurasi
Opsi snippet widget Webchat, pengaturan tampilan dari dashboard, dan perilaku widget di website.
Snippet widget hanya punya sedikit opsi. Hampir semua pengaturan, termasuk tampilan, diatur di dashboard dan berlaku otomatis di widget yang sudah terpasang.
Opsi snippet
Opsi diisi di objek window.cskuSettings, sebelum widget.js dimuat.
<script>window.cskuSettings = {"channelKey": "<ID_CHANNEL>", "position": "right", "zIndex": 2147483000};</script>
<script src="https://app.csku.ai/widget/widget.js" async></script>
| Opsi | Tipe | Keterangan |
|---|---|---|
channelKey | string | Wajib. ID channel dari dashboard. 8–64 karakter: huruf, angka, _, -. |
position | string | right (bawaan) atau left. Posisi yang tersimpan di dashboard menimpa nilai ini. |
zIndex | integer | Tumpukan tombol terhadap elemen lain. Bawaan 2147483000. Jendela chat memakai nilai ini + 1. |
primaryColor | string | Opsional, format #rrggbb. Hanya mewarnai tombol sampai pengaturan dashboard selesai dimuat. |
Opsi lain di window.cskuSettings diabaikan. Nama channel, salam pembuka, dan form pra-chat hanya bisa diatur dari dashboard.
Jangan taruh data rahasia di snippet
Snippet terlihat oleh semua pengunjung. secretKey dan merchantId tidak dipakai lagi; jika masih ada, hapus dari snippet. Cukup channelKey.
Tampilan dari dashboard
Ubah di Integrasi → Webchat → ikon edit, lalu klik Simpan Perubahan. Kode di website tidak perlu diganti; pengunjung melihat perubahan setelah halaman dimuat ulang.
| Pengaturan | Berlaku di |
|---|---|
| Warna utama | Tombol, kepala jendela, gelembung pesan pengunjung. |
| Logo brand | Kepala jendela dan tombol widget. |
| Posisi tombol widget | Sisi tombol dan jendela chat. |
| Nama channel, salam pembuka | Jendela chat. |
| Form pra-chat | Pengunjung baru diminta nama dan nomor HP. |
Saat halaman dimuat, widget mengambil warna, posisi, dan logo dari https://api.csku.ai/v1/webchat/config/<ID_CHANNEL>. Jika permintaan gagal, tombol tetap tampil dengan warna dan posisi dari snippet. Logo hanya ditampilkan jika berasal dari https://cdn.aplikasikreasi.id, yaitu lokasi file yang diunggah lewat dashboard.
Perilaku widget
- Jendela chat dimuat saat dibutuhkan. Jendela chat berupa iframe ke
https://app.csku.ai/webchat/<ID_CHANNEL>?embed=1. Iframe baru dimuat saat tombol pertama kali diklik, jadi widget tidak memperlambat halaman Anda. - Badge belum dibaca. Saat jendela tertutup, balasan baru menampilkan angka di tombol, maksimal 99. Badge hilang saat jendela dibuka.
- Layar kecil. Di layar dengan lebar di bawah 480 px, jendela chat tampil layar penuh.
- Menutup jendela. Klik tombol chat lagi, tombol tutup di jendela, atau tekan
Escape. - Riwayat pengunjung. Pengunjung yang kembali dengan browser yang sama melihat percakapan sebelumnya. Jika ganti browser, ganti perangkat, atau menghapus data browser, pengunjung mulai dari awal.
- Percakapan selesai. Setelah agen menekan Selesai, pengunjung bisa memulai percakapan baru. Jika punya lebih dari satu percakapan, pengunjung bisa membuka Riwayat percakapan dari ikon jam.
Lampiran dan batas
| Batas | Nilai |
|---|---|
| Panjang satu pesan | 2000 karakter |
| Ukuran lampiran | 5 MB |
| Format lampiran | JPG, PNG, WEBP, GIF, PDF |
File di luar format ini ditolak dengan pesan "Format tidak didukung". File lebih dari 5 MB ditolak dengan pesan "Ukuran file melebihi 5 MB". Tampilan chat berbahasa Indonesia dan bertema terang.
Pemeriksaan keamanan
Pengunjung baru melewati pemeriksaan anti-spam otomatis (Cloudflare Turnstile) saat memulai chat. Pemeriksaan berjalan di dalam iframe, jadi website Anda tidak perlu memuat atau mengizinkan Turnstile. Jika gagal, pengunjung melihat "Verifikasi keamanan gagal. Coba lagi."