Hàm kiểm tra trạng thái tin nhắn Zalo

API kiểm tra trạng thái tin nhắn Zalo, bao gồm thông tin kết quả gửi và mã lỗi của tin nhắn.

Lưu ý: Giới hạn tốc độ gọi api này là 100 requests/giây.

HTTP request

POST https://rest.esms.vn/MainService.svc/json/QueryZnsStatus/

• Content Type: application/json

• Response Type: application/json

curl --location 'https://rest.esms.vn/MainService.svc/json/QueryZnsStatus/' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey": "{{ApiKey}}",
    "SecretKey": "{{SecretKey}}",
    "SmsId": "2d00b834cc1d488081ba7ec308da0ec40918238965",
    "SmsType": "25"
}'

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

Tham số	Kiểu dữ liệu	Tính bắt buộc	Mô tả
ApiKey	string		ApiKey của tài khoản.
SecretKey	string		SecretKey của tài khoản.
SmsId	string		SmsId hệ thống trả về từ mỗi hàm gửi tin nhắn.
SmsType	string		Loại tin nhắn. Api này chỉ cho phép lấy trạng thái của hai loại sau: 24: Zalo ưu tiên 25: Zalo bình thường

---

• Response:

100

{
    "CodeResult": "100",
    "Data": {
        "ErrorInfo": "0",
        "FinalStatus": "1",
        "SMSID": "59e0c764219c49119063db4468f257fb221",
        "SendFailed": 0,
        "SendStatus": 5,
        "SendSuccess": 1,
        "TotalPrice": 330.0,
        "TotalReceiver": 1,
        "TotalSent": 1,
        "ZaloMsgId": "6dc7499c9ef6baaee3e1"
    }
}

Request hợp lệ.

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

Thuộc tính	Kiểu dữ liệu	Mô tả
CodeResult	string	Kết quả của Request.
ErrorMessage	string	Thông báo kết quả trả về.
Data	object	Thông tin trạng thái của tin nhắn Zalo .

• Cấu trúc thuộc tính từng object trong Data:

Thuộc tính	Kiểu dữ liệu	Mô tả
ErrorInfo	string	Mã kết quả xử lý gửi tin nhắn. Giá trị trả về: 0: Tin nhắn gửi thành công. 1001: Tin nhắn trả trạng thái thất bại do khách hàng không online để nhận tin trong thời gian quy định. null: Tin nhắn chưa được gửi. Các giá trị khác: Mã lỗi do hệ thống Zalo trả về. Vui lòng tham khảo bảng mã lỗi Zalo tại link đính kèm để tra cứu ý nghĩa chi tiết.
FinalStatus	string	Mô tả trạng thái tin nhắn đã có kết quả cuối cùng hay chưa. Các giá trị trả về: 1: Đã có trạng thái cuối 0: Chưa có trạng thái cuối
SMSID	string	SmsId của tin nhắn cần kiểm tra.
SendFailed	int	Số lượng tin thất bại.
SendStatus	int	Trạng thái tin nhắn 1: Chờ Duyệt 2: Chờ gửi. 5: Đã gửi xong.
SendSuccess	int	Số lượng tin thành công.
TotalPrice	decimal	Tổng tiền của đơn.
TotalReceiver	int	Số lượng người nhận.
TotalSent	int	Số lượng gửi.
ZaloMsgId	string	Mã giao dịch của Zalo.

• Thông tin chi tiết mã lỗi xem ở bảng: Mã lỗi .

• Lấy code mẫu các ngôn ngữ trên Postman: Link code mẫu.