抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 经营账号
  • 小程序营销能力
  • 小程序异形卡
  • 账号运营
  • 抖音视频
  • 引导跳转到直播间
  • 私域消息
  • 订阅消息
  • 主动私信
  • 客服消息
  • 互动经营工作台
  • 流量来源识别
  • 设置关联城市
  • 抖音经营任务
  • 主动私信

    收藏
    我的收藏

    能力介绍

    通过小程序主动私信能力,开发者可以主动给抖音用户发送抖音私信,用户消息体验与接收抖音私信一致,该消息将直接在用户的消息列表展示并拥有私信的全部通知能力。
    需要注意,小程序开发者仅能代替已经绑定的「小程序经营用户」发送主动私信,推送的对象需要完成对发送账号主动私信授权,参考主动私信授权组件文档
    除此之外,平台建议已经接入原主动私信(30 天内可发送 3 条消息)能力的开发者升级发送私信消息接口,无需重新授权可直接使用持续触达能力(每日 1 次,至多 3 条)。

    重要概念

    抖音用户

    在小程序运营的场景下,抖音用户可分为两类:小程序经营用户和抖音 C 端用户。
      小程序经营用户:指小程序开发者授权绑定的抖音用户,会在小程序各类经营场景下校验身份。
      特殊说明:使用本能力需要在绑定时配置「主动授权私信」权益。
      抖音 C 端用户:泛指小程序触达和希望转化的目标用户。

    小程序主动私信能力

    C 端用户授权后,小程序开发者可以通过经营用户抖音号发送主动私信给 C 端用户。
    能力组成:
      1.用户私信授权:小程序内 button 组件,用户点击后调起授权弹窗,授权成功增加消息库存。
      2.主动私信发送:在有库存的前提下,可以发送消息。

    公转私

    指通过公域流量入口引导用户授权私信服务后,经营者获得每日可稳定、持续触达用户的权限,此用户实际上沉淀为经营者私域用户,可作为抖音经营的重要转化目标之一。
    公转私入口/组件:
      1.小程序内自研 button组件。
      2.官方免研私信授权组件。
      3.私信/群会话发送服务私信授权卡片 。
      4.私信/群会话底部快捷入口配置请求私信授权功能 。

    产品优势

    优势
    说明
    公转私入口/组件持续拓展,支持免研配置
    小程序内自研 button 组件外,平台支持以下新的公转私入口/组件:
      免研私信授权能力(可以在小程序控制台-私信群聊-主动授权私信能力页面免研配置)
      私信/群会话发送服务私信授权卡片(OpenAPI接入发卡片)
      私信/群会话底部快捷入口配置请求私信授权功能
    获取对用户的持续触达能力
    针对完成主动私信授权的用户,经营者每日可以发送一次主动私信,每次可发送 1~3 条消息,每日可触达已授权用户 5000 人。
    消息触达效率高
      用户收到消息后会依据当前是否打开抖音出站外 push 或站内 push 强提醒。
      主动私信消息不受【陌生人会话】盒子限制,默认在用户消息页一级列表展示。
      主动私信消息会额外展现消息条数至抖音 App icon 和一级底 tab 上。

    C 端用户路径

    公转私入口/组件

    支持会话内、直播间、小程序内获取用户主动私信授权。
    开发者亦可通过主动私信授权 button 组件自研接入,自定义样式。
    会话内:快捷入口/服务私信授权卡片
    直播间:直播间进入小程序悬浮组件/直播货架固定入口

    主动私信授权弹窗,同意授权

    消息通知

    发送消息会扣除消息库存。

    收到主动私信

    会话不折叠。

    私信会话页提示

    支持发送多种消息类型。

    公转私 B 端配置方式

    接入前提

      1.需要是已上线企业主体小程序,不支持个人主体小程序使用,需要前往开通控制台-能力-私信群聊页面接入。
      2.经营者绑定成为抖音企业机构账号
      3.小程序自研 button 组件目前需要抖音企业机构账号接受抖音站内信,授权“主动授权私信组件”拉起权限。

    接入方式

    免研-小程序控制台

      配置地址:控制台-能力-私信和群聊-主动授权私信。
      支持配置针对不同的访问入口 x 用户行为 x 指定页面的不同授权策略;最多同时开启 20 个。
      支持入口流量场景:支持选择 视频、直播、AD、搜索、个人页;(暂不支持指定视频 ID、roomid、广告ID);

    自研接入

      1.小程序内主动授权私信 button 组件:需要经营者绑定抖音企业机构账号,目前需要同时经营者授权主动授权私信组件 im.direct_message.bind 权限(若账号初次绑定时经营者未授权,可在小程序控制台-关联设置-抖音号管理-抖音企业机构账号-绑定后授权能力);在每一个小程序内,每一个经营者账号的主动私信授权弹窗,每日对同一用户曝光上限为三次;移除线上的频控策略:用户拒绝 2 次后 7 日不展示。
      2.发送请求私信授权卡片:小程序应用目前可在主动私信场景发送,后续将持续拓展支持的发消息场景;或可通过自研/服务商提供的消息管理SaaS后台,作为私信问候语/消息回复/主动私信/B2B主动触达/群消息的一类卡片消息内容发送。

    消息触达链路

    支持发送的消息类型

      文字
      图片(仅支持互关后发送)
      小程序引导卡片、小程序券、小程序主动私信授权卡;

    开发者接入流程

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

    步骤
    权限获取条件
    能力简介
    使用说明
      1.确保「主动授权私信组件」能力开通。
    企业主体小程序上线
    获取小程序用户的允许主动私信授权,通过 button 组件形式接入。
    需要搭配「小程序私信/群管理」能力使用。
      2.确保「小程序私信/群管理」能力开通。
    企业主体小程序上线
    用于小程序私信、群管理等基础IM能力的实现。
    需要搭配组件使用,如主动授权私信组件、粉丝群组件。
      3.绑定抖音企业机构账号并授权 或 为已绑定的账号赋予「主动私信」能力。
    需要拥有抖音企业机构账号,账号和小程序绑定成功后授权能力
    完成授权后,开发者才可为该经营用户在小程序内获取c端用户授权和后续私信发送
    通过能力实验室开通「主动授权私信组件」能力后,即可配置

    完成相关能力的开发接入

    步骤
    是否必须
    用途
    开发文档
      1.订阅 IM主动授权 (im_authorize) webhook。
    订阅方式详见下图
      2.主动授权私信 button 组件
    用于在小程序内拉起用户授权弹窗,用户授权后平台会增加消息库存(经营用户发消息给 C 端用户)。
      3.小程序私信接口
    以经营用户身份发送主动私信给已授权的 C 端用户。
      4.上传图片工具。
    在使用小程序私信接口时,支持发送图片内容。
      5.小程序引导卡片
    在使用小程序私信接口时,支持发送小程序卡片。