embent

Hướng dẫn cài đặt / Framer

Cài Embent lên Framer

Thêm đoạn mã qua bảng Custom Code của Framer — không cần plugin, không cần ghi đè mã nào.

Trước khi bắt đầu

  • Quyền chỉnh sửa Project Settings của website.
  • Chỉ cần gói Basic hoặc Pro trả phí nếu bạn muốn widget chạy trên tên miền riêng thay vì tên miền phụ *.framer.app miễn phí của Framer — đây là yêu cầu chung của Framer, không riêng cho Embent.

Các bước

1

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>
2

Mở Custom Code trong Project Settings

Mở Project Settings và chọn tab Custom Code ở thanh bên trái, rồi nhấn Add Script (hoặc biểu tượng + nếu bạn đã có sẵn một script).

3

Dán vào, đặt chạy ở mọi lượt truy cập, rồi publish

Dán đoạn mã vào ô mã, đặt tên cho nó, chọn vị trí (head hoặc body, đầu hoặc cuối — cuối body là lựa chọn an toàn mặc định), đặt chạy ở mọi lượt truy cập trang, rồi publish website của bạn.

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

Xuất bản, rồi tải lại website của bạn trong một tab trình duyệt mới: 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.

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

Cách này có hoạt động trên gói Free không?Có. Custom Code có sẵn trong Project Settings ở mọi gói Framer. Bạn chỉ cần gói trả phí nếu muốn có tên miền riêng thay vì tên miền phụ framer.app.
Nên đặt đoạn mã ở head hay body?Cuối body là lựa chọn an toàn hơn: phần còn lại của trang sẽ render trước, script tải ngay sau đó, không chặn bất cứ thứ gì phía trên 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.
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.