Skip to content

群组常见问题

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

如何获取群 ID?

群 ID 是指 chat_id,是一个群聊的唯一标识。格式为 oc_ 开头的字符串,例如:oc_a0553eda9014c201e6969b478895c230。你可以通过 API 调试台一键获取群 ID,也可以在调用 API 时从响应结果中获取。具体获取方式参见群 ID 说明

如何获取单聊(群模式为 p2p 表示单聊)的 ID?

发送消息时,如果消息接收者为用户(user_id/open_id/union_id),也会返回 chat_id,使用该类 chat_id 获取群信息时,返回的群模式参数(chat_mode)值为单聊(p2p)。 因此,如果你需要获取机器人与某一用户单聊的 chat_id,可以调用 发送消息 接口来获取。

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

调用搜索对用户或机器人可见的群列表接口可以搜索到外部群。

Note 历史版本的 搜索用户所在的群列表 接口不会返回外部群,推荐你使用上述新版本接口。

话题群和话题形式群有什么区别?

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

  • 话题群是群模式为话题(即群组 APIchat_mode 参数取值为 topic)的群组。在客户端内的展示形式如下图所示。

    image.png

  • 话题形式群是指群消息形式为话题消息(即群组 APIchat_mode 参数取值为 groupgroup_message_typethread)的普通对话群。 在客户端内的展示形式如下图所示。

    image.png

前者创建后仅支持发送话题,而后者支持在“对话消息”和“话题消息”两种形式间切换。

Note

  • 推荐使用话题形式群。
  • 创建群接口仅支持创建普通对话群,在设置时可指定群消息形式。

内容来源:飞书开放平台 · 自动爬取整理