获取客户所在群聊 - 微伴助手OpenAPI

只有在企业微信侧完成了微信开发者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

示例值:

access_token

string

调用接口凭证

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

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
    }
}

🟢200正常返回