Hàm lấy thông tin callback ZNS (Type 24, 25)

curl --location 'http://status-sms.esms.vn/ZaloCallback/GetCallback' \
--header 'Content-Type: application/json' \
--data '{
    "ApiKey":"{{ApiKey}}",
    "SecretKey":"{{SecretKey}}",
    "ListRefid": [
        "41a35814-81d7-4ad1-9cce-1ac7fddd5f34196",
        "41a35814-81d7-4ad1-9cce-1ac7fddd5f34197",
        "41a35814-81d7-4ad1-9cce-1ac7fddd5f34198"
    ],
    "OAId": "{{OAId}}"
}'
  • Thông tin request

BiếnĐịnh nghĩa

ListRefid

Danh sách ReferenceId đã gửi tin. Giới hạn 200 RefId, truyền nhiều hơn sẽ chỉ lấy callback của 200 RefId theo thứ tự từ trên xuống.

OAId

Id của OA đã gửi tin

ApiKey

ApiKey của tài khoản

SecretKey

SecretKey của tài khoản

  • Mẫu kết quả trả về

{
    "Code": 100,
    "Message": "Success",
    "Data_callback": [
        {
            "SMSID": "4a496110-9fd3-4838-ac8b-bcaa36616f7011",
            "SendFailed": 1,
            "SendSuccess": 0,
            "SendStatus": 5,
            "TotalPrice": 0.0,
            "TotalReceiver": 1,
            "TotalSent": 1,
            "RequestId": null,
            "TypeId": 25,
            "Telcoid": 1,
            "PhoneNumber": "0909090909",
            "CallbackUrl": "https://api.esms.vn/zalo-zns/zns/receive-callback",
            "Partnerids": "7984e9b198c40e9957d6",
            "ErrorInfo": "{\"error\":-124,\"message\":\"Access token is invalid\"}Object reference not set to an instance of an object.",
            "OAId": "1090257973118325189",
            "ZnsTempId": "228386"
        } 
                    ]
  } 
  • Thông tin kết quả trả về

BiếnĐịnh nghĩa

SMSID

ReferenceId của tin nhắn muốn xem callback

SendFailed

Tổng số tin thất bại

SendSuccess

Tổng số tin thành công

SendStatus

Trạng thái tin nhắn

  • Trạng thái 2: Chờ gửi

  • Trạng thái 5: Đã gửi

TotalPrice

Tổng số tiền của tin

TotalReceiver

Tổng số tin

TotalSent

Tổng số tin đã gửi

RequestId

Request mà KH truyền vào API để gửi tin

TypeId

Loại tin nhắn

  • Type 24: Zalo Ưu Tiên

  • Type 25: Zalo Bình Thường

Telcoid

Mạng viễn thông của thuê bao nhận tin

  • Mạng số 1: Viettel

  • Mạng số 2: Mobifone

  • Mạng số 3: Vinaphone

  • Mạng số 4: Vietnammobile

  • Mạng số 5: Gmobile

  • Mạng số 6: Itel

  • Mạng số 7: Reddi

PhoneNumber

Số điện thoại nhận tin

CallbackUrl

Link nhận callback

Partnerids

Mã của tin nhắn vừa được gửi (do Zalo trả về)

ErrorInfo

Mã lỗi và thông tin lỗi của tin nhắn

OAId

Id của OA mà KH gửi tin

ZnsTempId

Id của template KH gửi tin

Chú ý:

  • Số ReferenceId tối đa cho 1 lần request là 200, nhiều hơn 200 sẽ chỉ trả 200 ReferenceId đầu tiên.

  • Giới hạn request 20TPS.

Last updated