查询客户群详情 - 尘锋SCRM开放平台

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

Content-Type: application/json

接口限制:每分钟调用600次;单次请求最多传递100条数据;

Query:

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

请求参数:

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

请求参数示例:

{
    "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) type=2时，若无员工添加外部联系人为好友则不返回
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`

成功响应示例:

{
    "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"
}