Hàm lấy danh sách template Zalo

HTTP request

POST https://rest.esms.vn/MainService.svc/json/GetTemplate/

• Content Type: application/json

• Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/GetTemplate/' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "SecretKey": "{{SecretKey}}",
    "OAId": "4097311281936189049",
    "SmsType": "24"
}'

• Cấu trúc body của request:

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
ApiKey	string		ApiKey của tài khoản.
SecretKey	string		Secretkey của tài khoản.
OAId	string		ID của OA cần lấy template.
SmsType	string		Loại tin 24: Zalo ưu tiên. 25: Zalo bình thường.

---

• Response:

100

{
    "CodeResult": "100",
    "ErrorMessage": "success",
    "ZNSTemplates": [
        {
            "TempContent": "<div class=\"group-desc\" style=\"box-sizing: border-box; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); color: #131820; font-family: Muli, sans-serif; font-size: 16px;\"> <p style=\"box-sizing: border-box; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); margin: 0px; padding: 0px; color: #394e60; font-size: 0.875rem; line-height: 20px;\">Mã OTP của bạn là</p> </div> <p><span class=\"otp-code\" style=\"box-sizing: border-box; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); font-weight: bold; color: #131820; font-size: 1.5rem; letter-spacing: 3.75px; line-height: 24px; display: block; padding: 12px 0px; font-family: Muli, sans-serif;\">{{otp}}</span></p> <div class=\"group-desc\" style=\"box-sizing: border-box; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); color: #131820; font-family: Muli, sans-serif; font-size: 16px;\"> <p style=\"box-sizing: border-box; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); margin: 0px; padding: 0px; color: #394e60; font-size: 0.875rem; line-height: 20px;\">Không tiết lộ cho bất kỳ ai, Mã xác nhận sẽ có hiệu lực trong 5 phút.</p> </div>",
            "TempId": 205644,
            "TempName": "Xác nhận đăng ký dịch vụ",
            "ZNSTempDetail": [
                {
                    "Limit": 10,
                    "Param": "otp",
                    "ParamLevel": 1,
                    "RequireType": "type_text"
                }
            ]
        }
    ]
}

Request hợp lệ.

101

{
    "CodeResult": "101",
    "ErrorMessage": "Authorize Failed"
}

Sai thông tin ApiKey/SecretKey.

Cấu trúc body response:

Thuộc tính	Kiểu dữ liệu	Mô tả
CodeResult	string	Mã trả về.
ErrorMessage	string	Thông tin lỗi trả về (nếu có lỗi).
ZNSTemplates	object	Thông tin chi tiết template.

Cấu trúc thuộc tính từng object trong ZNSTemplates

Thuộc tính	Kiểu dữ liệu	Mô tả
TempContent	string	Nội dung của template.
Tempid	string	Template ID.
TempName	string	Tên template.
ZNSTempDetail	object	Thông tin chi tiết kiểu biến.

Cấu trúc thuộc tính từng object trong ZNSTempDetail

Thuộc tính	Kiểu dữ liệu	Mô tả
Limit	string	Giới hạn độ dài nội dung truyền vào. Khi gửi quá giới hạn này sẽ bị sai template.
Param	string	Tên biến.
ParamLevel	string	Thứ tự của biến
RequireType	string	Kiểu dữ liệu của biến. - type_text - type_number (chỉ truyền số từ 0 đến 9, tối đa là 12 số) - type_date (truyền theo định dạng dd/MM/yyyy) - type_cta_url

• Thông chi tiết mã lỗi xem ở bảng: Mã lỗi .
• Lấy code mẫu các ngôn ngữ trên Postman: Link code mẫu.