Chat với khách,
ngay trên website của bạn.

1. 1
   Tạo widget của bạn

   Mở ứng dụng AI Chat Widget trong Prohost và đặt tên, lời chào cùng kiểu nút mở mà khách truy cập sẽ thấy.

2. 2
   Sao chép đoạn mã của bạn

   Trong mục Thêm vào website khác, sao chép đoạn mã. Nó đã sẵn mang theo id widget, khóa nhúng và các thiết lập nút mở của bạn.

3. 3
   Dán vào ngay trước thẻ đóng body

   Thả nó vào chân trang dùng chung toàn site hoặc khu vực mã tùy chỉnh rồi xuất bản. Nút mở sẽ xuất hiện ở góc màn hình trong lần tải trang tiếp theo.

<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  data-position="bottom-right"
  data-launcher-color="#4F46E5"
  data-launcher-icon="chat"
  data-sound="on"
  async></script>

Thay WIDGET_ID và WIDGET_API_KEY bằng giá trị trong phần cài đặt widget của bạn — hoặc đơn giản là sao chép đoạn mã đã điền sẵn từ ứng dụng. Khóa nhúng là khóa công khai và chỉ có phạm vi trong đúng widget đó: nó không cho phép truy cập tài khoản của bạn. Prohost ẩn khóa sau lần hiển thị đầu tiên, nên hãy dùng Đổi khóa nếu bạn cần một đoạn mã mới để sao chép.

<script
  src="https://app.prohost.ai/webchat.js"
  data-widget="WIDGET_ID"
  data-api-key="WIDGET_API_KEY"
  async></script>

Chạy được trên hầu hết trình dựng website — Webflow, WordPress, Squarespace và Wix đều có chỗ để chèn mã tùy chỉnh ở chân trang.

data-hide-mobile chỉ cần có mặt: bất kỳ giá trị nào, kể cả chuỗi rỗng, đều bật nó lên. Mọi thuộc tính khác được so khớp theo giá trị — riêng data-sound chỉ phản ứng với đúng giá trị chữ thường on.

• Khách truy cập phải tương tác với trang trước đã

  Trình duyệt chặn âm thanh cho đến khi có người nhấp, chạm hoặc gõ phím. Mở nút chat cũng được tính, gõ trong khung chat cũng vậy — nên khách vừa gửi tin nhắn tạo ra câu trả lời đó sẽ nghe thấy. Nếu trình duyệt vẫn chặn phát, cũng không sao: huy hiệu chưa đọc trên nút mở mới là tín hiệu chính, còn tiếng chuông chỉ là phần thêm.

• Nó không bao giờ vang khi họ đang đọc

  Không có tiếng chuông khi khung chat đang mở và tab đang ở tiền cảnh — câu trả lời đã hiện trên màn hình rồi. Nó vang khi khung chat đã đóng, hoặc khi tab đang ở nền. Huy hiệu chưa đọc theo một quy tắc hẹp hơn một chút: nó chỉ xuất hiện khi khung chat đang đóng.

• Một loạt câu trả lời chỉ có một tiếng chuông

  Nhiều tin nhắn đến cùng lúc chỉ tạo ra một tín hiệu, không phải mỗi tin một tiếng.

function wireUpWebchat() {
  window.ProhostWebchat.on('webchat_host_message', (event) => {
    console.log(event.type);
  });

  document.querySelector('#my-chat-button')?.addEventListener('click', () => {
    window.ProhostWebchat.open();
    // window.ProhostWebchat.close() collapses it again.
  });
}

if (window.ProhostWebchat) {
  wireUpWebchat();
} else {
  // src*= rather than src$= — the tag may carry a cache-busting query string.
  document
    .querySelector('script[src*="/webchat.js"]')
    ?.addEventListener('load', wireUpWebchat);
}

Hữu ích khi dùng cùng data-hide-mobile: ẩn nút mở mặc định trên điện thoại và mở khung chat từ nút của riêng bạn. Sự kiện chỉ được chuyển tiếp khi đến từ bản nhúng Prohost, không bao giờ từ bất kỳ origin nào khác.