Hướng dẫn tích hợp

Thêm widget LaunchChat vào trang web của bạn với framework bạn muốn.

Cài đặt

Thêm mã này trước thẻ đóng </body>:

<!-- LaunchChat Widget -->
<script>
  window.LaunchChatConfig = {
    widgetId: "YOUR_WIDGET_ID"
  };
</script>
<script src="https://your-domain.com/widget.js" async></script>

Content Security Policy (CSP)

Nếu trang web của bạn sử dụng CSP headers, thêm các tên miền sau:

Content-Security-Policy:
  script-src 'self' https://your-launchchat-domain.com;
  connect-src 'self' https://your-launchchat-domain.com;
  frame-src 'self' https://your-launchchat-domain.com;

Lưu ý bảo mật

Widget ID là công khai

Widget ID được thiết kế để công khai và nhúng trong mã phía client. Nó chỉ cho phép đọc cơ sở kiến thức và chức năng chat. Không thể thực hiện thao tác nhạy cảm nào chỉ với Widget ID.

Giới hạn tên miền

Bạn có thể giới hạn tên miền nào được nhúng widget trong bảng điều khiển tại Widget → Behavior → Allowed Domains. Nếu đã đặt, widget chỉ hoạt động trên các tên miền đó.

Xác minh cài đặt

Sau khi thêm mã, xác minh widget tải đúng cách:

  1. Mở trang web của bạn trong trình duyệt
  2. Tìm nút chat ở góc dưới bên phải
  3. Nhấp vào để mở cửa sổ chat
  4. Gửi tin nhắn thử để xác minh hoạt động

Nếu widget không xuất hiện, kiểm tra console trình duyệt để tìm lỗi và đảm bảo Widget ID của bạn chính xác.