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

Sự kiện Đồng bộ user_external_id thất bại

Khi thực hiện đồng bộ user_external_id qua Widget Cấp tương tác thất bại, 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_failed_to_sync_user_external_id",
"data": {
"user_id": "246845883296197922",
"user_external_id": "3296197922",
"message":"user already has user_external_id"
},
"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_failed_to_sync_user_external_id

data

Json Object

Ví dụ:

{
"user_id": "246845883296197922",
"user_external_id": "3296197922",
"message":"user already has user_external_id"
}

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
  • message: Lý do thất bại, bao gồm:
    • user already has user_external_id: user_id đã tồn tại user_external_id, không thể ghi đè
    • user_externa_id already belongs to another user: User_external_id đã tồn tại ở user khác, không thể ghi đè

timestamp

String

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