OnDuty

Cài đặt

Cập nhật 2026-09-07

OnDuty là một tệp JavaScript nằm trên máy chủ của GoEcomaZ. Web của bạn chỉ cần nạp tệp đó bằng một dòng, mọi thứ còn lại (giao diện, trợ lý, gửi số) chạy từ phía GoEcomaZ. Không cài plugin, không đổi giao diện, không cần tài khoản gì thêm.

Dòng cần dán

<script src="https://onduty.goecomaz.com/onduty.js" data-tenant="ten-tiem" defer></script>

ten-tiem là mã tiệm GoEcomaZ gửi bạn khi bật OnDuty (ví dụ tiem-banh-an). Sai mã thì nút không hiện, không có gì hỏng.

Dán ở đâu

Nền Chỗ dán
WordPress Plugin WPCode (tên cũ Insert Headers and Footers) → Footer, dán nguyên dòng. WordPress gốc chỉ có ô CSS bổ sung, không có ô dán JavaScript, nên cần plugin này hoặc sửa file footer.php của theme.
Haravan Website → Giao diện → Chỉnh sửa code → theme.liquid, ngay trước </body>. Đổi giao diện mới thì dán lại.
Sapo Giao diện → Chỉnh sửa HTML/CSS → tệp theme.bwt (Sapo dùng đuôi .bwt, không phải .liquid), ngay trước </body>.
Shopify Online Store → Themes → Edit code → theme.liquid, ngay trước </body>.
Ladipage Thêm phần tử HTML ở cuối trang, dán nguyên dòng. Ladipage có nhiều trang thì mỗi trang dán một lần.
Web viết tay (HTML) Ngay trước </body> của mỗi trang, hoặc trong tệp footer dùng chung.
Next.js / React <Script src="https://onduty.goecomaz.com/onduty.js" data-tenant="ten-tiem" strategy="lazyOnload" /> trong layout gốc.

Web làm với GoEcomaZ thì GoEcomaZ dán sẵn, bạn không phải làm bước này.

Kiểm tra sau khi dán

  1. Mở web trên máy tính, ở góc phải dưới có nút “Cần hỏi gì?” (chữ trên nút do bạn chọn).
  2. Bấm nút, thấy các mục Zalo, gọi, đặt lịch, hỏi nhanh. Bấm từng mục xem đúng số, đúng link.
  3. Vào Hỏi nhanh, hỏi một câu có trong hồ sơ (ví dụ giờ mở cửa). Hỏi thêm một câu chắc chắn không có, trợ lý phải nói để chủ tiệm trả lời.
  4. Gõ số điện thoại của chính bạn vào chat. Vài giây sau Telegram của bạn có tin. Muốn thử mà không gửi thật, thêm ?onduty-dry=1 vào cuối địa chỉ trang trước khi thử.
  5. Mở lại trên điện thoại. Nút vẫn ở góc phải dưới, chat trượt lên từ đáy màn hình.

Những chỗ hay vướng

Web có thanh cookie hoặc thanh nút riêng ở đáy. Nút OnDuty có thể đè lên. Thêm vào CSS của web:

#onduty-root { bottom: 80px; }

Web có thanh nút riêng trên điện thoại (gọi, Zalo dán sẵn ở đáy). Nhắn GoEcomaZ để ẩn nút OnDuty dưới một độ rộng màn hình, hoặc gọi trợ lý từ nút sẵn có của web:

window.OnDuty.openChat();

Web có Content-Security-Policy. Trình duyệt báo “Refused to load” trong console. Thêm https://onduty.goecomaz.com vào script-src và connect-src.

Nút không hiện, console báo 403. Địa chỉ web của bạn chưa được khai với GoEcomaZ (ví dụ bạn vừa đổi từ www sang không www, hoặc thêm tên miền mới). Nhắn GoEcomaZ, thêm trong ngày.

Nút hiện nhưng chữ sai font. OnDuty lấy font của web bạn nếu bạn muốn, mặc định dùng font hệ thống. Nói GoEcomaZ tên font để chỉnh trong cấu hình.

Còn vướng gì khác: xem Xử lý sự cố.