Nhúng vào trang web

Một dòng script để đặt cửa sổ chat lên trang web, kèm các phương thức và quy tắc ngôn ngữ có thể gọi trên trang.

{API} bên dưới là địa chỉ dịch vụ, bạn có thể thấy ở trang 「Tích hợp」 trong phần quản trị.

<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
  • data-key là public key, sao chép ở trang 「Tích hợp」 trong phần quản trị.
  • Đăng ký các website được phép nhúng ở trang 「Tích hợp」 (ví dụ https://shop.example.com); website khác dù có public key của bạn cũng không dùng được. Nhớ điền trước khi lên production.
  • Tuỳ chọn data-theme="dark" để dùng giao diện tối.
  • Tuỳ chọn data-language="de": khi website của bạn đa ngôn ngữ, hãy truyền ngôn ngữ của trang hiện tại vào, cửa sổ chat sẽ mặc định dùng ngôn ngữ đó (khách vẫn có thể chuyển). Mã ngôn ngữ được hỗ trợ xem ở Tổng quan API mở.
  • Tuỳ chọn data-language="auto": lấy <html lang> của trang làm ngôn ngữ mặc định, sau đó khi trang chuyển ngôn ngữ (đổi thuộc tính lang, ứng dụng single-page không cần tải lại cũng được) cửa sổ chat sẽ tự động đổi theo.

Trên trang có thể gọi:

Phương thứcTác dụng
AICS.open() / AICS.close() / AICS.toggle()Mở, đóng cửa sổ chat, ví dụ gắn vào nút 「Liên hệ hỗ trợ」
AICS.identify(userToken)Sau khi khách đăng nhập, cho cửa sổ chat biết khách là ai (xem Nhận diện khách hàng đã đăng nhập)
AICS.setLanguage(code)Gọi khi website chuyển ngôn ngữ, cửa sổ chat và các câu trả lời sau đó sẽ đổi theo, ví dụ AICS.setLanguage("ja"); cũng chấp nhận các dạng như zh-Hans, pt-BR
AICS.reset()Gọi khi khách đăng xuất: gỡ cửa sổ chat, xoá phiên hiện tại; tải lại script sẽ có cửa sổ mới ẩn danh, người sau không thấy hội thoại của người trước

Ngôn ngữ

  • Cửa sổ chat hiển thị ngôn ngữ theo vị trí của khách (IP), bao gồm chữ trên giao diện và lời chào; khi đặt data-language thì ưu tiên ngôn ngữ của trang. Nếu không xác định được vị trí, dùng 「Ngôn ngữ mặc định」 đặt trong phần quản trị.
  • AI trả lời theo ngôn ngữ khách dùng; khi nội dung khách gửi không thể hiện ngôn ngữ (emoji, mã đơn hàng), dùng ngôn ngữ xác định ở trên.
  • Khách có thể chuyển trong menu ngôn ngữ ở đầu cửa sổ, hoặc nói trực tiếp với AI 「Hãy trả lời bằng tiếng Anh」. Sau đó AI sẽ luôn dùng ngôn ngữ này, kể cả khi khách viết bằng ngôn ngữ khác.
  • Việc website chuyển ngôn ngữ (AICS.setLanguage hoặc đổi <html lang> khi data-language="auto") cũng được coi là lựa chọn của khách; trong các cách trên, lần cuối cùng là quyết định, chỉ riêng ngôn ngữ mặc định khi mở trang sẽ không ghi đè ngôn ngữ khách đã chọn.
  • Trong phần quản trị 「Cài đặt bot → Ngôn ngữ」 có thể tắt việc nhận diện theo IP, đổi ngôn ngữ mặc định, giới hạn những ngôn ngữ được mở.
  • Khi triển khai sau reverse proxy hoặc CDN, cần cấu hình TRUSTED_PROXIES hoặc COUNTRY_HEADER ở phía server, nếu không sẽ không lấy được IP thật của khách.

Trang này có hữu ích không?

Cập nhật lần cuối: