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