管理企业号的私信

本文介绍了使用 Business Messaging API 接收和回复消息、管理对话以及处理私信中的媒体文件的具体步骤。

简介

管理企业号的私信是 Business Messaging API 的一个核心功能，使企业能够与 TikTok 用户高效互动。

您可以使用 Business Messaging API 自动处理消息，检索对话记录，并高效管理媒体文件，从而简化沟通。这些功能帮助企业提供及时回复，保持对话井然有序，为用户提供流畅的消息体验。

前提条件

• 您已经拥有 TikTok API for Business 的使用权限。详见快速入门 - 具体步骤 。
• 若要管理企业号的私信，您需要获取相关的权限。参阅 API 参考了解使用相关接口（包括“步骤”部分列出的接口）所需的权限，以及参阅更新应用权限了解如何设置权限。
• 您已遵循了 Authorization （网站语言需为英文）和 Authentication （网站语言需为英文）中的步骤获取了 TikTok 账号访问令牌以及 TikTok 账号对应的应用唯一 ID。

步骤

接收消息

• 当 TikTok 用户向企业发送消息时，您将收到一个 Webhook 通知。
• TikTok 用户的初始消息将触发一个对话事件，并生成一个唯一的 conversation_id。

回复消息

• 您可以通过使用 Webhook 通知中提供的 conversation_id 调用 /business/message/send/ （网站语言需为英文）来回复 TikTok 用户。
• 支持发送的消息类型包括：
• 文本消息。
• 图片消息。
• 消息模板，包括：
  • 问答按钮卡片：卡片上展示一个问题和代表问题答案的按钮。用户点击其中一个按钮后，按钮的文本内容将作为预设问题的答案发送至对话中。
    
  • 问答文字链卡片：卡片上展示一个问题和代表问题答案的交互式文本链接。用户点击其中一个文本链接后，文本链接的文本内容将作为预设问题的答案发送至对话中。
    
• TikTok 帖子消息。
• 消息会话中的发送方操作，例如：
  • 正在输入：消息发送方在准备回复。在消息窗口中会显示一个“正在输入”（Typing）的图标，五秒后自动消失。
  • 标为已读：消息发送方将会话中的所有消息标记为已读，已读消息会显示“已看过”（Seen）的图标。

注意
- 禁止主动发起对话或向任何未开始与您对话的 TikTok 用户发送消息。 - 在接收到来自 TikTok 用户的消息后 48 小时内，您可以向该用户发送最多 10 条消息。例如，如果您接收到 TikTok 用户的消息 A，则可以在接下来 48 小时内发送最多 10 条消息。如果同一用户随后发送消息 B，则会开始新的 48 小时窗口，您可以再次向该用户发送 10 条消息。

管理对话

• 您可以通过调用 /business/message/conversation/list/ （网站语言需为英文）来检索对话列表，该接口返回最多 100 条对话记录。
• 若要获取某个对话中的消息列表，可以使用相关 conversation_id 调用 /business/message/content/list/（网站语言需为英文）。该接口支持获取最近的 20 条消息。

处理媒体文件

• 发送图片：

  • 1. 使用 /business/message/media/upload/ （网站语言需为英文）上传图片。一旦上传成功，将返回 media_id。

       注意
       - media_id 有效期为 30 天。媒体 ID 过期后，您需要重新上传图片以获取新的媒体 ID。 - 仅当图片附件的发送方和接收方均位于支持私信中使用图片附件的国家时，支持通过 API 发送和接收图片附件。部分市场不支持分享图片。

  • 2. 将返回的 media_id 传入 /business/message/send/ （网站语言需为英文）中的 media_id，以向用户发送图片消息。

• 下载图片：

  • 使用 /business/message/media/download/ （网站语言需为英文），传入 media_id、message_id 和 conversation_id 参数。接口将返回一个 download_url，以便下载该图片。