API gửi tin với Object

HTTP REQUEST

URL : https://zns-api.v9.com.vn

OR URL 2 : https://zns-api.voicebrandnames.vn

POST /api/1.0/Integration/SendZNS/Object

API gửi tin nhắn Zalo ZNS

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
RequestId	string (guid)		Mã gửi
TempID	string		Template của Zalo OA mà khách hàng đăng kí
TempData	Object		Đối tượng mảng chứa các key/value để truyền vào các tham số của mẫu tin nhắn. key: Tên biến (bắt buộc phải giống trong Template đã đăng ký). value: Giá trị biến.
Phone	string		Số điện thoại nhận tin nhắn
CustomerCode	string		Mã khách hàng
CallbackUrl	string		URL nhận kết quả gửi tin.

======Mẫu Json body
{
    "RequestId": "2d500001-91ef-11ef-9c6d-bc2411119441",
    "TempID": "XXXXX",
    "TempData": [
        {
            "key": "customer_name",
            "value": "Hoàng Đỗ"
        },
        {
            "key": "order_code",
            "value": "ORDA12"
        },
        {
            "key": "address",
            "value": "3/3 DUy tân"
        },
        {
            "key": "phone",
            "value": "096XXXX"
        },
        {
            "key": "email",
            "value": "[e-mail]"
        },
        {
            "key": "product_name",
            "value": "iPhone"
        },
        {
            "key": "quantity",
            "value": "1"
        },
        {
            "key": "payment_amount",
            "value": "10000000"
        },
        {
            "key": "delivery_date",
            "value": "26/10/2024"
        }
    ],
    "CallbackUrl": "https://zns-api.voicebrandnames.vn/webhook/v1",
    "Phone": "096XXXX",
    "CustomerCode": "V9Tech"
}

Response

200 OK

{
  "status_result": true,
  "status_code": 0,
  "error_message": ""
}

Error

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

Thuộc tính	Kiểu dữ liệu	Mô tả
status_result	boolean	Trạng thái response
status_code	number	Mã lỗi trả về (nếu có)
error_message	string	Thông tin lỗi trả về (nếu có lỗi).