Penyesuaian Widget

Penyesuaian Widget

Peribadikan penampilan widget sembang anda untuk sepadan dengan jenama dan reka bentuk laman web anda.

Tetapan

Semua pilihan penyesuaian widget tersedia di Tetapan → Saluran → Web. Pilih saluran web anda dan buka tab Penampilan.

---

Warna Tema

Warna tema diaplikasikan secara konsisten di seluruh widget:

• Latar belakang butang pelancar
• Latar belakang bar pengepala
• Warna butang hantar
• Warna sorotan pautan
• Latar belakang gelembung mesej pengguna

Pilih warna yang sepadan dengan identiti jenama anda dan memastikan kontras yang baik berbanding teks putih.

---

Mesej Selamat Datang

Mesej selamat datang ialah teks pertama yang dilihat oleh pelanggan apabila mereka membuka widget. Pastikan ia mesra dan jelaskan dengan jelas perkara yang boleh dibantu oleh bot.

Contoh:

1. “Hai! Apa yang boleh saya bantu hari ini?”
2. “Selamat datang ke Sokongan Acme. Tanya saya apa sahaja tentang produk dan perkhidmatan kami.”
3. “Helo! Saya di sini untuk membantu. Apa yang boleh saya bantu anda?”

---

Kedudukan Widget

Kedudukan	Nilai Tetapan	Bila Digunakan
Bawah-kanan	bottom-right (lalai)	Penempatan standard, sesuai untuk kebanyakan laman
Bawah-kiri	bottom-left	Apabila bahagian kanan bercanggah dengan elemen lain

---

Avatar

v1.6.4

Paparkan avatar tersuai dalam pengepala widget dan skrin utama dengan menyediakan URL imej.

Melalui Papan Pemuka: Tetapkan URL avatar di Tetapan → Saluran → Web → Penyesuai → URL Avatar.

Melalui Kod Sematan: Hantarkan avatarUrl dalam konfigurasi tema:

<script>
  window.ClientaConfig = {
    botId: "YOUR_BOT_ID",
    widgetId: "YOUR_WIDGET_ID",
    theme: {
      avatarUrl: "https://example.com/your-logo.png"
    }
  };
</script>

Keperluan:

• Mesti URL https:// (http, data:, dan URL javascript: ditolak atas sebab keselamatan)
• Saiz yang disyorkan: 128 × 128 piksel (segi empat sama)
• Format yang disokong: PNG, JPG, WebP, SVG
• Jika URL tidak sah atau imej gagal dimuatkan, ikon lalai akan dipaparkan

---

Mod Salam

v1.6.2

Mesej salam menyokong tiga mod bahasa. Pergi ke Tetapan → Saluran → Web → Penyesuai dan cari bahagian Mod Salam.

Statik

Teks salam yang sama ditunjukkan kepada setiap pelawat tanpa mengira bahasa. Ini ialah mod lalai.

Masukkan salam tunggal dalam medan teks. Contoh: “Hai! Apa yang boleh saya bantu hari ini?”

Padankan Pelawat (locale)

Tunjukkan salam yang berbeza untuk setiap bahasa. Widget membaca bahasa yang dikesan bagi pelawat dan menunjukkan salam yang sepadan.

1. Pilih mod Padankan Pelawat.
2. Medan akan muncul untuk setiap daripada 15 locale yang disokong.
3. Isikan teks salam untuk setiap bahasa yang ingin anda sokong.
4. Biarkan medan locale kosong untuk menggunakan salam Statik bagi bahasa tersebut.

Contoh persediaan:

• Thai: “สวัสดีค่ะ! มีอะไรให้ช่วยไหม?”
• Inggeris: “Hi! How can I help you today?”
• Jepun: “こんにちは！何かお手伝いできますか？“

Org-Main

Salam sentiasa ditunjukkan dalam bahasa respons utama organisasi, tanpa mengira bahasa pelawat. Mod ini membaca bahasa yang ditetapkan dalam Tetapan AI → Bahasa Respons Utama.

Gunakan Org-Main apabila pasukan anda beroperasi dalam satu bahasa dan anda mahu semua salam adalah konsisten.

---

Pemilih Bahasa

v1.6.2

Pemilih bahasa menambah ikon glob (🌐) pada pengepala widget supaya pelawat boleh memilih bahasa mereka secara eksplisit. Ia dilumpuhkan secara lalai.

Untuk mengaktifkan: Di Tetapan → Saluran → Web → Penyesuai, togol Tunjukkan Pemilih Bahasa kepada HIDUP.

Apabila pelawat memilih bahasa daripada senarai juntai bawah:

• Semua respons AI dikunci kepada bahasa tersebut untuk sesi itu
• Kunci ini mengatasi pengesanan automatik walaupun pelawat menaip dalam bahasa yang berbeza
• Antara muka widget beralih kepada bahasa yang dipilih

Lihat Widget Web — Pemilih Bahasa untuk gambaran keseluruhan tingkah laku penuh.

---

Bahasa Lalai

v1.6.8

Tetapkan bahasa lalai untuk widget supaya pelawat melihat antara muka dalam locale pilihan anda sebelum sebarang pengesanan automatik berlaku. Pergi ke Tetapan → Saluran → Web → Penyesuai → Bahasa Lalai dan pilih daripada senarai juntai bawah.

Rantaian keutamaan bahasa ialah:

1. Paksa Bahasa Ini (Tetapan AI) — mengatasi segalanya apabila diaktifkan
2. Pilihan eksplisit pelawat (melalui pemilih bahasa, jika diaktifkan)
3. Bahasa Lalai — tetapan ini
4. locale konfigurasi sematan — nilai locale dalam kod sematan
5. Thai — penggantian apabila tiada yang lain ditetapkan

Pilih “Tiada — ikut konfigurasi sematan” untuk melangkau tetapan ini dan bergantung pada nilai locale kod sematan.

Note

Bahasa Lalai hanya mempengaruhi bahasa antara muka widget. Bahasa respons AI dikawal secara berasingan dalam Tetapan AI.

---

Mod Gelap & Pemboleh Ubah CSS

v1.6.8

Widget menyokong togol mod gelap terbina dalam yang boleh diaktifkan oleh pelawat daripada pengepala sembang. Keseluruhan antara muka widget ditematkan menggunakan sifat tersuai CSS, memastikan penampilan yang konsisten dalam kedua-dua mod.

Pemboleh Ubah CSS Utama

Pemboleh Ubah	Penerangan
--cw-primary	Warna jenama utama (daripada tetapan warna tema anda)
--cw-primary-rgb	Komponen RGB bagi warna utama, digunakan untuk kesan ketelusan
--cw-bg	Warna latar belakang widget
--cw-bg-secondary	Latar belakang sekunder (medan input, elemen borang)
--cw-surface	Warna permukaan untuk kad, petua alat, coretan petikan
--cw-text	Warna teks utama
--cw-text-secondary	Warna teks sekunder/diredam
--cw-border	Warna sempadan untuk pemisah dan garis besar input

Apabila mod gelap ditogol, widget mengaplikasikan kelas cw-dark atau cw-light pada bekas akar, dan semua pemboleh ubah CSS dikemas kini secara automatik. Pengepala kecerunan, gelembung mesej, borang kenalan, dan cip petikan semuanya mematuhi mod semasa.

Note

Mod gelap ialah togol pada pihak pelawat — ia tidak kekal merentas sesi. Widget lalai kepada mod terang melainkan pelawat mengaktifkan mod gelap semasa sesi sembang mereka.

---

Pratonton

Selepas membuat perubahan, gunakan panel Pratonton Langsung di sebelah kanan halaman tetapan untuk melihat dengan tepat bagaimana widget akan kelihatan di laman anda — sebelum menyimpan.

---

Petua

Tip

• Uji widget anda pada desktop dan mudah alih untuk memastikan ia tidak menyekat kandungan halaman yang penting.
• Gunakan warna tema berkontrast tinggi untuk memastikan widget mudah diakses oleh semua pengguna.
• Pastikan mesej selamat datang ringkas — satu atau dua ayat adalah ideal. Pelanggan ingin bertanya soalan mereka, bukan membaca perenggan.