获取群聊列表

获取群聊列表。可以通过staff_id获取指定员工的群聊列表
调用此接口需购买基础席位。

请求参数

Query 参数

staff_id

string

可选

企业微信员工id。若填写则只会返回该员工对应的客户

示例值:

Shiyan

limit

string

可选

列表返回长度。默认值为30，最大值为100

示例值:

offset

string

可选

表偏移。用于迭代获取所有数据，默认值为0

示例值:

access_token

string

调用接口凭证

必需

默认值:

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

状态码，0为正常，非0代表错误。业务错误码下述，全局错误码见全局错误码

errmsg

string

必需

errmsg str 错误信息，成功时为'ok'，错误时会以中文方式显示错误原因

group_chat_list

array [object {13}]

客户列表

必需

create_time

integer

群的创建时间

必需

created_at

integer

必需

数据创建时间（微伴系统内时间）

group_id

string

客户群ID

必需

last_update_statistic_time

integer

必需

统计数据最后更新时间

member_count

integer

群聊人数

必需

name

string

群聊名称

必需

notice

string

群聊公告

必需

owner

string

群主

必需

today_decrease_user_count

integer

必需

今日退群人数。统计last_update_statistic_time当天的数据

today_increase_user_count

integer

必需

今日进群人数。统计last_update_statistic_time当天的数据

description

string

群描述

必需

is_dismissed

boolean

是否解散

必需

dismissed_at

string

解散时间

必需

total

integer

群聊总数

必需

示例

{
    "errcode": 0,
    "errmsg": "ok",
    "group_chat_list": [
        {
            "create_time": 1581577730,
            "created_at": 1582013715,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAAb4IiVmBjWjHSwHTXxPa9-A",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308895,
            "member_count": 2,
            "name": "测试非好友关系",
            "notice": null,
            "owner": "PanPan",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1581345431,
            "created_at": 1582013715,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAAciHsAqljS4thAshDtcA4pw",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308953,
            "member_count": 4,
            "name": "测试",
            "notice": "啦啦啦姐姐姐姐姐\n",
            "owner": "Ke",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1581337814,
            "created_at": 1582013715,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAANtl3kEAPMjsObv1JdB3UHw",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308437,
            "member_count": 9,
            "name": "测试群聊",
            "notice": null,
            "owner": "XingHeChangMing",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1577279390,
            "created_at": 1582013716,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAA0dgWYqNhYMd8l_jOdMCSPw",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308954,
            "member_count": 6,
            "name": "潘潘,星河长明,远离颠倒梦想",
            "notice": null,
            "owner": "Ke",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1576853923,
            "created_at": 1582013716,
            "description": null,
            "dismissed_at": 1615207363,
            "group_id": "wr8xjUCAAAAgGWZ2RPw5IVzI-YvT4FTw",
            "is_dismissed": true,
            "last_update_statistic_time": 1624370520,
            "member_count": 3,
            "name": "潘潘,星河长明,严志鹏-企",
            "notice": null,
            "owner": "yanzhipeng",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1582097861,
            "created_at": 1582097862,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAAf_8gdWTjFQnTdu0hYzOjPA",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308436,
            "member_count": 3,
            "name": "测试",
            "notice": null,
            "owner": "XingHeChangMing",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1582102617,
            "created_at": 1582102618,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAAk2qGZYkoXgeWOIRBnCOMmg",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308311,
            "member_count": 4,
            "name": "测试",
            "notice": "测试1111111",
            "owner": "ZaHuiShiEr",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1582112018,
            "created_at": 1582112019,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAAAkpGA0JP7w-czIzEOpuL3w",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308895,
            "member_count": 4,
            "name": "你个球,群发大师-优优,Cheng",
            "notice": null,
            "owner": "PanPan",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1582116002,
            "created_at": 1582116002,
            "description": null,
            "dismissed_at": null,
            "group_id": "wr8xjUCAAA4-H4nvzUMUQcfkExq4IutA",
            "is_dismissed": false,
            "last_update_statistic_time": 1637308953,
            "member_count": 5,
            "name": "微伴助手测试",
            "notice": "滴滴滴滴",
            "owner": "Ke",
            "today_decrease_user_count": 0,
            "today_increase_user_count": 0
        },
        {
            "create_time": 1582117037,
            "created_at": 1582117037,
            "description": null,
            "dismissed_at": 1611921760,
            "group_id": "wr8xjUCAAAqG

🟢200正常返回

请求参数

示例代码

返回响应