Hướng dẫn cài đặt / HTML & website tự dựng

Cài Embent lên bất kỳ website HTML nào

Chỉ một đoạn script, không cần build, không cần framework. Nếu bạn sửa được HTML, bạn sẽ xong trong chưa đầy một phút.

Trước khi bắt đầu

Quyền chỉnh sửa các file HTML hoặc template mà website của bạn phục vụ.

Các bước

Sao chép đoạn mã nhúng của bạn

Trong dashboard Embent của bạn, mở mục Overview của bot và sao chép đoạn mã nhúng. Nó trông như thế này:

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>

Dán trước thẻ đóng </body>

Mở file hoặc template dùng để render mọi trang — với hầu hết website tĩnh đó là một layout dùng chung hoặc file footer include — và dán đoạn mã ngay trước thẻ đóng </body>.

Xuất bản thay đổi của bạn

Tải lên hoặc deploy file đã chỉnh sửa theo cách bạn vẫn thường xuất bản website.

Kiểm tra xem đã thành công chưa

Tải lại website của bạn: bong bóng chat sẽ hiện ở góc màn hình. Hỏi nó một câu về chính nội dung website của bạn, nó sẽ trả lời kèm trích dẫn nguồn.

Nếu không thành công

Đã thử mà widget vẫn không hiện? Những cách sau xử lý được gần như mọi trường hợp.

Mình đã thêm đoạn mã nhúng nhưng widget không hiện lên — không có bong bóng chat, không có nút mở, không thấy gì trên websiteBốn bước kiểm tra sau giải quyết gần như mọi trường hợp "widget không hiện". Đầu tiên, mở website đang chạy thật và xem mã nguồn trang (chuột phải → View Page Source), tìm từ "embent" — nếu không thấy đoạn script đó, có nghĩa là mã chưa được lưu vào trang đã xuất bản. Thứ hai, kiểm tra data-bot ID trong đoạn mã của bạn có khớp với ID hiển thị trong dashboard, mục Settings không. Thứ ba, xóa cache trang của website và cả cache CDN nếu có — một trang bị cache sẽ tiếp tục hiển thị phiên bản cũ, không có widget. Thứ tư, kiểm tra xem bot có đang bị tạm dừng trong dashboard không: một bot bị tạm dừng sẽ chủ động không hiện gì cho khách truy cập.

Bong bóng chat hiện lên nhưng không bao giờ có trả lời, hoặc widget bị thiếu và website của tôi có thiết lập Content-Security-PolicyThêm https://api.embent.com vào cả script-src (để tải script widget) và connect-src (để luồng trả lời chat kết nối ngược về cùng origin). Thiếu script-src sẽ khiến widget bị ẩn hoàn toàn; thiếu connect-src sẽ hiện bong bóng chat nhưng không có câu trả lời nào truyền về.

Mình dùng Cloudflare với Rocket Loader và widget chập chờn hoặc bị thiếuRocket Loader trì hoãn script qua bộ tải riêng của nó. Widget được thiết kế để chịu được việc đó, nhưng nếu vẫn không hiện, hãy thêm data-cfasync="false" vào thẻ script của Embent — đây là cách chính thức để loại trừ khỏi Rocket Loader — và script sẽ tải bình thường.

Câu hỏi thường gặp

Có hoạt động với React, Vue, Next.js hay các framework khác không?Có. Dán đoạn mã một lần vào template HTML gốc — index.html hoặc layout gốc của bạn. Widget render bên trong Shadow DOM và không can thiệp vào framework của bạn; không cần component bao bọc nào.

Nó có làm chậm website của tôi không?Không. Script tải bất đồng bộ (async) và widget luôn dưới 50KB đã nén gzip, không dùng framework riêng, nên không bao giờ chặn quá trình render trang.

Mình có cần thêm nó vào từng trang không?Chỉ cần thêm vào các template dùng chung cho nhiều trang. Trang nào không dùng layout chung thì cần thêm đoạn mã riêng.

Trỏ Embent vào website của bạn ngay.Một AI agent thà nói "mình không biết" còn hơn bịa ra câu trả lời. Gói Free, không cần thẻ — hầu hết các website bắt đầu trả lời khách trong vòng hai phút.

Bong bóng chat ở góc màn hình chính là Embent, đang chạy ngay trên trang này — cứ hỏi nó bất cứ điều gì về Embent.

Bắt đầu miễn phí hoặc xem bản dùng thử ở trên trước ↑