获取客户群详情 - Developer OpenAPI

通过客户群ID，获取详情。包括群名、群成员列表、群成员入群时间、入群方式。（客户群是由具有客户群使用权限的成员创建的外部群）

需注意的是，如果发生群信息变动，会立即收到群变更事件，但是部分信息是异步处理，可能需要等一段时间调此接口才能得到最新结果

权限说明:

企业需要使用“客户联系”secret或配置到“可调用应用”列表中的自建应用secret所获取的accesstoken来调用（accesstoken如何获取？）
第三方应用需具有“企业客户权限->客户基础信息”权限
对于第三方/自建应用，群主必须在应用的可见范围。

文档ID: 19412
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/92122
https://open.work.weixin.qq.com/api/doc/90001/90143/92707

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

chat_id

string

客户群ID

必需

need_name

integer

可选

是否需要返回群成员的名字group_chat.member_list.name。0-不返回；1-返回。默认不返回

示例

{
  "chat_id": "wrOgQhDgAAMYQiS5ol9G7gK9JVAAAA",
  "need_name": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

group_chat

object

客户群详情

可选

owner

string

群主ID

可选

create_time

integer <int32>

群的创建时间

可选

name

string

群名

可选

member_list

array [object {7}]

群成员列表

可选

admin_list

array [object {1}]

群管理员列表

可选

chat_id

string

客户群ID

可选

notice

string

群公告

可选

errmsg

string

可选

对返回码的文本描述内容

示例

{
  "errcode": 0,
  "group_chat": {
    "owner": "string",
    "create_time": 0,
    "name": "string",
    "member_list": [
      {
        "group_nickname": "string",
        "unionid": "string",
        "name": "string",
        "join_scene": 0,
        "type": 0,
        "userid": "string",
        "join_time": 0
      }
    ],
    "admin_list": [
      {
        "userid": "string"
      }
    ],
    "chat_id": "string",
    "notice": "string"
  },
  "errmsg": "string"
}