抖音开放平台Logo
控制台

拍抖音互动任务变更推送
收藏
我的收藏

    •​使用前置条件：需要具有拍抖音任务能力​
    •​订阅路径：开发者平台-控制台-小程序-开发-开发配置-webhooks 订阅 douyin_interact_task_message 事件​
    •​推送逻辑：包含实时推送和定时推送，满足任意情况都能收到推送信息​
    ◦​用户变更视频状态会触发实时推送，推送视频状态有：成功、失败、非公开​
    ◦​每日凌晨触发定时推送，仅推送互动数据（目标值或阶段值）相比上次查询或推送有变化的视频​
事件名​
事件介绍​
douyin_interact_task_message​
拍抖音互动任务状态变更​

​事件参数​

参数​
​
​
类型​
含义​
event ​
​
​
string ​
事件名，事件唯一标识 ​
from_user_id ​
​
​
string ​
授权方user_id，加密​
to_user_id ​
​
​
string ​
被授权方user_id，加密​
client_key ​
​
​
string ​
小程序appid​
content ​
​
​
string ​
具体内容 ​
​
open_id​
​
string​
任务归属人​
​
task_id​
​
string​
任务id​
​
video_id​
​
string​
任务关联内容id​
​
status​
​
int ​
任务状态：​
​0：初始化，对应视频刚发布未公开状态、未挂载锚点；​
​1：成功，对应视频发布成功并公开状态，并且满足活动条件的状态；​
​2：失败，对应视频删除、审核失败、不满足活动条件的状态；​
​3：非公开，对应视频隐藏；​
​
time_stamp​
​
int ​
变更时间​
​
interact_infos​
​
map<string,interactInfo>​
​
​
​
stage​
int​
当前阶段值​
​
​
completed​
bool​
是否完成​

​事件参数示例​

JSON
复制
{
"event": "douyin_interact_task_message", //事件名
"from_user_id": "", //授权方user_id，加密
"to_user_id": "", //被授权方user_id，加密
"client_key": "", // 小程序id
"content":"{
\"status\":1, // 视频状态：0：初始化；1：成功；2：失败 3：非公开
\"completed\":true, // 任务是否完成
\"open_id\": \"xxxxxxxx\", // 任务关联人id
\"task_id\": \"xxxxx\", // 任务id
\"video_id\": \"xxxxxxx\", // 任务关联视频id
\"time_stamp\": 1670229453, // 变更时间
\"interact_infos\":{ // 互动数据
\"like\": {
\"stage\": 2,
\"completed\": false
},
\"download\": {
\"stage\": 3,
\"completed\": false
}
}
}"
}