Tùy chỉnh Widget

Tùy chỉnh Widget

Cá nhân hóa giao diện widget chat để phù hợp với thương hiệu và thiết kế trang web của bạn.

Cài đặt

Tất cả các tùy chọn tùy chỉnh widget có sẵn tại Cài đặt → Kênh → Web. Chọn kênh web của bạn và mở tab Giao diện.

---

Màu chủ đề

Màu chủ đề được áp dụng đồng nhất trên toàn bộ widget:

• Nền nút khởi chạy
• Nền thanh tiêu đề
• Màu nút gửi
• Màu nổi bật liên kết
• Nền bong bóng tin nhắn người dùng

Chọn màu phù hợp với nhận diện thương hiệu và đảm bảo độ tương phản tốt với văn bản trắng.

---

Tin nhắn chào mừng

Tin nhắn chào mừng là văn bản đầu tiên khách hàng thấy khi mở widget. Hãy giữ thân thiện và giải thích rõ ràng bot có thể giúp gì.

Ví dụ:

1. “Xin chào! Tôi có thể giúp gì cho bạn hôm nay?”
2. “Chào mừng đến với Acme Support. Hỏi tôi bất cứ điều gì về sản phẩm và dịch vụ của chúng tôi.”
3. “Xin chào! Tôi ở đây để giúp đỡ. Tôi có thể hỗ trợ gì cho bạn?”

---

Vị trí Widget

Vị trí	Giá trị cài đặt	Khi nào sử dụng
Dưới bên phải	bottom-right (mặc định)	Vị trí tiêu chuẩn, phù hợp với hầu hết các trang
Dưới bên trái	bottom-left	Khi bên phải xung đột với các phần tử khác

---

Avatar

v1.6.4

Hiển thị avatar tùy chỉnh trong tiêu đề widget và màn hình chính bằng cách cung cấp URL hình ảnh.

Qua Dashboard: Đặt URL avatar tại Cài đặt → Kênh → Web → Customizer → Avatar URL.

Qua Mã nhúng: Truyền avatarUrl trong cấu hình theme:

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

Yêu cầu:

• Phải là URL https:// (các URL http, data: và javascript: bị từ chối vì lý do bảo mật)
• Kích thước khuyến nghị: 128 × 128 pixel (hình vuông)
• Định dạng hỗ trợ: PNG, JPG, WebP, SVG
• Nếu URL không hợp lệ hoặc hình ảnh tải thất bại, biểu tượng mặc định sẽ được hiển thị

---

Chế độ Lời chào

v1.6.2

Tin nhắn chào mừng hỗ trợ ba chế độ ngôn ngữ. Vào Cài đặt → Kênh → Web → Customizer và tìm mục Chế độ Lời chào.

Tĩnh

Văn bản chào mừng giống nhau được hiển thị cho mọi khách truy cập bất kể ngôn ngữ. Đây là chế độ mặc định.

Nhập một lời chào trong trường văn bản. Ví dụ: “Xin chào! Tôi có thể giúp gì cho bạn hôm nay?”

Khớp Khách truy cập (locale)

Hiển thị lời chào khác nhau cho mỗi ngôn ngữ. Widget đọc ngôn ngữ được phát hiện của khách truy cập và hiển thị lời chào phù hợp.

1. Chọn chế độ Khớp Khách truy cập.
2. Một trường xuất hiện cho mỗi trong số 15 locale được hỗ trợ.
3. Điền văn bản lời chào cho mỗi ngôn ngữ bạn muốn hỗ trợ.
4. Để trống trường của một locale để sử dụng lời chào Tĩnh cho ngôn ngữ đó.

Ví dụ cài đặt:

• Tiếng Thái: “สวัสดีค่ะ! มีอะไรให้ช่วยไหม?”
• Tiếng Anh: “Hi! How can I help you today?”
• Tiếng Nhật: “こんにちは！何かお手伝いできますか？“

Org-Main

Lời chào luôn được hiển thị bằng ngôn ngữ phản hồi chính của tổ chức, bất kể ngôn ngữ của khách truy cập. Chế độ này đọc ngôn ngữ được đặt trong Cài đặt AI → Ngôn ngữ phản hồi chính.

Sử dụng Org-Main khi nhóm của bạn hoạt động bằng một ngôn ngữ và bạn muốn tất cả lời chào nhất quán.

---

Bộ chọn Ngôn ngữ

v1.6.2

Bộ chọn ngôn ngữ thêm biểu tượng địa cầu (🌐) vào tiêu đề widget để khách truy cập có thể chủ động chọn ngôn ngữ của mình. Nó bị tắt theo mặc định.

Để bật: Trong Cài đặt → Kênh → Web → Customizer, bật Hiển thị Bộ chọn Ngôn ngữ thành BẬT.

Khi khách truy cập chọn ngôn ngữ từ danh sách thả xuống:

• Tất cả phản hồi AI bị khóa theo ngôn ngữ đó cho phiên
• Khóa ghi đè phát hiện tự động ngay cả khi khách truy cập nhập bằng ngôn ngữ khác
• Giao diện widget chuyển sang ngôn ngữ được chọn

Xem Web Widget — Bộ chọn Ngôn ngữ để biết tổng quan đầy đủ về hành vi.

---

Ngôn ngữ Mặc định

v1.6.8

Đặt ngôn ngữ mặc định cho widget để khách truy cập thấy giao diện bằng locale ưa thích của bạn trước khi bất kỳ phát hiện tự động nào xảy ra. Vào Cài đặt → Kênh → Web → Customizer → Ngôn ngữ Mặc định và chọn từ danh sách thả xuống.

Chuỗi ưu tiên ngôn ngữ là:

1. Buộc Ngôn ngữ này (Cài đặt AI) — ghi đè mọi thứ khi được bật
2. Lựa chọn rõ ràng của khách truy cập (qua bộ chọn ngôn ngữ, nếu được bật)
3. Ngôn ngữ Mặc định — cài đặt này
4. Locale cấu hình nhúng — giá trị locale trong mã nhúng
5. Tiếng Thái — dự phòng khi không có gì khác được đặt

Chọn “Không — theo cấu hình nhúng” để bỏ qua cài đặt này và dựa vào giá trị locale của mã nhúng.

Ghi chú

Ngôn ngữ Mặc định chỉ ảnh hưởng đến ngôn ngữ giao diện widget. Ngôn ngữ phản hồi AI được kiểm soát riêng trong Cài đặt AI.

---

Xem trước

Sau khi thực hiện thay đổi, sử dụng bảng Xem trước trực tiếp ở bên phải của trang cài đặt để thấy chính xác cách widget sẽ xuất hiện trên trang của bạn — trước khi lưu.

---

Mẹo

Mẹo

• Kiểm tra widget của bạn trên cả máy tính để bàn và thiết bị di động để đảm bảo nó không chặn nội dung trang quan trọng.
• Sử dụng màu chủ đề có độ tương phản cao để giữ widget có thể truy cập cho tất cả người dùng.
• Giữ tin nhắn chào mừng ngắn gọn — một hoặc hai câu là lý tưởng. Khách hàng muốn đặt câu hỏi của họ, không phải đọc một đoạn văn.