抖音开放平台Logo
开发者文档
小程序
控制台
  • OpenAPI 简介
  • 小程序 OpenAPI SDK 总览
  • 签名算法
  • 基础能力
  • 触达与营销
  • 订阅消息
  • 给用户发送订阅消息
  • 查询订阅消息模版库
  • 新建订阅消息模板
  • 查询小程序新建的订阅消息模板列表
  • 添加模板
  • 查询小程序的模板列表
  • 删除已添加的模板
  • 抖音内横幅或抖音外实时提醒触达用户失败事件
  • 用户订阅动作推送事件
  • 查询用户模板订阅状态
  • 用户授权订阅卡事件
  • 分发
  • 搜索能力
  • 私信和群聊
  • 挂载
  • 支付
  • 运营
  • 生活服务
  • 垂直行业
  • 其它

    • 概述

    Webhooks 说明文档可参考：Webhooks 概述
    用户授权一次性订阅消息成功且异形卡开关打开情况下，会推送订阅异形卡模板授权成功消息给开发者
    用户授权订阅卡事件如下：
    事件名
    事件介绍
    user_auth_subscribe_card_notification
    用户订阅异形卡授权成功通知

    使用限制

      •当前仅开放一次性订阅消息类型

    事件参数

    参数
    ​
    类型
    含义
    event
    ​
    string
    事件名，唯一标识
    from_user_id
    ​
    string
    订阅用户openID
    client_key
    ​
    string
    开发者应用ID
    content
    ​
    string
    具体内容
    ​
    msg_id
    int
    消息模版ID
    ​
    msg_type
    int
    消息类型 1-一次性消息 2-长期订阅消息
    ​
    auth_time
    int
    用户订阅时间
    ​
    app_type
    int
    应用类型 1-小程序 2-小游戏
    log_id
    ​
    string
    请求唯一标识

    事件参数示例：

    {
    "event":"user_auth_subscribe_card_notification",
    "client_key":"ttb79cc12128a3db2c01",
    "from_user_id":"_000ZqJqe3CiVSTai4-lwkg_hk6PtebTt6YC",
    "content":"{\"msg_id\":\"MSG3512882310a91b74b6474cb09027a3ed8b96ee16290\",\"msg_type\":1,\"auth_time\":\"1710397343\",\"app_type\":1}",
    "log_id":"02171039734323900000000000000000000ffff0a7ab0fc7d9499"
 }
    ​