获取客户群列表

该接口用于获取配置过客户群管理的客户群列表。

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/groupchat/list?access_token=ACCESS_TOKEN

{
    "status_filter": 0,
    "owner_filter": {
        "userid_list": ["abel"]
    },
    "offset": 0,
    "limit": 100
}

参数说明:

参数 必须 说明
access_token 调用接口凭证
status_filter 群状态过滤。
0 - 所有列表
1 - 离职待继承
2 - 离职继承中
3 - 离职继承完成

默认为0
owner_filter 群主过滤。如果不填,表示获取全部群主的数据
owner_filter.userid_list 用户ID列表。最多100个
offset 分页,偏移量。默认为0
limit 分页,预期请求的数据量,取值范围 1 ~ 1000

offset + limit总数不能大于5万。数据量太多的话,需要用参数 owner_filter 来过滤
如果不指定 owner_filter,会拉取应用可见范围内的所有群主的数据,但是不建议这样使用。如果可见范围内人数超过1000人,为了防止数据包过大,会报错 81017。此时,调用方需通过指定 owner_filter 来缩小拉取范围

权限说明:

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "group_chat_list": [{
        "chat_id": "wrOgQhDgAAMYQiS5ol9G7gK9JVAAAA",
        "status": 0
    }, {
        "chat_id": "wrOgQhDgAAcwMTB7YmDkbeBsAAAA",
        "status": 0
    }]
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
group_chat_list 客户群列表
group_chat_list.chat_id 客户群ID
group_chat_list.status 客户群状态。
0 - 正常
1 - 跟进人离职
2 - 离职继承中
3 - 离职继承完成
© 1998 - 2020 Tencent Inc. All Rights Reserved