抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • OpenAPI 简介
  • 通用参数
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 视频能力
  • 线索组件
  • 接口调用凭证
  • 登录
  • Web 化接入
  • 隐私协议
  • 流量主
  • 小程序码与小程序链接
  • 用户信息
  • 小程序推广计划
  • 内容安全
  • 任务能力
  • 分享
  • 拍抖音任务
  • 拍抖音互动任务
  • 创建任务
  • 查询用户任务进度
  • 拍抖音互动任务变更推送
  • 分享任务
  • 反馈
  • 客服
  • 小程序券
  • 触达与营销
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它
    • •使用前置条件:需要具有拍抖音任务能力
      •订阅路径:开发者平台-控制台-小程序-开发-开发配置-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
    是否完成

    事件参数示例

    { "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 } } }" }