​能力介绍​

​本能力当前为能力实验室能力，可能会有回收或能力开放范围调整，具体能力说明可在开发者后台控制台-能力实验室中查看详细说明。​

​本能力为小程序版本的主动私信能力，小程序开发者可以根据本文档所指引的流程自助接入。​

•​需要注意，小程序开发者仅能代替已经绑定的「小程序经营用户」发送主动私信，推送的对象需要完成对发送账号主动私信授权，参考主动私信授权组件文档；​

•​除此之外，我们强烈建议 已经接入原主动私信（30天内可发送3条消息）能力的开发者参考文档升级发送接口，无需重新授权可直接使用持续触达能力（每日1次，至多 3 条）；​

​重要概念​

​产品优势​

•​公转私入口/组件持续拓展，支持免研配置​

◦​除小程序内自研button组件外，近期平台上线了免研私信授权能力（可以在小程序控制台-私信群聊-主动授权私信能力页面免研配置）、私信/群会话发送服务私信授权卡片（互动经营工作台/OpenAPI接入发卡片）、私信/群会话底部快捷入口配置请求私信授权功能（互动经营工作台）等新的公转私入口/组件；​

•​获取对用户的持续触达能力​

◦​针对完成主动私信授权的用户，经营者每日可以发送一次主动私信，每次可发送 1-3条消息，每日可触达已授权用户5000人；​

•​消息触达效率高​

◦​用户收到消息后会依据当前是否打开抖音出站外push或站内push强提醒​

◦​主动私信消息不受【陌生人会话】盒子限制，默认在用户消息页一级列表展示​

◦​主动私信消息会额外展现消息条数至抖音app icon和一级底tab上​

​C端用户路径​

​公转私B端配置方式​

a.​小程序应用通过试运营期（信用分>=80），自动开通主动授权私信能力​

b.​经营者绑定成为小程序品牌号、员工号（直播间进私组件目前限制小程序绑定品牌号）​

c.​小程序自研button组件目前需要品牌号/员工号接受抖音站内信，授权“主动授权私信组件”拉起权限（详见下方自研接入部分说明）​

1.​免研-互动经营工作台​

a.​「私信/群会话页管理→ 底部快捷功能」选择「请求私信授权」​

b.​问候语配置/自动回复配置/服务私信/群消息配置 选择消息类型 = 「请求私信授权卡片」​

2.​免研-小程序控制台​

•​配置地址：控制台-能力-私信和群聊-主动授权私信​

•​支持配置针对不同的访问入口 x 用户行为 x 指定页面的不同授权策略；最多同时开启 20 个；​

◦​支持入口流量场景：支持选择 视频、直播、AD、搜索、个人页；（暂不支持指定视频 ID、roomid、广告ID）；​

3.​自研接入​

a.​小程序内主动授权私信button组件：需要经营者绑定小程序品牌号、员工号，目前需要同时经营者授权主动授权私信组件im.direct_message.bind权限（若账号初次绑定时经营者未授权，可在小程序控制台-关联设置-抖音号管理-品牌号/员工号-修改能力-新增能力选择“主动授权私信组件”）；在每一个小程序内，每一个经营者账号的主动私信授权弹窗，每日对同一用户曝光上限为三次；移除线上的频控策略：用户拒绝 2 次后 7 日不展示；​

b.​发送请求私信授权卡片：小程序应用目前可在主动私信场景发送，后续将持续拓展支持的发消息场景；或可通过自研/服务商提供的消息管理SaaS后台（需作为网站应用申请私信/群管理能力），作为私信问候语/消息回复/主动私信/B2B主动触达/群消息的一类卡片消息内容发送，详见技术文档；品牌号可代员工号发起请求，员工号仅可代自己请求​

​消息触达链路​

​支持发送的消息类型​

•​文字​

•​图片（仅支持互关后发送）​

•​小程序引导卡片、小程序券、小程序主动私信授权卡；​

•​其他类型扩展中，敬请期待​

​开发者接入流程​

​通过小程序开发者后台申请接入能力​

1.​【必须】确保「主动授权私信组件」能力开通​

i.​权限获取条件：小程序通过平台试运营期后默认获得。注：关于小程序试运营期介绍详情请查看小程序试运营说明。​

ii.​能力简介：获取小程序用户的允许主动私信授权，通过button组件形式接入​

iii.​使用说明：需要搭配「小程序私信/群管理」能力使用​

2.​【必须】确保「小程序私信/群管理」能力开通​

i.​权限获取条件：小程序通过平台试运营期后默认获得。注：关于小程序试运营期介绍详情请查看小程序试运营说明。​

ii.​能力简介：用于小程序私信、群管理等基础IM能力的实现​

iii.​使用说明：需要搭配组件使用，如主动授权私信组件、粉丝群组件​

3.​【必须】绑定小程序品牌号/员工号并授权 或 为已绑定的账号赋予「主动授权私信」权益​

i.​申请链路：不涉及申请​

ii.​简介：完成授权后，开发者才可为该经营用户在小程序内获取c端用户授权和后续私信发送​

iii.​使用说明：通过能力实验室开通「主动授权私信组件」能力后，即可配置​

​完成相关能力的开发接入​

1.​【必须】订阅 IM主动授权(im_authorize) webhook​

i.​订阅方式详见下图：​

ii.​查看开发文档​

2.​【必须】主动授权私信button组件​

i.​用途：用于在小程序内拉起用户授权弹窗，用户授权后平台会增加消息库存（经营用户发消息给c端用户）​

ii.​查看开发文档​

3.​【必须】小程序私信接口​

i.​用途：以经营用户身份发送主动私信给已授权的c端用户；​

ii.​查看开发文档​

4.​【可选】上传图片工具​

i.​用途：在使用小程序私信接口时，支持发送图片内容​

ii.​查看开发文档​

5.​【可选】小程序引导卡片​

i.​用途：在使用小程序私信接口时，支持发送小程序卡片​

ii.​查看开发文档​