Khi sử dụng dịch vụ nhắn tin ZBS Template để xác thực tài khoản, thông báo giao dịch hoặc chăm sóc khách hàng, doanh nghiệp cần nắm rõ cách hệ thống ghi nhận và tính phí cho từng tin nhắn. Một trong những yếu tố quan trọng là thời gian gửi tin (timeout), được xác định thông qua dữ liệu trả về từ API và sự kiện trạng thái tin nhắn.
Bài viết dưới đây sẽ giải thích cơ chế tính phí ZBS Template Message, thời gian timeout theo từng loại tin và cách kiểm tra dữ liệu cần thiết trong quá trình tích hợp API.
1. Bảng giá dịch vụ ZBS Template Message
Chi phí sử dụng ZBS Template Message được xác định theo bảng giá áp dụng cho từng loại tin nhắn và chính sách dịch vụ tương ứng.
Ngoài đơn giá, doanh nghiệp nên tìm hiểu điều kiện ghi nhận tính phí, đặc biệt là quy tắc timeout đối với tin nhắn gửi qua số điện thoại. Đây là thông tin cần thiết để đối soát chi phí trong quá trình sử dụng dịch vụ.
2. Cơ chế tính phí ZBS Template theo thời gian gửi tin
Đối với tin nhắn ZBS Template gửi qua số điện thoại, hệ thống áp dụng ngưỡng thời gian timeout để xác định việc tính phí. Theo cơ chế này, tin nhắn có thời gian gửi vượt quá ngưỡng quy định sẽ không bị tính phí.
Ngược lại, nếu tin nhắn được gửi thành công trong khoảng thời gian timeout cho phép, phí dịch vụ sẽ được tính theo quy định hiện hành.
Ngưỡng timeout được áp dụng như sau:
Lưu ý: Quy tắc timeout nêu trên áp dụng cho tin nhắn gửi qua số điện thoại. Với tin nhắn gửi qua UID, phí được tính khi máy chủ Zalo xử lý tin nhắn thành công.
3. Cách xác định thời gian gửi tin qua API
Để kiểm tra một tin nhắn có nằm trong ngưỡng timeout hay không, doanh nghiệp cần đối chiếu hai mốc thời gian do hệ thống cung cấp: thời điểm gửi tin và thời điểm tin được chuyển đến người nhận.
Bước 1: Lấy thời điểm gửi tin (sent_time)
Sau khi yêu cầu gửi tin được máy chủ Zalo tiếp nhận thành công, response API trả về trường dữ liệu sent_time.
Bước 2: Lấy thời điểm chuyển tin (delivery_time)
Khi tin nhắn được chuyển đến người dùng, hệ thống gửi sự kiện về webhook, trong đó có trường delivery_time.
Bước 3: Tính khoảng thời gian gửi tin
Sau khi có đủ hai mốc thời gian, doanh nghiệp áp dụng công thức:
Thời gian gửi tin = delivery_time − sent_time
Kết quả được đối chiếu với ngưỡng timeout tương ứng của loại tin nhắn để xác định điều kiện tính phí.
4. Ví dụ minh họa cách tính timeout
Giả sử doanh nghiệp gửi một tin nhắn xác thực và hệ thống ghi nhận thời điểm gửi là 10:00:00.
Trường hợp 1: Tin được chuyển đến người nhận lúc 10:00:08. Thời gian gửi là 8 giây, nằm trong ngưỡng timeout 15 giây. Tin nhắn được tính phí theo quy định.
Trường hợp 2: Tin được chuyển đến người nhận lúc 10:00:20. Thời gian gửi là 20 giây, vượt ngưỡng timeout 15 giây. Tin nhắn không bị tính phí theo cơ chế timeout được công bố.
Ví dụ trên minh họa riêng đối với tin xác thực gửi qua số điện thoại. Với các loại tin khác, doanh nghiệp cần sử dụng ngưỡng timeout tương ứng là 7.200 giây.
5. Doanh nghiệp cần lưu ý gì khi đối soát phí ZBS?
Để theo dõi chi phí nhắn tin chính xác và thuận tiện khi kiểm tra trạng thái gửi, doanh nghiệp nên:
Lưu lại response API có trường sent_time sau khi gửi tin.
Ghi nhận dữ liệu webhook có trường delivery_time khi tin được chuyển đến người dùng.
Đối chiếu thời gian thực tế với ngưỡng timeout của đúng loại tin nhắn.
Phân biệt luồng gửi qua số điện thoại và luồng gửi qua UID vì điều kiện tính phí khác nhau.
Tham khảo bảng giá và tài liệu API chính thức để cập nhật quy định áp dụng tại thời điểm sử dụng.
Việc lưu trữ đầy đủ dữ liệu gửi và nhận không chỉ hỗ trợ đối soát chi phí mà còn giúp đội ngũ kỹ thuật theo dõi trạng thái tin nhắn và kiểm tra các trường hợp phát sinh bất thường.
Kết luận
Hiểu rõ cơ chế tính phí ZBS Template Message giúp doanh nghiệp chủ động hơn trong việc quản lý ngân sách nhắn tin và xây dựng quy trình đối soát dữ liệu. Đối với tin nhắn gửi qua số điện thoại, thời gian timeout được xác định dựa trên chênh lệch giữa delivery_time và sent_time; trong khi tin nhắn gửi qua UID được tính phí khi máy chủ Zalo xử lý thành công.
Doanh nghiệp nên kết hợp việc theo dõi dữ liệu API với bảng giá và tài liệu kỹ thuật chính thức để đảm bảo quá trình triển khai, vận hành và kiểm soát chi phí được thực hiện nhất quán.
