Scan QR Code

Premium Element - Hướng dẫn thiết lập

Giới thiệu

Scan QR Code là tính năng cho phép người dùng quét mã QR theo cấu trúc domain&regexKey1=value1&regexKey2=value2 nhắm lấy được Value chứa trong các mã QR để dùng làm mã xác thực. Sau đó, dùng mã này để đối chiều với các hệ thống bao gồm:

• PangoCDP: dùng làm Key trong Batch Verify Code để xác thực trên Pango Form

• 3rd Party System: sử dụng Access Data API (Postback API) để kiểm tra dữ liệu trên hệ thống của đối tác, cần điểm nổi bật:

  • Đối tác cần tích hợp trước luồng API theo tài liệu mà Pango cung cấp (chi tiết tại đây)

  • Tạo connection với 3rd party system trên module Console

  • Ngoài kiểm tra tính đúng/sai, sử dụng dữ liệu trả kèm từ đối tác để tiếp tục tương tác, cung cấp thông tin cho User.

Element Scan QR Code đang phát triển hỗ trợ nhận được Value theo cấu trúc domain/value1/value2/value3. Theo dõi Release Note để cập nhật thông tin.

Ví dụ: thương hiệu Pango Electronic phát hành trên các sản phẩm của mình một mã unique trên từng sản phẩm để định danh, kiểm soát. Khách hàng có thể quét mã này để kiểm tra tra thông tin sản phẩm trước khi ra quyết định mua hàng. Sau khi đã mua hàng, sẽ ghi nhận thông tin khách hàng theo sản phẩm và họ dùng lại chính mã này để tra cứu bảo hành.

Một số ngữ cảnh có thể áp dụng sau khi đã phát hành mã QR chứa mã trên các sản phẩm, địa điểm,... dùng để tương tác với User:

• Dùng giá trị trên mã QR để kiểm tra tính hợp lệ với Batch Verify Code của Pango để đăng ký tham gia chương trình hoặc nhận thưởng. Ví dụ:

  • Quét mã QR trên mỗi gói Pango Snack để nhận 01 lượt chơi miễn phí

  • Mua sản phẩm để quét nhận mã đặc biệt đăng ký tham gia chương trình

  • Quét mã QR trên sản phẩm nhận các phần quà tương ứng (theo Batch)

  • Phát mã cho User và thực hiện check-in để xác thực sau đó mà không cần dùng Pango Scan

  • Và rất nhiều chương trình khác,...

• Dúng giá trị trên mã QR, sau đó xử lý thêm một vài logic để định nối các chuỗi giá trị (concat) nếu cần thiết ⇒ dùng mã này trong Access Data API qua hệ thống khác để xác thực và nhận các giá trị phản hồi tương ứng.

  • Quét mã QR trên sản phẩm để kiểm tra thông tin sản phẩm

  • Quét mã QR trên hoá đơn sau khi mua sản phẩm để kiểm tra bảo hành

  • Nhân viên quét mã QR của khách hàng để kiểm tra thông tin mua sản phẩm, đặt dịch vụ, đặt lịch hẹn...

  • Trong các ngữ cảnh, thông tin khách hàng đặt trên hệ thống khách hàng, dùng mã định danh khách hàng để kiểm tra

  • Và rất nhiều ngữ cảnh khác,...

Hướng dẫn thiết lập

Truy cập Form Builder thuộc định dạng Step Form ⇒ kéo element Scan QR Code vào để sử dụng

Cấu hình Scan QR Code

• Label: nhập tên element cho User nhận biết để thực hiện

• Field Name: nhập Key đánh dấu, lưu trữ các giá trị trên Form.

Field Name vô cùng quan trọng trong việc xác định được giá trị sẽ lưu trên Form và hiển thị trên element QR Code Info trong trường hợp có sử dụng trên Thank Form.

Setting

Khi sử dụng element này trên ZMA Pango Form sẽ mở camera của Zalo để quét QR. Để thực hiện được tính năng này, cần tạo ticket xin quyền quét QR Code trên nền tảng Zalo Platform.

Allow submitting the form if the verification code fails: mặc định Off, On để sử dụng ⇒ khi áp dụng cần element xác thực mã chính xác mới cho phép Submit Form. Nếu ở trạng thái Off, User có thể submit form trong các trường hợp:

• Quét mã mà không cần kiểm tra tính đúng/sai của mã quét

• Quét mã, mã sai nhưng vẫn không ngắn chặn hành động submit

• Không cần quét mã

Instruction Image: upload hình ảnh mô tả cho User nhằm hiểu cách sử dụng element ⇒ nếu không thực hiện, hệ thống sẽ sử dụng ảnh mặc định.

Instruction Message: mô tả nhằm hướng dẫn sử dụng tính năng

CTA Open Camera Text: nội dung trên button kêu gọi User ấn để quét mã

Domain: nhập địa chỉ của được dùng trong giá trị mã QR dùng để quét. Mỗi element chỉ cho phép quét một domain duy nhất. Khi quét mã, hệ thống sẽ kiểm tra nếu đúng domain khai báo mới tiến hành xác thực value theo regex key. Nếu sai domain sẽ báo mã không hợp lệ.

Regex Items: đối với các mã QR phức tạp, sẽ có nhiều nhóm dữ liệu dạng regexKey=Value trên liên kết. Việc khai báo nhằm chọn được Value đúng ngữ cảnh của người thiết lập.

• Ví dụ: https://domain.com/?model=AW-FLEX100SGN&serial=F10ID-SN070943

  • Sử dụng regexKey là model để nhận giá trị AW-FLEX100SGN

  • Sử dụng regexKey là serial để nhận giá trị F10ID-SN070943

  • Tuỳ vào ngữ cảnh sử dụng mà khai báo Regex Key để nhận giá trị tương ứng, sử dụng tính năng thêm Regex Key để nhận thêm giá trị.

Use the Regex Key value to validate: sử dụng giá trị nhận được từ Regex Key để kiểm tra tính hợp lệ, bao gồm:

• Pango Batch Verify Code: sử dụng Batch Verify Code trên Pango ACT để xác thực

  • Verify Key: nhập Regex Key dùng làm mã xác thực

  • Batch Verify Code: chọn batch chứa các mã dùng để xác thực

  • Do not update the status of the Code after validating: khi bật tính năng nếu mã xác thực đúng, và User thực hiện submit sẽ không cập nhật trạng thái của Verify Key thành Used.

• API via 3rd System: gọi sang hệ thống bên thứ 3 để xác thực, với điệu kiện đã tích hợp theo Pango Document và tạo Connection trên Access Data API.

  • Verify Key: nhập Regex Key được đọc trên mã QR và thiết lập trong Regex Items để sử dụng làm mã gửi qua 3rd System để xác thực

  • Access Data API: chọn Connection đã cấu hình trên module Console

Khi nhập Verify Key hỗ trợ nối chuỗi các giá trị trên Regex Items bằng cách nối chúng lại theo cấu trúc regexKey1-regexKey2 (ví dụ: model-serial ⇒ key được tạo thành sẽ là AW-FLEX100SGN-F10ID-SN070943)

Valid QR Scan Text: nhập nội dung hiển thị khi quét đúng mã thành công

Invalid QR Scan Text: nhập nội dung hiển thị khi quét mã thất bại

Error checking code via API: nhập nội dung hiển thị trong khi gặp lỗi trong quá trình gọi sang 3rd system không nhận được phản hồi

CTA Re-scan Text: nhập nội dung của nút quét lại mã khác