Douyin ショート ビデオ マトリックス システム - プライベート メッセージ グループ チャット機能のアップグレード

導入

世界最大のショートビデオプラットフォームとして、Douyin のショートビデオマーケティングはブランドプロモーションと製品販売の重要なチャネルとなっています。ユーザーのニーズに応え、マーケティング効果を向上させるために、Douyin ショートビデオ マトリックス システムは継続的にアップグレードおよび最適化され、プライベート メッセージのグループ チャット機能の強化により、マーケティングに新たなブレークスルーがもたらされました。この記事では、Douyin ショート ビデオ マトリックス システムのプライベート メッセージ グループ チャット機能のアップグレードについて詳しく紹介し、読者がその技術的詳細と実際のアプリケーションを理解できるようにします。

アビリティ紹介

この機能は現在、機能ラボの機能であり、機能のオープン範囲のリサイクルまたは調整が行われる可能性があります。特定の機能の説明については、開発者のバックグラウンド コンソール - [マイ アプリ] - [アビリティ管理] - [アビリティ ラボ] で詳細な説明を表示できます。

プライベート メッセージングおよびグループ管理機能は、Douyin および Douyin Express インスタント メッセージングの基本機能に基づいて、Douyin オープン プラットフォームによって提供されるインターフェイスおよびデータ オープン サービスです。承認されたサードパーティ アプリケーションを通じて Douyin を取得および送信するための Douyin のビジネス アカウントをサポートします。メッセージ、グループ メッセージ、およびテキスト、写真、ビデオ、メッセージ カードなどを含むがこれらに限定されないリッチ メディア メッセージ タイプをサポートします。

使用するシーン

Douyin オープン プラットフォームの IM オープン機能に正常にアクセスすると、Douyin でユーザーを効率的に接続し、セッション単位に基づいた関連サービスの編成をサポートできます。

1. メインシーン1：プライベートメッセージシーン
   1. 有効な認証があれば、ユーザーは開発者が構築したアプリケーションを使用してプライベート メッセージ管理を実現し、顧客の受け入れ、プロモーション、変革に優れた仕事をすることができます。
      1. パーソナライズされたメッセージ返信、挨拶、自動返信などをサポートします。開発者は、ビジネスの需要を満たすプライベート メッセージの送受信戦略を構築し、異なるスクリプトと送信時間を設定し、ユーザーの損失を回避し、保持とトランザクションの変換を向上させることができます。
      2. さまざまなメッセージ カードをサポートしています。現在は、投資保持カードとミニ プログラム ガイド カードをサポートしています。将来的には、さまざまな需要シナリオをカバーするさらに多くのスタイル、テンプレート カード、認定されたビジネス コンポーネントをサポートする予定です。
      3. プライベートメッセージを通じてトラフィックを誘導するTikTokミニプログラムをサポートし、豊富なミニプログラムガイドカードを通じてミニプログラムの活動を促進し、資金の再訪問、再購入、保持を促進します。
2. メインシーン2：グループチャットシーン
   1. 有効な認証があれば、ユーザーは開発者が構築したアプリケーションを使用してグループ管理やグループメッセージ送信を実現でき、グループの活動をさらに強化できます。
      1. ファングループの作成をサポート、ファン数の上限は通常のグループよりも高い
      2. グループメッセージ送受信機能により、グループメッセージの内容を柔軟に管理可能
      3. グループオーナーと管理者は、グループエントリーレビュー、グループ通知、グループ昇格、グループ分裂などのより多くの操作ツールを利用できます。グループオーナーの更新された作品とライブブロードキャストコンテンツは、グループ内の自動同期をサポートします。
      4. より効率的なグループ管理をサポートし、グループ構築の効率を向上させ、インターフェイスを通じてパラメータをカスタマイズし、ターゲットを絞ったプロモーションのためにグループの情報とステータスをリアルタイムで取得します。同時に、開発者のカスタム グループしきい値設定を満たすことができるグループ エントリ承認インターフェイス機能もサポートしています。
3. 複数のシナリオにわたる効率的なメッセージ操作をサポート
   1. カード テンプレート管理は、標準化されたミニプログラム ガイダンス カードや保持カード、その他のツールの作成、クエリ、削除をサポートし、シナリオ間の送信をサポートします。
   2. プライベート メッセージ/グループ メッセージ Webhook コールバック イベントおよび許可されたユーザーのフォロー/いいね! イベントを通じて、インタラクティブな行動イベントに基づいて対象ユーザーの識別をサポートし、ターゲット ユーザー グループを蓄積し、手がかり、ユーザー意図タグ、その他の情報を完全にマイニングし、洗練された操作を実現します。 (カスタマイズされたメッセージの送信など)。
4. 複数の機能を組み合わせた応用例
   1. ミニプログラムガイドカードを通じて、オンラインおよびオフラインの相互指導/投資保持、トランザクション変換、インタラクション、トランザクション変換、カスタマイズされたアクティビティ、およびクーポン発行の目標を達成するために、より多くのサービスがミニプログラムで拡張および提示されます。
      1. 例: ブランドは、ミニ プログラムを通じてユーザーにさまざまな認定ストアを表示し (地理的位置情報に基づいて近くの店舗を推奨できます)、店舗活動/特典 (オフライン限定サービス/割引など) を通じてユーザーを店舗に引き付け、提供します。ユーザーの意向を収集するためのワンクリック「店舗予約」機能、ユーザーが店舗に到着した後、「オフラインチェックイン」機能を提供でき、ユーザーがクリックして完了したことを確認した後、関連特典を受け取ることができます。ミニプログラムが提供するアトリビューション機能を通じて店舗を特定できます。チャンネルの手がかり源です。購入を完了した/関心の高いユーザーに対しては、ブランド Douyin のファン グループに参加するよう誘導できます。ファングループを通じてミニプログラムガイダンスカードを送信し、ミニプログラムを通じてトランザクション変換、インタラクション、クーポン発行およびその他の目標を完了します。

能力マップ

注: ユーザー認証が必要なスコープの場合:

1. ユーザーは 1 つのアプリケーション A のみを承認できます。ユーザーが 2 番目のアプリケーション B を承認すると、プラットフォームはユーザーに「B を承認するということは、A の対応する承認をキャンセルすることを意味します」というプロンプトを表示します。
2. 認証方法: Web コード スキャン認証のみをサポートします
3. スコープ認証結果の取得は現在サポートされていません (アップグレード): ユーザー認証が必要なスコープの場合、開発者がコードを取得して/oauth/access_token/インターフェイスを呼び出すと、返されるスコープ パラメーターにはスコープが含まれなくなります。 , unauthorize (unauthorize) Webhook イベントのスコープ パラメーターにもスコープは含まれず、開発者は引き続き access_token を使用してこのインターフェイスを呼び出すことができます。承認されたユーザーは、設定 - アカウントおよびセキュリティ - 承認管理 - 操作承認で承認された IM 機能を表示/キャンセルできます。Douyin オープン プラットフォームは、関連スコープを返す access_token の機能を間もなく完成させます。
4. インターフェイス呼び出しのクォータ: 現時点では、クォータの引き上げまたはクォータの支払いの申請はサポートされていません。特別なニーズがある場合は、手動のカスタマー サービスに転送するか、オンラインを通じて非技術的な作業指示の相談を送信してください。プラットフォームの相談ポータル。長期プラットフォームは、デフォルトの無料割り当てに基づいて認証アカウントをサポートします。プラットフォームの発表にご注意ください。

アビリティ名	scope名	アプリケーションがスコープ許可を申請する必要があるかどうか	ユーザー認証が必要かどうか	ユーザー認可項目	アビリティ紹介	一般的な使用シナリオの紹介
プライベートメッセージの管理	im.direct_message (1日の通話制限:10w)	はい	はい	プライベートメッセージの管理 TikTokプライベートメッセージを送受信する	制限された条件付きのDouyinオペレーターアカウントの場合、開発者によって許可されている場合、開発者のアプリケーションを通じてDouyinプライベートメッセージを送受信することが許可されます。	プライベート メッセージの受信: 端末内の承認された Douyin アカウントによって受信されたすべてのプライベート メッセージ、端末または各アプリケーションによって送信されたすべてのプライベート メッセージを受信でき、メッセージ タイプとアプリケーションが送信するかどうかの区別をサポートします。 プライベート メッセージの返信: ユーザーがメッセージを送信した後、開発者はこのインターフェイスを呼び出して、企業顧客がメッセージに返信できるようにすることができます。 アクティブ タッチ: さらに、ユーザーがプライベート メッセージ セッション ページに入ると、このインターフェイスに基づいてメッセージを送信するイニシアティブをサポートします。
グループメッセージ管理	im.group_message (1日の通話制限:10w)	はい	はい	グループメッセージ管理 Douyin グループ チャット メッセージを送受信する	制限された条件付きのDouyinオペレーターアカウントの場合、承認を条件として、開発者のアプリケーションを通じてDouyinファングループメッセージを送受信することができます。	グループチャットメッセージの受信：端末内の承認されたDouyinアカウントによって受信されたファングループのメッセージ、端末またはさまざまなアプリケーションによって送信されたすべてのメッセージを受信できます グループ メッセージ返信: ユーザーがメッセージを送信した後、開発者はこのインターフェイスを呼び出して、企業顧客がメッセージに返信できるようにすることができます。 グループ メッセージのアクティブな送信: 頻度制御の範囲内で、このインターフェイスに基づいてメッセージをアクティブに送信するためのサポート
ファンベースの管理	im.group_fans.create_list (1日の通話制限:1w)	はい	はい	ファンベースの管理 グループを作成し、 管理グループ	認証の場合、サードパーティ アプリケーションは、ファン グループを作成してグループを管理するための拘束力のあるブランド/従業員番号をオペレーターに提供できます。	グループの作成、レビュー、作業の同期、ライブルームの同期など。
対象となるユーザーの識別	ユーザーの意図 (1日の通話制限:1w)	はい	はい	プライベートメッセージの管理 イベントを「いいね」/フォローする	承認があれば、サードパーティ アプリケーションは IM を通じてオペレーターと対話したユーザーのリストを取得できます。	IM インタラクション動作に基づくコールバック イベントや、承認されたユーザーの「いいね！」/フォロー イベントは、対象ユーザーを誘導し、情報送信やインタラクションの実装などをカスタマイズするために使用できます。
メッセージカードの管理	im.メッセージカード (1日の通話制限:1w)	いいえ	はい	メッセージカードの管理 メッセージカードの作成、クエリ、削除	限られた条件付きのDouyinオペレーターアカウントの場合、承認の条件下で、開発者のアプリケーションを介してプライベートメッセージおよびグループチャットセッションでメッセージカードを送信することが許可されます。	カードの種類: 今回は資本保持カードが最初に開始され、将来的にはグループ チャットへの招待、エンタープライズ アカウントへの電話など、より多くの認可されたビジネス コンポーネントがサポートされる予定です。
小さな番組ガイドカード	im.microapp_card (1日の通話制限:1w)	いいえ	いいえ	-	プライベートメッセージ/グループチャットページで大きな写真、小さなプログラム/ミニゲーム(空でも可)、タイトル、コピーライティングなどの情報を送信し、小さなプログラム/Douyinの他のページにジャンプするようにユーザーを誘導します
プライベートメッセージ/グループメッセージの取り消し	im.recall_message (1日の通話制限:1w)	いいえ	はい	メッセージの取り消し管理 プライベートメッセージとグループチャットメッセージを取り消す	限定条件付きのDouyinオペレーターアカウントの場合、承認された条件の下で、開発者のアプリケーションを通じて自分で送信したプライベートメッセージ/グループメッセージを取り消すことができます。	-
画像アップロードツール	ツール.イメージ.アップロード (1日の通話制限:1w)	いいえ	いいえ	-	media_id と引き換えに画像 URL をアップロードします。プライベート メッセージ/グループ メッセージ送信インターフェイスに使用できます。	プライベート メッセージ/グループ メッセージで写真を送信する: 最初に写真をアップロードし、写真の media_id を取得して、メッセージ送信インターフェイスを通じて送信する必要があります。

アクセス要件

Douyin のオペレータ アカウントがサードパーティ アプリケーションを通じて Douyin プライベート メッセージとグループ メッセージを取得および送信するには、「サードパーティ アプリケーション」と「オペレータの Douyin アカウント」が次の条件を満たす必要があります。

サードパーティによる使用

アビリティの入力条件は以下のとおりです。

1. アプリケーションはDouyinオープンプラットフォームに入り、「公式アプリケーション」としてリリースされました
2. アプリケーションの種類は「モバイル アプリケーション」または「Web アプリケーション」です
3. 应用须为面向经营者的ToB SaaS，功能模块以“互动管理（私信/群/评论等）”为主（ToC类应用、内容创作工具类应用暂不做准入）

同时，对于实验室能力，平台保留定期对应用进行走查、回收能力的权限。可能回收能力的原因，包括不限于：

1. 接入3个月内，scope下的OpenAPI日均调用OpenID数未达到100；若应用触发能力回收条件，平台可能通过站内信触达开发者提醒，30天后若仍未达标，则进行能力回收；开发者如有特殊原因希望保留，可通过平台首页客服入口转人工客服提交工单申请
2. 发现应用绕过平台风控规则，或存在不符合抖音开放平台运营规范的行为，平台可能通知开发者同时、即刻回收相关权限

经营者抖音号

当前准入条件：小程序品牌号及员工号、认证企业号及其员工号；后续将逐步拓展能力开放的经营者范围。

特殊说明

1. 本功能是平台为开发者提供的实验室能力，平台有权利根据法律法规变更、自身业务调整等原因，修改/关闭功能，或变更功能的开放范围。
2. 若对本文档所述能力有疑问，请通过抖音开放平台首页-在线咨询提交技术工单，或键入“转人工”咨询人工客服，相关问题将流转至开放能力建设团队值班同学

接入流程

接入前准备

应用入驻

• 开发者需要入驻抖音开放平台，创建一个以消息管理为核心功能场景之一的网站应用，获取应用clientkey

接入抖音授权

• 目前消息管理相关能力仅支持web扫码授权

能力申请

开发者可在抖音开放平台“控制台-能力管理-能力实验室”中申请，具体步骤见下图：

步骤	能力申请步骤描述
1	在抖音开放平台“控制台-能力管理-能力实验室”中找到“私信/群消息管理”能力，点击“申请开通”
2	选择需要开通的功能（scopes），并填写&提交申请材料 注意事项： 私信/群消息管理能力下scopes支持同时申请多个，但最终准入为scope粒度，可能存在部分scope申请通过、部分未通过的情况；开发者如判断未通过功能必要，可重新提交材料继续申请； 申请信息及材料请务必按照规则要求完整填写&提交，若材料不完整或信息不符合要求，审核默认不通过
3	等待审核通过； 注意事项：能力上线初期，各项准入标准仍在持续完善中，申请量大且人工审核成本高，暂定审核周期在7个工作日左右，请开发者耐心等待

各能力使用步骤及规则详解

私信管理

步骤	能力使用步骤描述
1	请求用户授权抖音私信消息收发 增加授权项：开发者需要先在合适的场景及实际，引导用户进行「私信消息管理」能力的授权； 在应用内提供拉起抖音web授权页面的入口，并引导用户打开抖音，扫码完成授权； 用户账号身份校验：当开发者申请的授权项包含「私信消息管理」时，抖音会自动校验该用户账号身份是否满足授权条件；当用户账号身份不满足条件时，授权失败（后续会在redict_url中提示授权失败的scopes，需求流程中） 是否支持授权多应用：否；仅支持一个用户授权一个应用「私信消息管理」权限 用户账号身份不满足条件： 用户账号身份满足条件：
2	使用限制 场景一：默认仅支持消息回复 仅支持消息回复，需要开发者前置订阅“收到私信消息事件”，从 webhook 解析出 msg_id 字段，时效为 24小时。 仅支持消息回复，在用户未发送下一条消息前，24小时内可向用户发送 6条 消息 默认支持的消息类型：文字、图片、授权账户自己投稿的公开视频（须通过video.list.bind请求用户授权）；消息卡片须在获取「消息卡片管理 im.message_card」「小程序引导卡片 im.microapp_card」权限后，遵循相关卡片创建/审核/内容规则进行消息发送 非互关时，不支持图片和视频消息（同app内发消息），接口在文字消息基础上，额外支持了“非互关发送消息卡片”能力 最新规则以抖音 app 内发送消息为准，小程序经营身份可参考小程序平台对外公告，企业号可参考企业号/企业员工号的私信规则（可对外） 场景二：用户主动进入私信会话页 需要开发者订阅“用户进入私信会话页webhook能力”，从 webhook 解析出相关字段，同时调用本接口时 scene 字段要传 im_enter_direct_msg 在接收到用户进入私信会话页事件 30s 内，可使用该接口发送消息，单次可发最多 3条 消息，单日最多 3次，两次发送时间需间隔 1小时 以上（最新规则以抖音 app 内发送消息为准） 调用本接口时 scene 字段需传入 im_enter_direct_msg 需要开发者订阅“用户进入私信会话页webhook能力”，从 webhook 解析 conversation_short_id 字段 用户每次进入会话页触发接收用户进入会话页事件 webhook 开发者需要在接收用户进入私信会话页事件 webhook 30 秒内，调用本接口发送消息 对于每条接收用户进入会话页 webhook，开发者最多可以调用 3 次本接口，发送 3 条消息；单日最多回复 3 条 webhook （单日总计可向同一用户发送 1 - 9 条消息） 两次回复 webhook 的时间间隔需在 1 小时以上 最新规则以抖音 app 内发送消息为准
3	消息发送成功后，用户侧接收消息 消息审核&风控：消息内容会通过抖音内容审核&反作弊校验，若出现违规，则可能被自见；对用户举报、极端作弊case，可能导致抖音经营者（授权使用开发者应用的账号）账号封禁、开发者应用权限收回等处罚；因此，开发者有义务监管使用其服务的抖音用户合规使用抖音消息收发能力 App内展现：消息发送成功后，将在用户的抖音/抖音极速版app私信会话页内展现 私信会话页hint提示：

群消息管理

步骤	能力使用步骤描述
1	请求用户授权抖音群消息收发 增加授权项：开发者需要先在合适的场景及实际，引导用户进行「群消息管理」能力的授权； 在应用内提供拉起抖音web授权页面的入口，并引导用户打开抖音，扫码完成授权； 用户账号身份校验：当开发者申请的授权项包含「群消息管理」时，抖音会自动校验该用户账号身份是否满足授权条件；当用户账号身份不满足条件时，授权失败（后续会在redict_url中提示授权失败的scopes，需求流程中） 是否支持授权多应用：否；仅支持一个用户授权一个应用「群消息管理」权限 用户账号身份不满足条件： 用户账号身份满足条件：
2	接收粉丝群消息 获取方式：订阅群消息回调事件 群聊消息事件：订阅此事件可获取该授权用户创建的粉丝群内产生的所有消息
2-1	调用接口发送抖音粉丝群消息限制 默认支持的消息类型：文字、图片、授权账户自己投稿的公开视频（须通过video.list.bind请求用户授权）；消息卡片须在获取「消息卡片管理 im.message_card」「小程序引导卡片 im.microapp_card」权限后，遵循相关卡片创建/审核/内容规则进行消息发送
3	消息发送成功后 消息审核&风控：消息内容会通过抖音内容审核&反作弊校验，若出现违规，则可能被自见；对用户举报、极端作弊case，可能导致抖音经营者（授权使用开发者应用的账号）账号封禁、开发者应用权限收回等处罚 App内展现：消息发送成功后，将在用户的抖音/抖音极速版app粉丝群会话内展现 进入群聊会话页notice提示：“为提供更好的服务，群主可能使用第三方工具管理群聊信息”

消息&卡片类型使用规范

卡片类型	使用规范	样式
文本消息	建议字数<100，具体以抖音app内规则为准，接口侧无额外限制	-
图片消息	需通过tool.image.upload上传图片url换取media_id来发送；基于用户隐私&风控策略考量，当前图片消息暂不支持webhook下载，需到抖音app端查看	-
视频消息	仅支持授权账户自己投稿的公开视频（须通过video.list.bind请求用户授权）	-
小程序引导卡片 需获取im.microapp_card权限；无需用户授权	同一小程序，可以配置多张小程序引导卡片模板，调用限制为近 30 天可创建 / 更新小程序引导卡片模板 100 次 跳转能力：仅支持跳转小程序，可跳转小程序任意页面；两种实现方式： 方案一：传appid+query+path：发消息接口直接传入，无需提前生成 方案二：传schema+app_id：「schema」生成方式： 通过接口生成 Generate 在小程序界面点击右上角 ... > 分享 > 复制链接 注：平台将对小程序跳转链接合法性进行校验，不合法链接会导致消息发送失败
留资卡片 需获取im.message_card权限；需要用户授权	默认可配置字段：姓名、城市、手机号（最少选1个） 当前行业定制字段仅支持“意向车系”，其他行业暂无特定字段

接口列表

OpenAPI 列表

请求域名 抖音开放平台

产品能力	OpenAPI	描述	对应Scope权限	权限名	是否需要用户授权
私信管理	发送私信 API 接口	发送抖音私信消息	im.direct_message	私信消息管理：接收和发送抖音私信消息	是
群消息管理	发送群消息 API 接口	发送抖音群聊消息	im.group_message	グループ メッセージ管理: Douyin グループ チャット メッセージの送受信	はい
ファンベースの管理	グループ情報のクエリ	グループ情報のクエリ	im.group_fans.create_list	Douyin アカウントのファン グループを作成し、アプリを承認することでグループ情報をクエリできます。	はい
	ファングループを作成する	ファングループを作成する	im.group_fans.create_list	Douyin アカウントのファン グループを作成し、アプリを承認することでグループ情報をクエリできます。	はい
	ユーザーの残りのグループ構築クォータを照会します。	ユーザーの残りのグループ構築クォータを照会します。	im.group_fans.create_list	Douyin アカウントのファン グループを作成し、アプリを承認することでグループ情報をクエリできます。	はい
	グループ所有者のグループ内のユーザーのグループ申請状況を問い合わせます	グループ所有者のグループ内のユーザーのグループ申請状況を問い合わせます	im.group_fans.create_list	Douyin アカウントのファン グループを作成し、アプリを承認することでグループ情報をクエリできます。	はい
対象となるユーザーの識別	インタラクティブなユーザーレコードクエリ	インタラクティブなユーザーレコードクエリ	ユーザーの意図	対象となるユーザー管理	はい
メッセージカードの管理	保持カードの作成/更新	保持カードの作成/更新	im.メッセージカード	メッセージカードの管理	はい
	クエリ保持カード	クエリ保持カード	im.メッセージカード	メッセージカードの管理	はい
	カードを削除する	カードを削除する	im.メッセージカード	メッセージカードの管理	はい
小さな番組ガイドカード	ミニ プログラム ブートストラップ カード テンプレートの作成/更新	ミニ番組ガイドカードテンプレートの作成/変更	im.microapp_card	ミニ番組ガイドカードテンプレート管理	いいえ
	クエリ ミニ プログラム ガイダンス カード テンプレート	クエリ ミニ プログラム ガイダンス カード テンプレート	im.microapp_card	ミニ番組ガイドカードテンプレート管理	いいえ
	ミニ番組ガイド カード テンプレートの削除	ミニ番組ガイド カード テンプレートの削除	im.microapp_card	ミニ番組ガイドカードテンプレート管理	いいえ
プライベートメッセージ/グループメッセージの取り消し	メッセージ取り消しAPIインターフェース	プライベートメッセージとグループチャットメッセージを取り消す	im.recall_message	メッセージの取り消し管理	はい
画像アップロードツール	写真をアップロードする	画像アップロードツール	ツール.イメージ.アップロード	画像をアップロードする	いいえ

Webhook イベントのサブスクリプション