Ứng dụng máy quét hiển thị theo ngôn ngữ trình duyệt của điện thoại — tiếng Việt nếu điện thoại dùng tiếng Việt, tiếng Anh nếu dùng ngôn ngữ khác. Khác với CMS (mặc định tiếng Anh, đổi thủ công), ứng dụng máy quét tự theo thiết bị.Hướng dẫn dưới đây ghi nhãn tiếng Việt trước, kèm nhãn tiếng Anh trong ngoặc.
Luồng hoạt động
Chuẩn bị
1
Tạo API key
Vào API Keys ở thanh điều hướng bên trái và tạo một khoá. Sao chép khoá ngay — khoá chỉ hiển thị một lần.Xem chi tiết tại Khoá API.
2
Tạo máy quét
Vào Scanners, tạo máy quét và cấu hình các hành động sẽ chạy khi quét.Xem chi tiết tại Tổng quan về máy quét và Hành động quét.
3
Lấy ID máy quét
Trong Scanners, sao chép ID của máy quét vừa tạo.
Sử dụng trên điện thoại
1
Mở máy quét
Mở trình duyệt trên điện thoại tại scan.xanhcard.com.Lần đầu mở trên mỗi thiết bị, điền ID máy quét (Scanner ID), API Key, và tên gợi nhớ ở Tên máy quét (tùy chọn), rồi nhấn Thêm máy quét (Add Scanner).Thông tin được lưu trên thiết bị đó, nên những lần sau mở lại không phải nhập nữa.
2
Cấp quyền camera
Khi trình duyệt hỏi, chọn cho phép truy cập camera. Nếu bạn đã từ chối trước đó, mở cài đặt quyền của trình duyệt cho trang này và bật lại.
3
Mở màn hình quét
Máy quét hiện màn hình chờ với tên máy quét và dòng nhắc đưa thẻ vào trước camera.
- Ô chọn ở góc trên bên trái để đổi giữa các máy quét đã thêm.
- Nút Tạo thẻ (Create Card) ở góc trên bên phải — xem phần dưới.
- Nhấn Bắt đầu quét (Start Scanner) để mở camera.
4
Quét mã QR trên thẻ khách hàng
- Đưa mã QR trên thẻ khách vào trước camera.
- Ứng dụng tự nhận diện và hiện hộp thoại Kết quả quét (Scanned Result).
5
Xác nhận và đọc kết quả
- Nếu máy quét có hành động cần nhân viên nhập — ví dụ số điểm muốn cộng — mở Thông tin bổ sung (Additional Information) và điền.
- Nhấn Xác nhận (Confirm) để chạy các hành động đã cấu hình, hoặc Hủy (Cancel) để bỏ lượt quét này.
Tạo thẻ ngay tại quầy
Nút Tạo thẻ (Create Card) dùng khi khách chưa có thẻ. Nhân viên nhập thông tin và phát hành thẻ ngay tại quầy, không cần khách tự đăng ký trước.Lịch sử quét trên thiết bị
Máy quét lưu một danh sách Lịch sử quét ngay trên màn hình quét, kèm số lượt đã quét, để nhân viên xem lại vài lượt vừa thực hiện. Lịch sử này nằm trên chính thiết bị và không đồng bộ lên tài khoản. Số liệu đầy đủ nằm ở Recent Scans trong Dashboard.Giới hạn cần biết
Máy quét được thiết kế cho điện thoại. Mở trên máy tính để bàn, ứng dụng hiển thị cảnh báo “Please use your mobile device to scan” và không quét được.