获取客户所在群聊

GET/open-api/external_user/group_list/get

只有在企业微信侧完成了微信开发者ID绑定后才可在企业微信用户系统和微伴助手用户系统中通过 unionid 关联到具体客户。绑定方法见企业微信unionid绑定流程

错误码	说明
20206	id 错误，找不到对应客户
20207	unionid 错误，找不到对应客户
20208	unionid 和 id 必须至少提供一个
调用此接口需购买基础席位。

请求参数

Query 参数

string

可选

客户id。对应企业微信客户 id。id 和 unionid必须选择一个填写

示例值:

wo8xjUCAAAiOCsgkeh_ZhkzNQ8PvzPsw

unionid

string

可选

客户 unionid。id 和 unionid 必须选择一个填写

示例值:

omefmt0-sSUShfLCrUswJILSnjds

openid

string

可选

客户openid，密文企业选择 unionid 时需填写

示例值:

ohpYX63Ss6YnNTdv9YKcjpPGnBhA

offset

string

可选

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

示例值:

limit

string

可选

列表返回长度，默认值为20

示例值:

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

errcode

integer

必需

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

errmsg

string

必需

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

result

object

必需

group_list

array [object {9}]

所在群聊列表

必需

name

string

客户名称

必需

relate_staff

array[string]

客户添加的员工列表

必需

total_join_group

integer

加入群聊总数

必需

type

integer

必需

{
  "errcode": 0,
  "errmsg": "ok",
  "result": {
    "group_list": [
      {
        "create_time": 1718107334,
        "group_id": "wrP_2OPAAAadbjw7iqSFknUFwOeDf1Sw",
        "id": 110411556,
        "join_scene": 3,
        "join_time": 1725274055,
        "member_count": 4,
        "name": "3335235",
        "owner": "abc",
        "tag_list": [
          {
            "created_at": 1720515017,
            "id": 100361441,
            "name": "22",
            "tag_group_id": 100360244,
            "tag_group_name": "abcd",
            "updated_at": 1720515017
          }
        ]
      }
    ],
    "name": "ccc",
    "relate_staff": [
      "aaa",
      "bbb"
    ],
    "total_join_group": 1,
    "type": 1
  }
}

最后修改时间： 16 天前