# 群组常见问题

本文提供群组 OpenAPI 相关的常见问题与解决方案。

## 如何获取群 ID？

群 ID 是指 chat_id，是一个群聊的唯一标识。格式为 `oc_` 开头的字符串，例如：`oc_a0553eda9014c201e6969b478895c230`。你可以通过 API 调试台一键获取群 ID，也可以在调用 API 时从响应结果中获取。具体获取方式参见[群 ID 说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat-id-description)。

## 如何获取单聊（群模式为 p2p 表示单聊）的 ID？

在[发送消息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create)时，如果消息接收者为用户（user_id/open_id/union_id），也会返回 chat_id，使用该类 chat_id [获取群信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/get)时，返回的群模式参数（chat_mode）值为单聊（p2p）。 因此，如果你需要获取机器人与某一用户单聊的 chat_id，可以调用 **发送消息** 接口来获取。

## 搜索用户所在的群列表可以搜索到外部群吗？

调用[搜索对用户或机器人可见的群列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/search)接口可以搜索到外部群。
历史版本的 **搜索用户所在的群列表** 接口不会返回外部群，推荐你使用上述新版本接口。

## 话题群和话题形式群有什么区别？

话题群是指，在创建群组时直接选择话题群进行创建的群。话题形式群是指，在普通消息群组中将群的消息形式修改为话题消息。

- 话题群是群模式为话题（即[群组 API](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/chat/chat-info/intro) 中 `chat_mode` 参数取值为 `topic`）的群组。在客户端内的展示形式如下图所示。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/b77be7c1108bec9eb012640ebc0eb403_JIzyFexCBl.png?height=1582&lazyload=true&maxWidth=600&width=1822)

- 话题形式群是指群消息形式为话题消息（即[群组 API](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/im-v1/chat/chat-info/intro) 中 `chat_mode` 参数取值为 `group`、`group_message_type` 为 `thread`）的普通对话群。 在客户端内的展示形式如下图所示。

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/ca2bdbdfe545f01ca330ed40cc762914_BjBEMc8Hui.png?height=1590&lazyload=true&maxWidth=600&width=1832)

前者创建后仅支持发送话题，而后者支持在“对话消息”和“话题消息”两种形式间切换。
- 推荐使用话题形式群。
- [创建群](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/create)接口仅支持创建普通对话群，在设置时可指定群消息形式。

