Sự kiện người dùng nhận tin qua SĐT

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 Zalo sẽ gửi đến Webhook Url của ứng dụng một HTTP request như sau

Lưu ý

Quyền cần có: Nhận sự kiện gửi tin qua SĐT

Lưu ý

Thời điểm user nhận tin nhắn là giá trị của trường delivery_time, không phải thời điểm webhook nhận event hay giá trị của trường timestamp

• URL: webhook URL của ứng dụng
• Method: POST
• Content Type: application/json
• Header X-ZEvent-Signature: mac = sha256(appId + data + timeStamp + OAsecretKey), với data là chuỗi json trả về dưới đây.
• Header X-ZEvent-Server: ZNS

Example request

{
  "sender": {
    "id": "2893352839501541173"
  },
  "recipient": {
    "id": "84123456789"
  },
  "event_name": "user_received_message",
  "message": {
    "delivery_time": "1602960467432",
    "msg_id": "15a0cc0bbb13bd4ce403",
    "tracking_id": "tracking_id"
  },
  "app_id": "2074138120372622546",
  "timestamp": "1602560967477"
}

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 tin
recipient.id	string	Số điện thoại người dùng nhận tin Lưu ý: Số điện thoại sẽ có dạng mã hóa SHA-256 nếu đối tác gửi tin qua SĐT sử dụng hash phone.
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 tin qua SĐT
message.msg_id	string	ID của tin qua SĐT
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