Quay lại bảng điều khiển

Tài liệu

Tìm hiểu cách sử dụng Asyntai

Chat Nhúng

Hiển thị tiện ích chat trực tiếp trên trang của bạn thay vì dưới dạng bong bóng nổi

Lấy Mã Nhúng
Tất cả Gói

Tổng quan

Mặc định, tiện ích chat Asyntai xuất hiện dưới dạng bong bóng nổi ở góc website. Với Chat Nhúng, bạn cũng có thể hiển thị chat trực tiếp trên trang — ví dụ, trong phần "Chat với chúng tôi" trên trang chủ.

Bong bóng nổi vẫn hoạt động cùng với chat nhúng. Khách truy cập không cuộn đến phần nhúng vẫn có thể sử dụng bong bóng. Cả hai chia sẻ cùng cuộc trò chuyện.

Cách hoạt động

1
Thêm một thẻ script Đặt nó ở bất cứ đâu bạn muốn chat xuất hiện trong HTML
2
Chat hiển thị nội tuyến Tiện ích xuất hiện tại vị trí đó, luôn hiển thị, cùng kích thước với chat thường
3
Bong bóng vẫn hoạt động Bong bóng nổi vẫn ở góc cho khách truy cập không thấy chat nhúng
4
Cuộc trò chuyện Chung Tin nhắn đồng bộ giữa chat nhúng và tiện ích nổi theo thời gian thực

Thiết lập

Thêm dòng HTML duy nhất này ở bất cứ đâu bạn muốn chat xuất hiện trên trang:

<script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Thay thế YOUR_WIDGET_ID bằng ID tiện ích của bạn. Bạn có thể tìm mã nhúng với ID đã điền sẵn trên trang thiết lập Chat Nhúng.

Lưu ý: Script chính chat-widget.js cũng phải có trên trang. Nếu bạn đã cài đặt tiện ích Asyntai trên trang, điều này đã được xử lý.

Ví dụ

Đây là cách bạn có thể sử dụng trên trang chủ:

<section style="max-width: 500px; margin: 0 auto;">
    <h2>Chat with us</h2>
    <p>Ask us anything — our AI assistant is here to help.</p>

    <!-- The chat will appear right here -->
    <script src="https://asyntai.com/static/js/chat-embed.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</section>

Chi tiết

Kích thước

Chat nhúng hiển thị cùng kích thước với tiện ích nổi: 400px rộng và 650px cao trên máy tính, toàn chiều rộng và 550px cao trên di động. Bạn có thể kiểm soát vị trí bằng cách tạo kiểu cho vùng chứa cha.

Hành vi Bong bóng Nổi

Khi chat nhúng hiển thị trên màn hình và khách truy cập nhấn bong bóng nổi, nó cuộn đến chat nhúng. Nếu chat nhúng không trong tầm nhìn, bong bóng mở lớp phủ chat nổi thường.

Đồng bộ Tin nhắn

Cả chat nhúng và nổi chia sẻ cùng cuộc trò chuyện. Tin nhắn gửi từ một bên xuất hiện ở cả hai. Cùng phiên, ngữ cảnh AI và lịch sử chat được sử dụng.

Nhiều Trang

Bạn có thể sử dụng chat nhúng trên một số trang và tiện ích nổi thường trên các trang khác. Chỉ cần bao gồm script nhúng trên các trang bạn muốn chat nội tuyến. Cuộc trò chuyện chuyển tiếp giữa các trang như thường.

Xem trước Trực tiếp

Đây là chat nhúng trực tiếp để bạn xem nó trông như thế nào:

Yêu cầu

Tiện ích chat Asyntai chính (chat-widget.js) phải được cài đặt trên trang
Hoạt động trên tất cả các gói — không cần nâng cấp
Tương thích với tất cả trình duyệt hỗ trợ Shadow DOM (tất cả trình duyệt hiện đại)

Mẹo: Kiểm thử chat nhúng bằng cách đặt trên trang staging trước. Đảm bảo nó hiển thị đúng trong bố cục trang trước khi đưa lên production.