Sự kiện người dùng nhận thông báo ZNS

Khi Official Account gửi tin nhắn cho người dùng và tin nhắn đã đến thiết bị người dùng, hệ thống GobyZNS sẽ gửi đến Webhook Url của OA mà bạn đã đăng ký một HTTP request như sau:

URL: Webhook URL của ứng dụng đăng ký theo hướng dẫn tại đây. Method: POST Content Type: application/json X-ZEvent-Signature: mac=sha256(data + timeStamp + ApiKey), với data là chuỗi json trả về dưới đây.

Example request

{
  "sender": {
    "id": "2893352839501541173"
  },
  "recipient": {
    "id": "1077170099018924429"
  },
  "event_name": "user_received_message",
  "message": {
    "delivery_time": "1602960467432",
    "msg_id": "a4bc3a59-c38e-416d-b4d0-0a1de456dfde",
    "tracking_id": "tracking_id"
  },
  "app_id": "2074138120372622546",
  "timestamp": "1602560967477"
}

Lưu ý: GobyZNS mong muốn nhận được http status 200 từ webhook của bạn. Vì lý do kỹ thuật nào đó mà việc gửi không nhận được response 200, chúng tôi sẽ gửi lại webhook tối đa 10 lần. Các lần gửi lại sẽ cách xa nhau dần (lần thử lại sau sẽ được delay lâu hơn lần gửi trước) để tránh gặp vấn đề về rate-limit từ webhook của bạn (nếu có).

Cấu trúc thuộc tính data

Thuộc tính	Kiểu dữ liệu	Mô tả
sender.id	string	ID của Official Account gửi thông báo
recipient.id	string	ID của người dùng nhận thông báo
event_name	string	Tên sự kiện Giá trị nhận về: user_received_message
message.delivery_time	string	Thời gian thiết bị của người dùng nhận được thông báo ZNS
message.msg_id	string	ID của thông báo được sinh ra bởi GobyZNS.
message.tracking_id	string	Mã số đánh dấu lần gọi API của đối tác, do đối tác định nghĩa.
app_id	string	ID của ứng dụng gửi tin (ứng dụng mà OA đã cấp quyền)
timestamp	string	Thời điểm gửi sự kiện