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.

circle-exclamation

HTTP request

POST https://rest.esms.vn/MainService.svc/json/QueryZnsStatus/arrow-up-right

  • 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:

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 Zaloarrow-up-right 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.

Last updated