Tạo mẫu tin

Lưu ý:

• Đối với các API sử dụng cho Shop thì API_KEY: <api_key>.Thông tin base_url của Shop

• Đối với các API sử dụng cho Partner thì API_KEY: <shop_key>.Thông tin base_url của Partner

CreateTemplate

post

Body

application/json

oa_idstring · int64Optional

template_idintegerOptional

typestring · enumOptionalPossible values:

Responses

200

A successful response

application/json

apply_template_quotabooleanOptional

created_atstring · date-timeOptional

is_journeybooleanOptional

oa_idstring · int64Optional

preview_urlstringOptional

priceintegerOptional

price_exceededintegerOptional

ref_paramstringOptional

retail_priceintegerOptional

shop_idstring · int64Optional

template_daily_quotaintegerOptional

template_idintegerOptional

template_namestringOptional

template_qualitystring · enumOptionalPossible values:

template_remaining_quotaintegerOptional

template_statusstring · enumOptionalPossible values:

template_tagstring · enumOptionalPossible values:

timeoutintegerOptional

token_typestring · enumOptionalPossible values:

typestring · enumOptionalPossible values:

updated_atstring · date-timeOptional

post

$BASE_URL.Zalo/CreateTemplate

HTTPcURLJavaScriptPython

POST $BASE_URL.Zalo/CreateTemplate HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 49

{
  "oa_id": "text",
  "template_id": 1,
  "type": "unknown"
}

200

A successful response

{
  "apply_template_quota": true,
  "created_at": "2026-03-06T00:11:34.766Z",
  "is_journey": true,
  "oa_id": "text",
  "preview_url": "text",
  "price": 1,
  "price_exceeded": 1,
  "ref_param": "text",
  "retail_price": 1,
  "shop_id": "text",
  "template_daily_quota": 1,
  "template_id": 1,
  "template_name": "text",
  "template_params": [
    {
      "accept_null": true,
      "max_length": 1,
      "min_length": 1,
      "name": "text",
      "require": true,
      "type": "text"
    }
  ],
  "template_quality": "unknown",
  "template_remaining_quota": 1,
  "template_status": "unknown",
  "template_tag": "unknown",
  "timeout": 1,
  "token_type": "unknown",
  "type": "unknown",
  "updated_at": "2026-03-06T00:11:34.766Z"
}

Request:

curl --location '$BASE_URL.Zalo/CreateTemplate' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
"oa_id": "<int64>",
"template_id": "<integer>",
"type": "<string>"
}'

Response:

{
  "apply_template_quota": true,
  "created_at": "2019-08-24T14:15:22Z",
  "price": 0,
  "template_daily_quota": 0,
  "template_id": 0,
  "template_name": "string",
  "template_params": [
    {
      "accept_null": true,
      "max_length": 0,
      "min_length": 0,
      "name": "string",
      "require": true,
      "type": "string"
    }
  ],
  "template_quality": "unknown",
  "template_remaining_quota": 0,
  "template_status": "unknown",
  "template_tag": "unknown",
  "timeout": 0,
  "type": "unknown",
  "updated_at": "2019-08-24T14:15:22Z"
}

Cấu trúc body của request

Tham số	Kiểu dữ liệu	Mô tả
oa_id	int64	ID của OA
template_id	integer	ID của mẫu tin
type	string	Enum: "text": Tin dạng văn bản "otp": Tin xác thực "table": Tin dạng bảng "rating": Tin đánh giá "response button": Tin response button "payment_request": Tin yêu cầu thanh toán "voucher": Tin voucher "custom": Tin tinh chỉnh

Cấu trúc thuộc tính dữ liệu trả về

Tham số	Kiểu dữ liệu	Mô tả
template_id	integer	ID của mẫu tin
template_name	string	Tên của mẫu tin
price	integer	Đơn giá của mẫu tin
timeout	integer	Thời gian tính phí của mẫu tin
apply_template_quota	boolean	True False
template_daily_quota	integer	Số lượng tin ZNS có thể gửi trong 1 ngày
template_quality	string	unknown: Không xác định UNDEFINED: Mức độ chất lượng OA chưa được xác định (trường hợp OA không gửi thông báo ZNS nào trong khung thời gian đánh giá) LOW: Mức độ chất lượng kém MEDIUM: Mức độ chất lượng trung bình HIGH: Mức độ chất lượng cao
template_remaining_quota	integer	Số lượng tin ZNS có thể gửi còn lại trong 1 ngày
template_status	string	Trạng thái mẫu tin unknown: Không xác định PENDING_REVIEW: Đang duyệt DISABLE: Bị khóa ENABLE: Đã duyệt REJECT: Bị từ chối
template_tag	string	Cấp độ mẫu tin unknown: Không xác định OTP: Tin OTP (tag 0) IN_TRANSACTION: Xác nhận/Cập nhật thông tin giao dịch (Tag 1) POST_TRANSACTION: Hỗ trợ dịch vụ liên quan sau giao dịch (Tag 2) ACCOUNT_UPDATE: Cập nhật thông tin tài khoản (Tag 3) GENERAL_UPDATE: Thay đổi thông tin dịch vụ (Tag 4) FOLLOW_UP: Thông báo ưu đãi đến khách hàng cũ (Tag 5)
template_params	array object	Danh sách các thuộc tính của mẫu tin
updated_at	string<date-time>	Thời gian cập nhật
created_at	string<date-time>	Thời gian tạo