Gửi tin nhắn ZBS theo UID

API này giúp bạn gửi tin nhắn ZBS đến người dùng dựa trên UID Zalo (thay vì số điện thoại), sử dụng một template ZBS đã được xuất bản và Zalo duyệt.

thông tin

shopId được hệ thống tự động xác định từ khóa API, bạn không cần truyền thủ công.

---

Endpoint

🔗Endpoint Staging

POST https://staging-manage.api.miniai.vn/api/external/zalo/zbs-uid/send-message

🔗Endpoint Production

POST https://manage-api.miniap.vn/api/external/zalo/zbs-uid/send-message

Điều kiện hợp lệ (Prerequisites)

• templateId là _id của template ZBS trong hệ thống và template phải đã được xuất bản lên Zalo.
• Template phải được liên kết với một OA và có giá gửi tin theo UID (priceUID).
• Ví (wallet) của shop phải đủ số dư để trừ phí gửi tin, nếu không request sẽ trả về lỗi 400.

Dữ liệu được gửi đi (Request Body)

Trường	Kiểu	Bắt buộc	Mô tả
userUID	string	Có	UID Zalo của người nhận.
templateId	string	Có	_id của template ZBS đã xuất bản trong hệ thống.
templateData	object	Có	Cặp key-value (dạng chuỗi) tương ứng các tham số template.

Request

{
  "userUID": "3812763771849273645",
  "templateId": "68c8ee675f8f83fc813e7830",
  "templateData": {
    "customer_fullname": "Lê Quốc An",
    "order_code": "M0WHXJVU9L",
    "order_status": "Đã giao"
  }
}

Phản hồi (Response)

Response

{
    "error": 0,
    "message": "Success",
    "data": {
        "message_id": "cfcd208495d565ef66e7dff9f98764da"
    }
}