抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 能力教程
  • 流量入口
  • 通用能力
  • 推广变现
  • 经营能力
  • 接入订阅消息能力
  • 接入 IM 消息收发能力
  • 私域经营能力
  • 小程序私信、群聊能力概述
  • 小程序主动私信能力
  • 小程序类型卡片概述
  • 行业能力
  • AI/AR 算法能力
  • 性能优化
  • 安全
  • 什么是小程序主动私信能力

    小程序主动私信能力,又称小程序服务私信能力,是一种向 C 端抖音用户发送多条私信消息的能力,能够帮助小程序开发者实现精准、持续触达抖音 C 端用户。
    不同于陌生人消息会收纳到消息盒子中,收到小程序主动私信消息的 C 端抖音用户体验与接收抖音私信的体验一致,收到的主动私信消息将直接在抖音 C 端用户的消息列表中展示。有关小程序主动私信能力的更多介绍,详见小程序主动私信。
    版本
    小程序发送主动私信
    接入场景
    自研小程序+自研私信和群聊能力
    接入前提
    小程序
    接入成本
    较低
    拥有小程序即可闭环接入

    小程序主动私信接入流程

    在小程序主动私信的接入过程中,主要存在三个角色,分别为小程序开发者、小程序经营者和 C 端抖音用户。
    角色
    描述
    小程序开发者
    实际为小程序主动私信能力进行代码开发的用户,可能是小程序的抖音开放平台账号所有者或管理员。
    小程序经营者
    实际向 C 端抖音用户发送小程序主动私信的用户,必须为与小程序绑定的品牌号员工号
    C 端抖音用户
    接收小程序主动私信的用户。C 端抖音用户必须在抖音端内主动私信授权页面点击同意授权后,经营者才能向 C 端抖音用户发送主动私信消息。
    说明
    在某些场景下,小程序开发者和小程序经营者可能对应为同一人。

    小程序发送主动私信版本接入

    开发流程

      1.申请和开通前置能力。
      a.小程序上线后系统自动开通发送私信能力。
      b.小程序需配置 Webhook 回调地址,并订阅 IM 主动授权事件。
      2.小程序经营者需在小程序控制台的小程序-设置-关联设置中授权小程序发送私信能力。
        小程序经营者的 OpenID 可以通过控制台-能力-私信和群聊-私信管理授权用户详情页获取。
      3.小程序接入获取用户私信授权能力的 button 组件。
        小程序中接入 button组件获取用户私信授权
        C 端用户点击确认按钮时,会触发IM主动授权事件
      4.小程序调用 OpenAPI 接口发送主动私信。
        收到 IM 主动授权事件后,小程序应调用发送私信消息接口,scene 值传入 im_authorize_message。

    Runtime 时序图

    主动私信授权记录查询

    小程序可对授权小程序经营者向自己发送主动私信的 C 端抖音用户进行查询。