客户列表

POST

/wxworkapi/external/user/list

请求参数

Authorization

Header 参数

Body 参数application/json

示例

{
    "name": "",
    "pageSize": 50,
    "pageNum": 1,
    "robotKey": "cbef4a5708c04b5b8d10dd306ec7d6d4",
    "tagList": [
        "搜狗OCPC",
        "搜狗自然流量",
        "默认流量",
        "直达流量",
        "百度自然流量",
        "baidu",
        "个人323",
        "敏感肌肤"
    ],
    "tagSelectType": 0,
    "isExternalUser": 1,
    "status": 1,
    "startTime": 1679241600000,
    "endTime": 1680537600000,
    "startConvTime": 1680451200000,
    "endConvTime": 1680710400000,
    "gender": null,
    "state": "test",
    "inGroupIds": [
        "R:10805927594493833"
    ],
    "notTagList": [
        "百度认证",
        "测试323"
    ],
    "notInGroupIds": [
        "R:10805927594493833"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://www.example.com/wxworkapi/external/user/list' \
--header 'token: cf95e27e49a58a63798dc48e13b6f866' \
--header 'Content-Type: application/json' \
--data '{
    "name": "",
    "pageSize": 50,
    "pageNum": 1,
    "robotKey": "cbef4a5708c04b5b8d10dd306ec7d6d4",
    "tagList": [
        "搜狗OCPC",
        "搜狗自然流量",
        "默认流量",
        "直达流量",
        "百度自然流量",
        "baidu",
        "个人323",
        "敏感肌肤"
    ],
    "tagSelectType": 0,
    "isExternalUser": 1,
    "status": 1,
    "startTime": 1679241600000,
    "endTime": 1680537600000,
    "startConvTime": 1680451200000,
    "endConvTime": 1680710400000,
    "gender": null,
    "state": "test",
    "inGroupIds": [
        "R:10805927594493833"
    ],
    "notTagList": [
        "百度认证",
        "测试323"
    ],
    "notInGroupIds": [
        "R:10805927594493833"
    ]
}'

返回响应

🟢200成功

application/json

成功

Bodyapplication/json

示例

{
    "msg": "OK",
    "total": 9,
    "code": "0",
    "data": [
        {
            "robotId": 3516,
            "robotKey": "154eeda74e2d4d60a5bb36c5584cd924",
            "conversationId": "R:10805927594493833",
            "name": "诗词歌赋1",
            "creatorId": 1688855725377539,
            "creatorName": "我要青春不要痘",
            "memberCount": 39,
            "outerUserCount": 7,
            "status": 1,
            "isOuterGroupConversation": 1,
            "createTime": "2023-01-18 17:21:40",
            "gmtCreate": "2023-03-14 16:06:53",
            "gmtModify": "2023-03-15 18:51:20"
        },
        {
            "robotId": 3516,
            "robotKey": "154eeda74e2d4d60a5bb36c5584cd924",
            "conversationId": "R:10755642757199224",
            "name": "甘肃炳深-健康生活福利社",
            "creatorId": 1688851343965983,
            "creatorName": "周仲强",
            "memberCount": 2,
            "outerUserCount": 1,
            "status": 1,
            "isOuterGroupConversation": 1,
            "tags": [
                "搜狗自然流量",
                "腾讯流量"
            ],
            "groupSetting": "{\"agentNo\":\"1110817524\"}",
            "createTime": "2022-07-29 11:56:19",
            "gmtCreate": "2022-07-29 11:56:24",
            "gmtModify": "2022-08-30 11:53:32"
        }
    ],
    "isMasterUser": 1
}

修改于 2025-12-11 07:51:54

企微群成员列表

上传图片/文件