OnDuty

Cài đặt

Updated 2026-09-08

Lấy mã tiệm

Tự làm: vào trang đăng ký, điền tên tiệm, địa chỉ web, tên người phụ trách, số Zalo và email. Xong là có ngay mã tiệm, key quản trị và dòng script để dán. Miễn phí, không cần thẻ, không cần hẹn ai.

Web do GoEcomaZ làm thì GoEcomaZ đã dán sẵn, bạn không phải làm gì.

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 bạn nhận sau khi đăng ký, thường chính là tên miền của bạn (ví dụ tiembanhmai). 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 email của bạn có thư, và số đó nằm trong trang quản trị. 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-srcconnect-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ố.

Sau khi dán

Mở web của bạn một lần bằng trình duyệt. OnDuty nhận ra đoạn mã đang chạy đúng trên tên miền bạn đã khai, và tự bật trợ lý. Không phải gửi ảnh chụp màn hình cho ai, không phải chờ duyệt.

Trước lúc đó, các nút liên hệ đã chạy nhưng trợ lý chưa trả lời. Đó là cách OnDuty biết chắc web là của bạn.

Mất key thì sao

Vào trang đăng nhập, bấm "Quên key". OnDuty gửi một link đăng nhập tới email tiệm đã đăng ký, dùng được 30 phút. Vào rồi bấm "Cấp key mới" trong trang quản trị, key cũ ngừng dùng được ngay.

Link chỉ đăng nhập, không đổi key, nên người khác có xin link cũng không làm bạn mất quyền vào.