# 查询客户群详情


```
POST https://qw-openapi-tx.dustess.com/customer/v2/group/detail/get?accessToken=

Content-Type: application/json
```

**接口限制**:每分钟调用600次;

**Query:**

| 字段        | 类型     | 描述        | 是否必须 |
| ----------- | -------- | ----------- | -------- |
| accessToken | `String` | accessToken | 是       |

**请求参数:**

| 字段        | 类型     | 描述        | 是否必须 |
| ----------- | -------- | ----------- | -------- |
| chatId | `String` | 客户群ID | 是       |


请求参数示例:

```json
{
    "chatId":"wrpEtBCAAAag5kIjiji_KkvjmwjxE95w"
}
```

**成功响应:**

| 名称    | 类型     | 默认值 | 备注     | 
| ------- | -------- | ------ | -------- | 
| code  | `Int`      |        | 响应码     |   
| msg                              | `string`   |        | 消息提示                                                          |     |
| success                          | `Bool`     |        | 是否成功                                                          |     |
| data                             | `Object[]` |        | 返回数据                                                          |     |
| data.name                        | `string`   |        | 群名称                                                            |     |
| data.chatId                      | `string`   |        | 群聊ID                                                            |     |
| data.createTime                  | `Int`      |        | 创建时间                                                          |     |
| data.memberCount                 | `Int`      |        | 总人数                                                            |     |
| data.memberList                  | `object[]` |        | 群成员数据                                                        |     |
| data.memberList.invitor    | `string`   |        | 邀请者。目前仅当是由本企业内部成员邀请入群时会返回该值            |     |
| data.memberList.invitor.userid    | `string`   |        | 邀请者的id(尘锋员工id)         |     |
| data.memberList.invitor.qwUserId    | `string`   |        | 邀请者的id(企微员工id)            |     |
| data.memberList.isOwner          | `bool`     |        | 是否群主                                                          |     |
| data.memberList.isQuit           | `bool`     |        | 是否退群                                                          |     |
| data.memberList.joinScene        | `int`      |        | 入群方式 1-由成员拉入群 2-通过邀请链接入群 3-通过扫描群二维码入群 |     |
| data.memberList.joinTime         | `int`      |        | 入群时间                                                          |     |
| data.memberList.name             | `string`   |        | 成员名称                                                          |     |
| data.memberList.groupNickName    | `string`   |        | 在群里的昵称                                                              |     |
| data.memberList.type             | `int`      |        | 成员类型 1-企业成员 2-外部联系人                                  |     |
| data.memberList.userId           | `string`   |        | 群成员(根据成员类型可能是或者员工Id/外部联系人Id)                                      |     |
| data.memberList.unionId           | `string`   |        | 仅当群成员类型是微信用户（且有员工添加为好友），且该微信用户访问SCRM提供的素材和小程序时返回                                    |     |
| data.notice                      | `string`   |        | 群公告                                                            |     |
| data.owner                       | `string`   |        | 群主ID                                                            |     |
| data.qwTagsInfo                  | `object[]` |        | 标签列表详情                                                      |     |
| data.qwTagsInfo.backgroundColor | `string`   |        | 背景色                                                            |     |
| data.qwTagsInfo.createTime      | `string`   |        | 标签创建时间                                                      |     |
| data.qwTagsInfo.tagId               | `string`   |        | 标签ID                                                            |     |
| data.qwTagsInfo.name             | `string`   |        | 标签名称                                                          |     |
| data.qwTagsInfo.textColor       | `string`   |        | 字体颜色                                                          |     |
| data.qwUserId                    | `string`   |        | 群主企微ID                                                        |     |
| traceId                                 |     `string`       |        |                                                                   |     |

成功响应示例:

```json
{
    "success": true,
    "code": 0,
    "msg": "ok",
    "data": {
    "chatId": "wrpEtBCAAAag5kIjiji_KkvjmwjxE95w",
    "Name": "test1",
    "owner": "447",
    "qwUserId": "WoChiLiangMian",
    "createTime": 1714771321,
    "notice": "",
    "memberCount": 6,
    "qwTagsInfo": [
        {
            "tagId": "911e97c1-252b-11ed-9184-b2d4f028e399",
            "name": "gou",
            "create_time": "2022-08-26 18:40:56",
            "background_color": "rgba(252,247,233,1)",
            "text_color": "rgba(251,187,61,1)"
        }
    ],
    "memberList": [
            {
                "name": "xxx",
                "isOwner": true,
                "userId": "447",
                "qwUserId": "WoChiLiangMian",
                "type": 1,
                "joinTime": 1714771321,
                "joinScene": 1,
                "groupNickName": "",
                "invitor": {
					"userid": "447",
					"qwUserId": "WoChiLiangMian"
				},
				"unionId": "",
                "isQuit": false
            },
            {
                "name": "yyy",
                "isOwner": false,
                "userId": "190127",
                "qwUserId": "Feng",
                "type": 1,
                "joinTime": 1714771321,
                "joinScene": 1,
                "groupNickName": "",
                "invitor": {
					"userid": "447",
					"qwUserId": "WoChiLiangMian"
				},
				"unionId": "",
                "isQuit": false
            }
        ]
    },
    "traceId": "d9e3931f-1506-93e5-89c2-9d2a6625a876"
}
```