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

Cài Embent lên Shopify

Chỉ một đoạn script trong mã theme, không cần cài app. Nếu bạn mở được trình chỉnh sửa theme, bạn sẽ xong trong vài phút.

Bắt đầu miễn phí Tất cả nền tảng

Trước khi bắt đầu

Quyền chỉnh sửa mã theme của cửa hàng (bạn chỉ sửa được mã theme sau khi đã mua/thêm theme đó vào cửa hàng).
Widget sẽ không hiện trên trang checkout, trang cảm ơn, hoặc trang tình trạng đơn hàng của Shopify — Shopify chặn script tùy chỉnh ở những trang đó với các cửa hàng không dùng Shopify Plus.

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>

Mở mã theme của bạn

Từ trang quản trị Shopify, vào Online Store → Themes. Ở theme hiện tại, nhấn menu ⋯ và chọn Edit code. Shopify khuyên nên nhân bản theme trước, vì các thay đổi mã không tương thích với bản cập nhật theme sau này sẽ bị tự động xóa bỏ.

Dán vào theme.liquid trước </body>

Trong thư mục Layout, mở theme.liquid, cuộn xuống thẻ đóng </body> gần cuối file, và dán đoạn mã ngay phía trên nó. Nhấn Save.

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

Tải lại trang cửa hàng của bạn (không phải trang checkout) 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.

Bong bóng chat không hiện và tôi đang dùng app tối ưu tốc độ (Booster, Hyperspeed, hoặc tương tự)Các app tối ưu tốc độ có tính năng "delay JavaScript until interaction" có thể viết đè hoặc trì hoãn script của Embent. Widget được thiết kế để chịu được việc đó, nhưng nếu vẫn không hiện, hãy thêm "embent" vào danh sách loại trừ của app đó — app nào cũng có mục này — rồi tải lại trang cửa hàng.

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

Widget có hiện trong lúc checkout không?Không. Shopify giới hạn mã tùy chỉnh trên trang checkout với các cửa hàng không dùng Shopify Plus, nên widget chỉ hiện trên các trang cửa hàng, không hiện ở trang checkout, tình trạng đơn hàng, hay trang cảm ơn.

Cập nhật theme có xóa mất đoạn mã không?Có thể — Shopify xóa các thay đổi mã không tương thích khi theme được cập nhật. Hãy nhân bản theme trước khi tùy chỉnh, và kiểm tra lại đoạn mã sau mỗi lần cập nhật theme.

Mình có cần lập trình viên hay một app không?Không. Chỉ cần dán một đoạn script là đủ — không cần cài app, và không cần biết Liquid ngoài việc tìm được thẻ đóng body.

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 ↑