Chuyển tới nội dung chính

Sự kiện người dùng đồng ý cấp quyền tương tác

Khi user đồng ý cấp quyền tương tác cho OA thông qua Widget Cấp tương tác, hệ thống Zalo gửi đến webhook URL đã đăng ký của ứng dụng

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

Example

{
"app_id": "360846524840903967",
"oa_id": "388613280879880645",
"user_id_by_app":"4840903967328087",
"event_name": "widget_interaction_accepted",
"data": {
"user_id": "246845883296197922",
"user_external_id": "3296197922",
"url":"https://oa.zalo.me/home"
},
"timestamp": "15503500848"
}

Mô tả thuộc tính

Thuộc tính

Kiểu dữ liệu

Mô tả

app_id

String

Id của ứng dụng

oa_id

String

Id của Official Account

user_id_by_app

String

Trường này chỉ có khi app_id và oa_id trên đang liên kết với nhau.

event_name

String

Giá trị là: widget_interaction_accepted

data

Json Object

Ví dụ:

{
"user_id": "246845883296197922",
"user_external_id": "3296197922",
"url":"https://oa.zalo.me/home"
}

Trong đó:

  • user_id: user_id của khách hàng khi tương tác với Official Account
  • user_external_id: user_id của khách hàng trong hệ thống của Doanh nghiệp, do Doanh nghiệp truyền vào
  • url: trang web mà user thực hiện cấp quyền

timestamp

String

Thời điểm event được gửi, tính bằng milisecond