Tin ZBS gửi qua UID
Cùng một mẫu tin, gửi qua UID rẻ hơn gửi qua số điện thoại. Đổi lại, tin chỉ tới được người đã tương tác với OA của bạn và bạn phải có UID của họ. Đây là chỗ để tiết kiệm nếu tệp khách của bạn phần lớn đã quan tâm OA.
Khi nào dùng được
- Khách đã tương tác với OA của bạn — nhắn tin, bấm quan tâm, hoặc đăng nhập bằng Zalo trên website.
- Website đã có UID của khách trong tab Quản lý người dùng OA. Chưa có thì lấy danh sách trước.
- Mẫu tin ZBS đã được Zalo duyệt và tạo sau 10/12/2025. Mẫu cũ hơn không gửi được qua UID (Zalo trả lỗi −249) — phải tạo mới hoặc nhân bản mẫu cũ.
Mở tab Tin qua UID (ZBS)
Vào Cài đặt → DevVN - Zalo OA → Tin qua UID (ZBS).
- Tin qua UID (ZBS) — tab thứ ba.
- Hạn mức — Zalo trả về từng loại quota riêng: tin giao dịch, tin tư vấn, quota theo gói dịch vụ, quota mua lẻ, quota được tặng. Mỗi ô ghi số tin còn lại và hạn dùng. Hết hạn mức là tin không đi được.
- Ba mục con — Khi có đơn mới, Khi thay đổi trạng thái, Khi hoàn thành. Mỗi mục cấu hình riêng.
Bật một mốc gửi tin
Ba mục con dùng chung một kiểu màn hình. Ví dụ mục Khi có đơn mới:
- Kích hoạt — bật mốc này.
- Chọn mẫu tin — chỉ hiện các mẫu ZBS. Sau khi chọn, cột Tham số bên phải hiện ra danh sách ô trống của mẫu để bạn nối với dữ liệu đơn hàng — dùng chung bộ mã thay thế với ZNS, ví dụ
{order_id},{order_full_name},{order_total}. - Lưu thay đổi — bắt buộc.
Làm tương tự cho Khi thay đổi trạng thái và Khi hoàn thành nếu cần.
Thay vì tự chọn kênh cho từng khách, sang tab ZNS API → Cấu hình gửi tin và bật Ưu tiên gửi qua UID. Từ đó plugin tự tra: số nào đã có UID thì gửi ZBS cho rẻ, số nào chưa có thì gửi ZNS. Nếu Zalo trả lỗi ở kênh UID thì tự gửi lại bằng ZNS, khách vẫn nhận được tin.
Khung giờ và hạn mức
Zalo chỉ nhận tin ZBS trong khoảng 6h–21h59. Ngoài khung giờ đó tin sẽ bị từ chối. Hạn mức nhận tin của từng người cũng theo chính sách Zalo từng thời kỳ — gửi quá dày cho một người thì các tin sau bị chặn.
Cách kiểm tra đã chạy đúng chưa
- Vào Quản lý người dùng OA, bấm lấy danh sách, chắc chắn có ít nhất một người có UID.
- Đặt một đơn thử bằng đúng số điện thoại của người đó.
- Mở Quản lý tin nhắn, xem dòng mới nhất — có mã tin trả về là Zalo đã nhận.
- Đối chiếu hạn mức trên đầu tab: số tin còn lại phải giảm đi một.
Lỗi thường gặp
| Hiện tượng | Cách xử lý |
|---|---|
| Zalo trả lỗi −249 | Mẫu tin tạo trước 10/12/2025 nên không gửi qua UID được. Sang trang quản trị Zalo tạo mẫu mới hoặc nhân bản mẫu cũ, rồi chọn lại mẫu mới ở đây. |
| Không gửi được cho một số khách | Những khách đó chưa tương tác với OA nên không có UID. Bật Ưu tiên gửi qua UID ở tab ZNS để plugin tự chuyển sang ZNS cho các trường hợp này. |
| Ô chọn mẫu tin trống | OA chưa có mẫu ZBS nào được duyệt, hoặc access token hết hạn. Xem Kết nối Zalo OA. |
| Hạn mức hiện 0 | Đã dùng hết quota loại đó. Mua thêm hoặc chờ chu kỳ mới; trong lúc đó dùng ZNS. |
| Gửi ban đêm thì trượt | Ngoài khung 6h–21h59. Hẹn lịch gửi trong khung giờ cho phép ở Chiến dịch gửi tin. |
Tiếp theo: cho khách đăng nhập bằng Zalo — cũng là một cách gom UID.