Các định dạng dữ liệu khi truyền vào tham số trên nội dung ZNS
Dec 27, 2023 2:10 pm
Blog
Dữ liệu khi truyền vào tham số (param) được hệ thống cài đặt với một số định dạng nhất định. Trong bài viết này, đội ngũ hỗ trợ khách hàng Zalo Cloud sẽ liệt kê các dạng khi truyền vào tham số và cách hiển thị của trên mẫu thông báo ZNS gửi đến người nhận nhằm mục đích giúp đối tác hiểu rõ hơn về cách định dạng dữ liệu trước khi truyền vào tham số cũng như các định dạng sẽ hiển thị của mẫu ZNS khi đến máy người dùng (người nhận mẫu thông báo ZNS).
Quý khách có thể xem thêm Tham số (Param) là gì? Thế nào là một tham số đúng quy chuẩn?
Hướng dẫn cài đặt kỹ thuật tham số
Trong quá trình tạo mẫu ZNS, tại bước “Tạo nội dung” có phần cài đặt kĩ thuật cho tham số.
Mỗi tham số sẽ có các cài đặt kĩ thuật khác nhau, tùy vào nhu cầu của doanh nghiệp sẽ có cách cài đặt khác nhau. Tuy nhiên, người dùng cần lưu ý chọn đúng cài đặt kĩ thuật cho từng tham số và truyền đúng định dạng, độ dài ký tự vào param.
Ví dụ:
- Doanh nghiệp chọn tham số <customer_name> với cài kỹ thuật là Tên khách hàng (30) thì độ dài kí tự tối đa mà khách hàng truyền vào là 30 kí tự.
- Đối với các tham số liên quan đến thời gian (ngày/tháng/năm hoặc giờ:phút:giây), doanh nghiệp nên chọn đúng cài đặt kỹ thuật là thời gian.
Các định dạng của tham số khi tạo mẫu ZNS
1. Định dạng khi truyền dữ liệu vào tham số trong nội dung chính
Dữ liệu khi truyền vào tham số được hệ thống cài đặt với một số định dạng nhất định. Với các tham số được truyền vào ở nội dung chính của template không cần thực hiện mã hóa mà có thể giữ nguyên dữ liệu gốc khi truyền vào API để gửi ZNS.
# | Nhãn tham số | Tên tham số | Cài đặt kỹ thuật | Giới hạn ký tự | Data type | Dữ liệu truyền vào |
| 1 | Tên khách hàng | customer_name | Tên khách hàng (30) | 30 | string | Nguyễn Văn A |
| 2 | Điện thoại / Email | contract | Thông tin liên hệ (50) | 50 | string | 096987453x |
| 3 | Giới tính / Danh xưng | personal_title | Giới tính / Danh xưng (5) | 5 | string | Chị |
| 4 | Địa chỉ | address | Địa chỉ (80) | 80 | string | 123 Nguyễn Văn A, phường B |
| 5 | Tên sản phẩm, thương hiệu | product_name | Tên sản phẩm / Thương hiệu (100) | 100 | string | Bàn phím Razer |
| 6 | Số lượng / Số tiền | amount_vn_standard | Số lượng / Số tiền (20) | 20 | string | Định dạng số nguyên: 1000 Định dạng số thập phân: 0.3 |
| 7 | Thời gian | time | Thời gian (20) | 20 | datetime | Định dạng: hh:mm:ss dd/mm/yyyy hoặc; hh:mm:ss hoặc; dd/mm/yyyy |
| 8 | Mã số | product_code | Mã số (30) | 30 | string | TP-34512 |
| 9 | Nhãn tùy chỉnh | custom_field | Nhãn tùy chỉnh (30) | 30 | string | Mẫu nội dung tuỳ chỉnh |
| 10 | OTP | otp | OTP (10) | 10 | string | 3712352 |
| 11 | Trạng thái giao dịch | transaction_status | Trạng thái giao dịch (30) | 30 | string | Giao dịch thành công |
Xem thêm chi tiết các định dạng dữ liệu tại đây.
2. Định dạng của các tham số tại nút thao tác
*Lưu ý: Doanh nghiệp nên mã hóa các tham số truyền vào ở đường liên kết CTA, không mã hóa toàn bộ đường liên kết sẽ ảnh hưởng đến chất lượng template và gây ra những lỗi khác.
Về việc truyền đường liên kết vào CTA
Khi chèn các tham số vào liên kết trong CTA, cần đảm bảo tất cả các yếu tố sau:
- Nên mã hóa các dữ liệu truyền vào tham số ở đường liên kết CTA, không mã hóa toàn bộ đường liên kết sẽ ảnh hưởng đến chất lượng template và gây ra những lỗi khác (không bắt buộc)
- Các tham số trong CTA phải có tên khác với các tham số đã được định nghĩa trong phần nội dung chính & tiêu đề của Template.
Việc mã hóa dữ liệu truyền vào tham số sẽ giúp Zalo giải mã các tham số một cách chính xác và hoàn chỉnh liên kết mà Doanh nghiệp đã sử dụng để tạo mẫu ZNS.
Mã hóa dữ liệu truyền vào tham số ở dạng URL:
Ví dụ: Dữ liệu cần truyền vào tham số tại nút thao là “Nguyễn Văn A”, dữ liệu truyền vào cần được mã hóa trước theo đúng chuẩn UTF-8 như sau:
| # | Nhãn tham số | Tên tham số | Cài đặt kỹ thuật | Data type | Dữ liệu truyền vào | Dữ liệu hiển thị |
| 1 | URL | customer_name | URL (200) | string | Nguy%E1%BB%85n+V%C4%83n+A | Giữ nguyên |
Sau khi định dạng các tham số, Liên kết(URL) truyền vào CTA sẽ có dạng là:
https://example.com/param?customer_name=<param1>&URL=<param2>
Doanh nghiệp đảm bảo chỉ mã hóa dữ liệu truyền vào tham số trong nút thao tác CTA, không mã hóa toàn bộ đường liên kết sẽ ảnh hưởng đến chất lượng template và gây ra những lỗi khác.
Xem chi tiết hướng dẫn truyền tham số vào link CTA tại đây
Hướng dẫn xử lý mã lỗi liên quan thường gặp
| Mã lỗi | Mô tả lỗi | Thông tin lỗi | Hướng dẫn xử lý |
| -132 | Parameter Invalid | Tham số không hợp lệ | Truyền vào đúng với định dạng yêu cầu của từng loại biến. |
Xem thêm chi tiết và hướng dẫn xử lý các mã lỗi tại đây
Nếu có bất kì yêu cầu hỗ trợ, khách hàng có thể liên hệ với đội ngũ Chăm sóc khách hàng của Zalo Cloud qua email: support@zalo.cloud. Đội ngũ CSKH Zalo Cloud sẽ phản hồi cho khách hàng trong vòng 24h làm việc tiếp theo.
Cảm ơn bạn đã góp ý cho chúng tôi!