Gửi tin ZBS qua UID có rẻ hơn qua số điện thoại không?

Thường là có. Gửi qua UID có thể dùng quota gói tính năng (purchase_quota) hoặc quota thưởng (reward_quota), và nhiều trường hợp chi phí thấp hơn gửi qua số điện thoại. Tuy nhiên UID yêu cầu biết user_id của người nhận và template phải hỗ trợ gửi UID.

Endpoint gửi tin ZBS qua SĐT và UID khác nhau thế nào?

Gửi qua số điện thoại dùng POST https://business.openapi.zalo.me/message/template với tham số phone. Gửi qua UID dùng POST https://openapi.zalo.me/v3.0/oa/message/template với tham số user_id. Cả hai đều truyền template_id và template_data, dùng access_token của OA.

Khi nào nên dùng SĐT, khi nào nên dùng UID?

Ưu tiên UID khi đã có user_id (khách từng tương tác với OA/Mini App) và template hỗ trợ UID — để tối ưu chi phí. Dùng SĐT khi chỉ có số điện thoại hoặc khi gửi UID thất bại. Chiến lược tốt là thử UID trước, fallback sang SĐT.

Vì sao gửi qua UID báo lỗi -249?

Lỗi -249 nghĩa là template không hỗ trợ gửi qua UID — thường do template tạo trước 10/12/2025, template OTP, chứa component Response hoặc Journey. Cần tạo lại template theo chuẩn ZBS để gửi UID.

Gửi tin ZBS qua số điện thoại hay UID? So sánh chi tiết & cách chọn (2026)

Tóm tắt nhanh: Gửi qua UID thường tối ưu chi phí hơn nhưng cần có user_id và template hỗ trợ UID. Gửi qua số điện thoại phủ rộng hơn nhưng tính phí và cần quyền gửi SĐT. Chiến lược tốt nhất: thử UID trước, fallback sang SĐT.

Hai cách gửi tin ZBS

ZBS Template Message hỗ trợ gửi tin theo số điện thoại hoặc theo UID (định danh người dùng theo OA). Hai kênh dùng endpoint khác nhau và có cơ chế tính phí/quota khác nhau.

Bảng so sánh SĐT vs UID

Tiêu chí	Qua số điện thoại	Qua UID
Định danh người nhận	Số điện thoại (84xxxxxxxxx)	user_id của OA
Endpoint	business.openapi.zalo.me/message/template	openapi.zalo.me/v3.0/oa/message/template
Chi phí / quota	Tính phí; có dailyQuota / remainingQuota	purchase_quota / reward_quota; thường rẻ hơn
Điều kiện	OA có quyền gửi SĐT, đã xác thực	Phải biết user_id; template hỗ trợ UID
Template hỗ trợ	Hầu hết template đã duyệt	Không hỗ trợ template cũ (<10/12/2025), OTP, Response, Journey

API gửi qua số điện thoại

POST https://business.openapi.zalo.me/message/template

Body gồm phone, template_id, template_data, tùy chọn sending_mode (1 thường, 3 vượt hạn mức) và tracking_id. Phản hồi trả msg_id, sent_time và quota (dailyQuota, remainingQuota).

API gửi qua UID

POST https://openapi.zalo.me/v3.0/oa/message/template

Body gồm user_id, template_id và template_data. Phản hồi trả message_id và thông tin quota với quota_type là purchase_quota (gói tính năng) hoặc reward_quota (quota thưởng).

Khi nào chọn cái nào?

Chiến lược Smart Routing (kinh nghiệm Zimo):

Có user_id + template hỗ trợ UID → gửi UID trước (tối ưu chi phí).
Không có user_id, hoặc UID thất bại → fallback gửi qua số điện thoại.
Ghi log cả hai để đối soát chi phí, và chống gửi trùng theo (sự kiện + mã đơn).

Câu hỏi thường gặp

Gửi qua UID có rẻ hơn không?

Thường rẻ hơn vì dùng quota gói (purchase_quota) hoặc quota thưởng (reward_quota), nhưng cần biết user_id và template hỗ trợ UID.

Endpoint hai kênh khác nhau ra sao?

SĐT: business.openapi.zalo.me/message/template (tham số phone). UID: openapi.zalo.me/v3.0/oa/message/template (tham số user_id).

Vì sao gửi UID báo lỗi -249?

Template không hỗ trợ UID (tạo trước 10/12/2025, OTP, Response, Journey). Cần tạo lại theo chuẩn ZBS.

Nguồn: Zalo for Developers — API gửi tin ZBS. Phân tích & chiến lược chọn kênh do Zimo biên soạn từ kinh nghiệm tích hợp thực tế.

Muốn gửi tin ZBS tối ưu chi phí qua cả SĐT và UID?

Zimo triển khai smart routing UID-trước-SĐT-sau, đối soát chi phí và chống gửi trùng tự động.

Nhận tư vấn miễn phí →

Gửi tin ZBS qua số điện thoại hay UID? So sánh chi tiết & cách chọn