话题概述
在飞书聊天中，消息可以以话题形式进行展示。本文将介绍什么是话题，以及话题相关的 OpenAPI 能力有哪些。
Note 更多关于话题的信息，参见如何使用话题回复。
什么是话题
话题是消息形式的一种，与普通消息的对比如下表所示。相较于普通消息，话题的特征在于：
- 聚焦讨论： 沟通和讨论变得高效且聚焦，你可以在话题中充分了解上下文信息，无需翻找群聊天记录。
- 减少打扰： 不关心讨论主题的成员不会收到通知提醒，有效减少打扰，提升信息流转效率。
| 消息形式 | 示例 | 特点 |
|---|---|---|
| 话题 |  | 所有消息讨论聚合在该话题的回复中 |
| 消息 |  | 每条消息平铺展示 |
话题 ID 说明
话题拥有在当前租户内唯一的 ID（即 thread_id）。thread_id 的格式是以 omt_ 开头的字符串，例如：omt_d4be107c616a。使用话题 ID 可实现：
如何获取 thread_id
方式二：在消息形式群中，调用回复消息接口，传入
"reply_in_thread": "true"参数值（即以话题形式进行回复）， 从响应的结果中获取thread_id参数值。方式三：监听接收消息事件，若消息为话题消息，可从事件体中获得话题消息的
thread_id。
应用场景
话题的典型应用场景如下表。
| 场景 | 说明 |
|---|---|
| 将某一消息创建为话题 | 如下图所示，在飞书群聊中将某一消息创建为话题并回复。  创建话题效果如下图。所有讨论都会聚合在该话题回复中，不再打扰群内其他成员。  |
| 使用话题形式群 | 如果你希望创建一个“产品反馈收集群”、“销售经验分享群”、“工单信息同步群”等群组来保持相关人员信息同步，则可以把群聊的消息形式设置为话题消息，这样群里的所有消息都会以话题的方式发送出来，所有回复只能在某一话题内进行回复。  典型场景： 在工单管理场景中，可通过话题群沉淀每个工单的信息讨论。每个话题对应一个工单信息，支持通过接口将工单信息发送到话题模式群中，工单的上下文讨论围绕话题展开。 同理，在项目管理、内容管理、用户反馈收集讨论等场景中，通过话题管理每一个项目、内容、反馈信息可以让讨论更聚焦。 |
话题相关的 API 操作
| 操作 | 说明 |
|---|---|
| 将群设为话题形式群 | - 创建群：调用该接口创建群时，填写参数 "group_message_type": "thread"（表示群消息类型为话题消息），可创建一个话题形式群。 - 更新群信息：调用该接口可将已有的群设置为话题形式，需要填写参数 "group_message_type": "thread"（表示群消息类型为话题消息）。 |
| 查询群消息形式 | 调用获取群信息接口，响应体参数 group_message_type 取值为 thread 则表示该群为话题形式群。若未返回 group_message_type 字段，则说明该群聊暂不支持设置群消息形式。 |
| 以话题的方式进行回复（即创建话题） | 调用回复消息接口时，填写参数 "reply_in_thread": "true"（表示以话题形式回复）。 |
| 转发、合并转发 | - 转发话题：该接口可以转发一个话题到其他会话里。 - 转发消息：该接口可以将一条消息转发到话题里，调用时需要填写参数 "receive_id_type"： "thread_id"（表示转发目标为话题）。 - 合并转发消息：该接口可以合并转发多条消息到话题里，调用时需要填写参数 "receive_id_type"： "thread_id"（表示转发目标为话题）。 |
| 查询话题信息 | - 获取会话历史消息：调用该接口时填写参数 "container_id_type": "thread"（表示查询的是话题）并在 container_id 中填写话题 ID（thread_id），即可分页获取话题中的所有消息。 - 获取话题模式群中的所有消息： 1. 调用获取会话历史消息接口，填写参数 "container_id_type": "chat"（表示查询的单聊和群聊）并在 container_id 中填写群 ID（chat_id），即可分页获取群聊中的所有根消息。 2. 根据上一步中获取到的每一条话题根消息（消息资源中存在 thread_id 字段），再次调用获取会话历史消息接口，填写参数 "container_id_type": "thread"（表示查询的是话题）并在 container_id 中填写话题 ID（thread_id），即可分页获取该话题中的所有消息。 |
| 事件通知 | 应用可以订阅群配置修改事件，该事件会在监听到群消息形式（消息形式 & 话题形式）发生改变时，向目标服务器发送事件数据，事件数据内会包括群消息形式信息（group_message_type 参数） |
常见问题
Q：话题可见性是怎么样的？
若群聊关闭了 新成员可查看历史消息，且话题是在查看者进入群聊前创建的，则该话题需要查看者被动订阅才可见。例如，群内其他用户在话题中 @查看者，即可被动订阅话题。
Q：话题群和话题形式群有什么区别？
话题群是指，在创建群组时直接选择话题群进行创建的群。话题形式群是指，在普通消息群组中将群的消息形式修改为话题消息。
话题群是群模式为话题（即群组 API 中
chat_mode参数取值为topic）的群组。在客户端内的展示形式如下图所示。
话题形式群是指群消息形式为话题消息（即群组 API 中
chat_mode参数取值为group、group_message_type为thread）的普通对话群。 在客户端内的展示形式如下图所示。
前者创建后仅支持发送话题，而后者支持在“对话消息”和“话题消息”两种形式间切换。
Note
- 推荐使用话题形式群。
- 创建群接口仅支持创建普通对话群，在设置时可指定群消息形式。