Các định dạng dữ liệu khi truyền vào tham số trên nội dung ZNS
May 31, 2023 10:45 am
Zalo Cloud 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 khi truyền dữ liệu vào tham số
Doanh nghiệp có thể tham khảo thêm các định dạng truyền vào param và format hiển thị trên máy người dùng cuối theo bảng sau:
| Nhãn tham số | Mẫu tên tham số gợi ý | Data type | Giới hạn ký tự | Cài đặt kỹ thuật | Ví dụ định dạng dữ liệu truyền vào | Định dạng dữ liệu hiển thị | |
| 1 | Tên khách hàng | customer_name | string | 30 | Tên khách hàng (30) | Nguyễn Văn A | Giữ nguyên |
| 2 | Điện thoại / Email | contract | string | 50 | Thông tin liên hệ (50) | 096987453x | Giữ nguyên |
| 3 | Giới tính / Danh xưng | personal_title | string | 5 | Giới tính / Danh xưng (5) | Chị | Giữ nguyên |
| 4 | Địa chỉ | address | string | 80 | Địa chỉ (80) | 123 Nguyễn Văn A, phường B | Giữ nguyên |
| 5 | Tên sản phẩm, thương hiệu | product_name | string | 100 | Tên sản phẩm / Thương hiệu (100) | Bàn phím Razer | Giữ nguyên |
| 6 | Số lượng / Số tiền | amount_vn_standard | number | 20 | Số lượng / Số tiền (20) | Định dạng: Số nguyên 1000 | 1.000 |
| Định dạng: Số thập phân 0.3 | 0,3 | ||||||
| 7 | Thời gian | time | datetime | 20 | Thời gian (20) | Định dạng: hh:mm:ss dd/mm/yyyy hoặc; hh:mm:ss hoặc; dd/mm/yyyy | Giữ nguyên |
| 8 | Mã số | product_code | string | 30 | Mã số (30) | TP-34512 | Giữ nguyên |
| 9 | Nhãn tùy chỉnh | custom_field | string | 30 | Nhãn tùy chỉnh (30) | mẫu nội dung tuỳ chỉnh | Giữ nguyên |
| 10 | OTP | otp | string | 10 | OTP (10) | 3712352 | Giữ nguyên |
| 11 | Trạng thái giao dịch | transaction_status | string | 30 | Trạng thái giao dịch (30) | giao dịch thành công | Giữ nguyên |
| 12 | URL | customer_name | string | 30 | URL (30) | Nguyen%20Van%20A (Lưu ý: Cần encode nội dung chuẩn UTF-8 trước khi truyền vào) | Giữ nguyên |
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.