机器人客户群列表

POST

/wxworkapi/grouptag/list

请求参数

Authorization

Query 参数

Body 参数application/json

示例

{
    "name": "群名称",
    "pageNum": 1,
    "pageSize": 20,
    "robotKeys": [
        "418abc07169a4516b6eda68dc67c9cfd"
    ],
    "status": 1,
    "clientIdList": [
        407
    ],
    "startTime": 1753977600000,
    "endTime": 1755792000000
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.example.com/wxworkapi/grouptag/list' \
--header 'Content-Type: application/json' \
--data '{
    "name": "群名称",
    "pageNum": 1,
    "pageSize": 20,
    "robotKeys": [
        "418abc07169a4516b6eda68dc67c9cfd"
    ],
    "status": 1,
    "clientIdList": [
        407
    ],
    "startTime": 1753977600000,
    "endTime": 1755792000000
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "msg": "OK",
    "total": 4,
    "code": "0",
    "data": [
        {
            "robotId": 5749,
            "robotKey": "418abc07169a4516b6eda68dc67c9cfd",
            "conversationId": "R:10928340731882648",
            "name": "群裂变104",
            "creatorId": 1688855705485113,
            "creatorName": "小时代Mac",
            "memberCount": 3,
            "outerUserCount": 2,
            "status": 1,
            "isOuterGroupConversation": 1,
            "createTime": "2025-08-21 10:01:23",
            "gmtCreate": "2025-08-21 10:01:26",
            "gmtModify": "2025-08-22 10:35:09"
        },
        {
            "robotId": 5749,
            "robotKey": "418abc07169a4516b6eda68dc67c9cfd",
            "conversationId": "R:10856165856572462",
            "name": "群裂变103",
            "creatorId": 1688855705485113,
            "creatorName": "小时代Mac",
            "memberCount": 3,
            "outerUserCount": 2,
            "status": 1,
            "isOuterGroupConversation": 1,
            "createTime": "2025-08-20 16:14:05",
            "gmtCreate": "2025-08-20 16:14:08",
            "gmtModify": "2025-08-22 10:35:07"
        },
        {
            "robotId": 5749,
            "robotKey": "418abc07169a4516b6eda68dc67c9cfd",
            "conversationId": "R:10791313189712346",
            "name": "群裂变-102",
            "creatorId": 1688855705485113,
            "creatorName": "小时代Mac",
            "memberCount": 3,
            "outerUserCount": 2,
            "status": 1,
            "isOuterGroupConversation": 1,
            "createTime": "2025-08-20 16:13:33",
            "gmtCreate": "2025-08-20 16:13:36",
            "gmtModify": "2025-08-22 10:35:05"
        },
        {
            "robotId": 5749,
            "robotKey": "418abc07169a4516b6eda68dc67c9cfd",
            "conversationId": "R:10961179070007195",
            "name": "群裂变-101",
            "creatorId": 1688855705485113,
            "creatorName": "小时代Mac",
            "memberCount": 3,
            "outerUserCount": 2,
            "status": 1,
            "isOuterGroupConversation": 1,
            "createTime": "2025-08-20 16:12:49",
            "gmtCreate": "2025-08-20 16:12:52",
            "gmtModify": "2025-08-22 10:35:03"
        }
    ],
    "isMasterUser": 1
}

修改于 2025-09-10 07:15:12

模板参数-设置

默认回复开关-打开/关闭