主动私信
收藏能力介绍
说明
本能力当前为能力实验室能力，可能会有回收或能力开放范围调整，具体能力说明可在开发者后台控制台-能力实验室中查看详细说明。
本能力为小程序版本的主动私信能力，小程序开发者可以根据本文档所指引的流程自助接入。
通过小程序主动私信能力，开发者可以主动给抖音用户发送抖音私信，用户消息体验与接收抖音私信一致，该消息将直接在用户的消息列表展示并拥有私信的全部通知能力。
- •需要注意，小程序开发者仅能代替已经绑定的「小程序经营用户」发送主动私信，推送的对象需要完成对发送账号主动私信授权，参考主动私信授权组件文档。
- •除此之外，我们强烈建议 已经接入原主动私信（30 天内可发送3条消息）能力的开发者参考文档升级发送接口，无需重新授权可直接使用持续触达能力（每日1次，至多 3 条）。
重要概念
在小程序运营的场景下，抖音用户可分为两类：小程序经营用户和抖音 C 端用户。
抖音用户 | 小程序主动私信能力 | 公转私 |
小程序经营用户： 指小程序开发者授权绑定的抖音用户，会在小程序各类经营场景下校验身份。 绑定路径： 通过「小程序开发者后台-设置-关联设置」绑定的品牌号、员工号。 特殊说明： 使用本能力需要在绑定时配置「主动授权私信」权益。 抖音 C 端用户： 泛指小程序触达和希望转化的目标用户。 | 定义： C 端用户授权后，小程序开发者可以通过经营用户抖音号发送主动私信给 C 端用户 。 能力组成：
| 定义： 指通过公域流量入口引导用户授权私信服务后，经营者获得每日可稳定、持续触达用户的权限，此用户实际上沉淀为经营者私域用户，可作为抖音经营的重要转化目标之一。 公转私入口/组件：
|
产品优势
- •公转私入口/组件持续拓展，支持免研配置
除小程序内自研 button 组件外，近期平台上线了免研私信授权能力（可以在小程序控制台-私信群聊-主动授权私信能力页面免研配置）、私信/群会话发送服务私信授权卡片（互动经营工作台/OpenAPI接入发卡片）、私信/群会话底部快捷入口配置请求私信授权功能（互动经营工作台）等新的公转私入口/组件。
- •获取对用户的持续触达能力
针对完成主动私信授权的用户，经营者每日可以发送一次主动私信，每次可发送 1~3 条消息，每日可触达已授权用户5000人。
- •消息触达效率高
- ◦用户收到消息后会依据当前是否打开抖音出站外 push 或站内 push 强提醒。
- ◦主动私信消息不受【陌生人会话】盒子限制，默认在用户消息页一级列表展示。
- ◦主动私信消息会额外展现消息条数至抖音 App icon 和一级底 tab 上。
C 端用户路径
公转私入口/组件 | 主动私信授权弹窗，同意授权 | 消息通知 | 收到主动私信 | 私信会话页提示 | |
会话内：快捷入口/服务私信授权卡片 直播间：直播间进入小程序悬浮组件/直播货架固定入口 | | ||||
支持会话内、直播间、小程序内获取用户主动私信授权 | 发送消息会扣除消息库存 | 会话不折叠 | 支持发送多种消息类型 | ||
公转私 B 端配置方式
接入前提
- 1.小程序应用通过试运营期（信用分 >= 80），自动开通主动授权私信能力。
- 3.小程序自研 button 组件目前需要品牌号/员工号接受抖音站内信，授权“主动授权私信组件”拉起权限（详见下方自研接入部分说明）。
接入方式
免研-互动经营工作台
- 1.「私信/群会话页管理→ 底部快捷功能」选择「请求私信授权」。
- 2.问候语配置/自动回复配置/服务私信/群消息配置 选择消息类型 = 「请求私信授权卡片」。
免研-小程序控制台
- •配置地址：控制台-能力-私信和群聊-主动授权私信。
- •支持配置针对不同的访问入口 x 用户行为 x 指定页面的不同授权策略；最多同时开启 20 个。
- •支持入口流量场景：支持选择 视频、直播、AD、搜索、个人页；（暂不支持指定视频 ID、roomid、广告ID）；
自研接入
- 1.小程序内主动授权私信button组件：需要经营者绑定小程序品牌号、员工号，目前需要同时经营者授权主动授权私信组件im.direct_message.bind权限（若账号初次绑定时经营者未授权，可在小程序控制台-关联设置-抖音号管理-品牌号/员工号-修改能力-新增能力选择“主动授权私信组件”）；在每一个小程序内，每一个经营者账号的主动私信授权弹窗，每日对同一用户曝光上限为三次；移除线上的频控策略：用户拒绝 2 次后 7 日不展示；
消息触达链路
支持发送的消息类型
- •文字
- •图片（仅支持互关后发送）
- •小程序引导卡片、小程序券、小程序主 动私信授权卡；
- •其他类型扩展中，敬请期待
开发者接入流程
通过小程序开发者后台申请接入能力
- 1.【必须】确保「主动授权私信组件」能力开通。
- a.权限获取条件：小程序通过平台试运营期后默认获得。注：关于小程序试运营期介绍详情请查看小程序试运营说明。
- b.能力简介：获取小程序用户的允许主动私信授权，通过button组件形式接入
- c.使用说明：需要搭配「小程序私信/群管理」能力使用
- 2.【必须】确保「小程序私信/群管理」能力开通
- a.权限获取条件：小程序通过平台试运营期后默认获得。注：关于小程序试运营期介绍详情请查看小程序试运营说明。
- b.能力简介：用于小程序私信、群管理等基础IM能力的实现
- c.使用说明：需要搭配组件使用，如主动授权私信组件、粉丝群组件
- 3.【必须】绑定小程序品牌号/员工号并授权 或 为已绑定的账号赋予「主动授权私信」权益
- a. 申请链路：不涉及申请
- b.简介：完成授权后，开发者才可为该经营用户在小程序内获取c端用户授权和后续私信发送
- c.使用说明：通过能力实验室开通「主动授权私信组件」能力后，即可配置
完成相关能力的开发接入
- 1.【必须】订阅 IM主动授权(im_authorize) webhook
- a.订阅方式详见下图：
- b.查看开发文档
- 2.【必须】主动授权私信button组件
- a.用途：用于在小程序内拉起用户授权弹窗，用户授权后平台会增加消息库存（经营用户发消息给c端用户）
- b.查看开发文档
- 3.【必须】小程序私信接口
- a.用途：以经营用户身份发送主动私信给已授权的c端用户；
- b.查看开发文档
- 4.【可选】上传图片工具
- a.用途：在使用小程序私信接口时，支持发送图片内容
- b.查看开发文档
- 5.【可选】小 程序引导卡片
- a.用途：在使用小程序私信接口时，支持发送小程序卡片
- b.查看开发文档
