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

(63) Thay đổi hoạt động

Tình huống kích hoạt

Webhook Activity change được thiết kế để thông báo cho đối tác về các thay đổi liên quan đến hoạt động và các sản phẩm gắn với chúng. Điều này cho phép ứng dụng luôn đồng bộ với những thay đổi về chi tiết hoạt động hoặc danh sách sản phẩm được thêm vào/loại trừ.

Tham số nghiệp vụ dữ liệu

PropertiesTypeExampleDescription
shop_idString"7494049642642441621"ID của cửa hàng.
timestampInt641732526400Thời điểm webhook này được kích hoạt, biểu diễn bằng Unix timestamp.
tts_notification_idString"7327112393057371910"ID của thông báo.
typeInt6463ID của loại webhook.
dataObject
└ activity_idString"7136104329798256386"ID của hoạt động khuyến mãi.
└ update_timeInt641732526465Thời điểm trạng thái thay đổi, biểu diễn bằng Unix timestamp (giây).
└ change_typeStringCREATELoại thay đổi hoạt động. * CREATE * UPDATE * DEACTIVATE
└ product_update_listObjectCác sản phẩm nằm trong phạm vi đã được cập nhật.
└└ product_ids[]String["123456","789012"]ID của các sản phẩm được thêm vào.
└└ exclude_product_ids[]String["345678"]ID của các sản phẩm BXGY bị loại trừ cần xóa. Số lượng tối đa: 100.
└└ benefit_product_ids[]String["456789"]Danh sách ID sản phẩm TikTokShop.
└ product_remove_listObjectCác sản phẩm bị xóa khỏi hoạt động.
└└ product_ids[]String["111222","333444"]ID của các sản phẩm bị xóa.
└└ sku_ids[]String["111","222"]ID của các SKU bị xóa.
└└ benefit_product_ids[]String["555666"]Danh sách ID sản phẩm TikTokShop.
└└ exclude_product_ids[]String["345678"]ID của các sản phẩm BXGY bị loại trừ cần xóa. Số lượng tối đa: 100.

Ví dụ sự kiện

JSONWord Wrap

{
"type": 63,
"timestamp": 1678886400,
"shop_id": "789123456789123456",
"tts_notification_id": "000000000000000001",
"data": {
"activity_id": "act_123456789012345678",
"update_time": 1678886400,
"change_type": "product_update",
"product_update_list": {
"product_ids": [
"11111111",
"22222222"
],
"exclude_product_ids": [
"33333333"
],
"benefit_product_ids": [
"44444444"
]
},
"product_remove_list": {
"product_ids": [
"55555555"
],
"sku_ids": [
"66666666"
],
"benefit_product_ids": [],
"exclude_product_ids": []
}
}
}